Tool: yuque_get_repo_toc
Parameters:
  repo_id: "<namespace>"

从每个文档条目中提取：

• title — 文档标题
• slug — 文档标识符
• updated_at — 最后更新时间戳
• created_at — 创建时间戳

步骤 3：按新鲜度对文档分类

计算每个文档的“年龄”（自上次更新以来的天数）并进行分类：

步骤 4：深度扫描可疑文档（可选）

对于分类为 🟠 或 🔴 的文档，可选地读取其内容以检查额外的过时信号：

Tool: yuque_get_doc
Parameters:
  repo_id: "<namespace>"
      doc_id: "<slug>"

查找：

• 版本引用 — 提及可能已过时的特定软件版本
• 日期引用 — 硬编码的日期，如“2023年计划”、“Q1 目标”
• 失效模式 — 对可能已更改的工具、API 或流程的引用
• 时间性语言 — “目前”、“最近”、“即将”等暗示内容具有时效性的词语

将深度扫描限制在 5-10 个文档，以避免过多的 API 调用。

步骤 5：生成报告

## 🔍 知识库健康检查报告

### 📚 扫描范围
- **知识库**：「知识库名称」
- **文档总数**：X 篇
- **扫描时间**：YYYY-MM-DD

---

### 📊 整体健康度

| 状态 | 数量 | 占比 |
|------|------|------|
| 🟢 新鲜（<90天） | X 篇 | XX% |
| 🟡 老化（90-180天） | X 篇 | XX% |
| 🟠 陈旧（180-365天） | X 篇 | XX% |
| 🔴 过期（>365天） | X 篇 | XX% |

**健康评分：X/10**

---

### 🔴 需要立即关注（过期文档）

| # | 文档标题 | 最后更新 | 已过天数 | 风险说明 |
|---|----------|----------|----------|----------|
| 1 | [标题](链接) | YYYY-MM-DD | X 天 | [如：包含版本号引用] |
| 2 | [标题](链接) | YYYY-MM-DD | X 天 | [如：含有时间敏感内容] |

### 🟠 建议检查（陈旧文档）

| # | 文档标题 | 最后更新 | 已过天数 |
|---|----------|----------|----------|
| 1 | [标题](链接) | YYYY-MM-DD | X 天 |
| 2 | [标题](链接) | YYYY-MM-DD | X 天 |

### 🟡 可以关注（老化文档）

[列出文档标题和更新时间，简要列表即可]

---

### 💡 维护建议

1. **优先处理**：[具体建议，如"XX 文档引用了 v2.x 版本，当前已是 v4.x"]
2. **批量更新**：[如"XX 板块的 X 篇文档都超过半年未更新，建议集中审查"]
3. **考虑归档**：[如"XX 文档可能已不再适用，建议归档或标记为历史文档"]
4. **定期检查**：建议每 [月/季度] 运行一次过期检测，保持知识库健康

---

### 📈 趋势观察

- **最活跃板块**：[哪个板块更新最频繁]
- **最冷门板块**：[哪个板块最久没动过]
- **更新模式**：[如"大部分更新集中在工作日"，"XX 板块有周期性更新"]

指导原则

• 始终使用用户使用的语言（中文或英文）回答
• 提供帮助而非制造恐慌 — 旧文档不一定就是坏的（有些内容是常青的）
• 区分时效性内容（API 文档、流程指南）和常青内容（原则、教程）
• 提供可操作的建议 — 不要仅仅列出过时文档，要建议如何处理它们
• 深度扫描时，突出显示具体的过时引用（版本号、日期、已弃用的工具）
• 此技能扫描个人知识库 — 对于团队知识库，请使用 yuque-group 插件中的相应技能

错误处理

每周安装数

108

仓库

yuque/yuque-plugin

GitHub 星标数

62

首次出现

2026年2月28日

安全审计

Gen Agent Trust HubPassSocketPassSnykPass

安装于

codex108

claude-code108

mcpjam2

kilo2

windsurf2

zencoder2