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：鮮度に応じてドキュメントを分類

各ドキュメントの経過日数（最終更新からの日数）を計算し、分類します。

カテゴリ	経過日数	絵文字
🟢 新鮮	90 日未満	最近更新されており、最新である可能性が高い
🟡 古くなりつつある	90～180 日	確認が必要な場合があります
🟠 古い	180～365 日	更新が必要な可能性が高い
🔴 期限切れ	365 日超	情報が古くなっているリスクが高い

ステップ 4：注意が必要なドキュメントを詳しくスキャン（任意）

🟠 または 🔴 に分類されたドキュメントについて、必要に応じて内容を読み、古さを示す兆候をさらに確認します。

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

以下を確認します。

• バージョンへの言及 — 古くなっている可能性のある特定のソフトウェアバージョンへの言及
• 日付への言及 — 「2023 年の計画」「第 1 四半期の目標」など、固定された日付
• 変更されている可能性のある記述 — 変更された可能性のあるツール、API、プロセスへの言及
• 時間に関する表現 — 時間の経過によって内容が変わることを示す「現在」「最近」「まもなく」などの表現

API 呼び出しが過剰にならないよう、詳細スキャンは 5～10 件のドキュメントに限定します。

ステップ 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 がタイムアウトする	1 回再試行し、その後、接続の問題をユーザーに伝えます
すべてのドキュメントが新鮮	健全なナレッジベースを維持できていることをユーザーに伝えます！
ナレッジベースに 100 件を超えるドキュメントがある	メタデータのみで分析し（詳細スキャンは省略）、特定のセクションの詳細スキャンを提案します