yuque-personal-stale-detector

过期检测器 — Yuque 知识库新鲜度检查

扫描你的 Yuque 知识库，找出长时间未更新、可能包含过时信息的文档，帮助你维护健康、准确的知识库。

适用场景

• 用户想找出知识库中过时的文档
• 用户说「检查一下哪些文档过期了」「查找陈旧文档」「我的知识库有哪些需要更新」
• 用户想定期维护知识库
• 用户说「帮我做个知识库健康检查」「哪些文档很久没更新了」

所需的 MCP 工具

所有工具均来自 yuque-mcp 服务：

• yuque_list_repos — 列出个人知识库
• yuque_get_repo_toc — 获取包含文档元数据的目录
• yuque_get_doc — 读取文档内容以检查过时迹象

工作流

步骤 1：选择知识库

如果用户指定了知识库，直接使用。否则，列出可用的知识库：

Tool: yuque_list_repos
Parameters:
  type: "user"

让用户选择要扫描的知识库，或者在用户要求时扫描全部知识库。

步骤 2：获取带有元数据的文档列表

对于每个知识库，获取目录：

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

从每条文档记录中提取：

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

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

计算每篇文档的存续时间（距上次更新的天数），并分类：

类别	存续时间	表情符号
🟢 新鲜 (Fresh)	< 90 天	最近更新，内容可能仍然适用
🟡 老化 (Aging)	90-180 天	可能需要审查
🟠 陈旧 (Stale)	180-365 天	很可能需要更新
🔴 过期 (Expired)	> 365 天	内容过时的风险较高

步骤 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 插件中对应的技能

错误处理

情况	操作
yuque_list_repos 返回空结果	请用户提供准确的知识库名称或 ID
yuque_get_repo_toc 返回空结果	告知用户该知识库似乎为空
yuque_get_doc 失败（404）	说明该文档可能已被删除（这本身也是一项发现！）
yuque_get_doc 失败（403）	告知用户他们可能没有访问此文档的权限
API 超时	重试一次，然后告知用户存在连接问题
所有文档均为新鲜	祝贺用户维护了一个健康的知识库！
知识库有 >100 篇文档	仅使用元数据进行分析（跳过深入扫描），并提出可以深入扫描特定部分