yuque-personal-smart-summary

智能总结 — Yuque 知识库与文档总结

为整个知识库或一组文档生成智能摘要，帮助用户快速了解内容概况、核心主题和重要见解。

适用场景

• 用户想了解知识库的概况
• 用户说“帮我总结一下这个知识库”“summarize my repo”“这个库里都有什么”
• 用户想总结多篇相关文档
• 用户说“帮我做个知识盘点”“generate a project summary from my docs”
• 用户想定期回顾知识

必需的 MCP 工具

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

• yuque_list_repos — 列出个人知识库
• yuque_get_repo_toc — 获取知识库目录
• yuque_get_doc — 读取完整文档内容
• yuque_search — 按关键词搜索文档（用于按主题总结）

工作流

步骤 1：确定范围

判断用户想总结的内容：

选项 A：整个知识库

Tool: yuque_list_repos
Parameters:
  type: "user"

然后让用户选择一个知识库，或使用用户指定的知识库。

选项 B：跨知识库的特定主题

Tool: yuque_search
Parameters:
  query: "<topic keywords>"
  type: "doc"

选项 C：用户指定了具体文档 直接开始读取文档。

步骤 2：获取文档列表

总结知识库时，获取其目录：

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

这样可以获取完整结构，包括标题、层级和文档 slug。

步骤 3：抽样并阅读文档

对于大型知识库（超过 20 篇文档），采用抽样策略：

1. 阅读所有文档，如果文档数 ≤10 篇
2. 如果超过 10 篇，有策略地抽样：
   • 优先阅读顶层文档和介绍性文档
   • 从每个主要部分中挑选 2-3 篇文档
   • 优先阅读近期更新的文档
   • 总共最多阅读 10-15 篇文档

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

步骤 4：分析并分类

阅读时，记录以下内容：

• 主要主题 — 涵盖哪些话题
• 内容类型 — 教程、参考资料、笔记、规格说明等
• 覆盖深度 — 哪些领域有充分文档记录，哪些内容较少
• 时效性 — 内容最近的更新时间
• 关联关系 — 文档之间的联系

步骤 5：生成总结

按以下格式撰写总结：

## 📚 知识库摘要：「知识库名称」

### 概览
- **文档总数**：X 篇
- **最近更新**：YYYY-MM-DD
- **主要语言**：中文/英文/混合

---

### 🗂️ 内容结构

知识库包含以下主要板块：

1. **[板块名称]**（X 篇文档）
   - [简要描述这个板块的内容]
   - 代表文档：[文档标题](链接)

2. **[板块名称]**（X 篇文档）
   - [简要描述]
   - 代表文档：[文档标题](链接)

3. **[板块名称]**（X 篇文档）
   - [简要描述]
   - 代表文档：[文档标题](链接)

---

### 🔑 核心要点

从整个知识库中提炼的关键信息：

1. **[要点 1]**：[2-3 句话概括]
2. **[要点 2]**：[2-3 句话概括]
3. **[要点 3]**：[2-3 句话概括]
4. **[要点 4]**：[2-3 句话概括]
5. **[要点 5]**：[2-3 句话概括]

---

### 📊 知识库健康度

| 指标 | 状态 |
|------|------|
| 内容覆盖 | [全面/有缺口/待补充] |
| 更新频率 | [活跃/一般/较少更新] |
| 结构清晰度 | [清晰/一般/需要整理] |
| 文档质量 | [高/中/参差不齐] |

---

### 💡 建议

- [建议 1：如"XX 板块内容较少，建议补充"]
- [建议 2：如"部分文档超过 6 个月未更新，建议检查时效性"]
- [建议 3：如"建议添加一篇总览文档串联各板块"]

步骤 6：多文档总结（备选方案）

如果要总结的是指定文档，而非整个知识库：

## 📄 文档摘要

### 文档列表
| # | 标题 | 知识库 | 更新时间 |
|---|------|--------|----------|
| 1 | [标题](链接) | 「库名」 | YYYY-MM-DD |
| 2 | [标题](链接) | 「库名」 | YYYY-MM-DD |

### 综合摘要

[3-5 段话，综合所有文档的核心内容，突出共同主题和关键信息]

### 各文档要点

#### 1. [文档标题]
- [要点 1]
- [要点 2]
- [要点 3]

#### 2. [文档标题]
- [要点 1]
- [要点 2]
- [要点 3]

### 文档间关联
- [文档 A 和文档 B 在 XX 方面互相补充]
- [文档 C 是文档 A 的深入展开]

指南

• 始终使用与用户相同的语言回复（中文或英文）
• 对大型知识库，应提前说明抽样情况：“知识库共有 X 篇文档，我抽样阅读了 Y 篇进行分析”
• 聚焦可操作的见解，而不只是罗列文档标题
• 指出内容缺口和机会——缺少的内容与已有内容同样重要
• 附上文档链接，方便用户深入了解任一主题
• 此技能用于总结个人知识库；对于团队知识库，请使用 yuque-group 插件中对应的技能

错误处理

情况	操作
yuque_list_repos 返回空结果	请用户提供准确的知识库名称或 ID
yuque_get_repo_toc 返回空结果	告知用户该知识库似乎为空
yuque_get_doc 失败（404）	跳过此文档，并说明它可能已被删除
yuque_get_doc 失败（403）	告知用户他们可能没有权限访问此文档
API 超时	重试一次，然后告知用户存在连接问题
知识库包含超过 50 篇文档	抽样阅读 10-15 篇文档，并明确说明抽样方式