yuque-personal-reading-digest

阅读摘要 — 文档总结与阅读笔记

帮助用户快速梳理语雀文档，提炼出包含关键要点、核心论点和可执行见解的结构化阅读摘要。

适用场景

• 用户想要总结一篇较长的语雀文档
• 用户说“帮我总结这篇文档”“summarize this doc”“生成阅读摘要”
• 用户想要提取文章要点，以供日后参考
• 用户说“这篇文章讲了什么”“帮我提炼要点”

所需 MCP 工具

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

• yuque_search — 按关键词查找目标文档
• yuque_get_doc — 读取完整文档内容
• yuque_list_repos — 列出个人知识库，查找保存目标
• yuque_create_doc — 将阅读摘要保存为新文档

工作流

步骤 1：定位文档

用户可能会提供：

• 文档标题或关键词
• 语雀文档直达链接
• 知识库 + 文档引用

如果用户提供关键词或标题：

Tool: yuque_search
Parameters:
  query: "<keyword>"
  type: "doc"

如果用户提供 URL 或具体引用，则直接提取 repo_id 和 doc_id。

步骤 2：阅读文档

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

如果文档很长，请注明总长度，并继续读取完整内容。

步骤 3：生成阅读摘要

分析文档并生成结构化摘要：

# 📖 阅读摘要：[文档标题]

> **原文**：[文档标题](文档链接)
> **作者**：[作者]
> **阅读日期**：YYYY-MM-DD
> **预计阅读时间**：约 X 分钟

---

## 🎯 一句话总结

[用一句话概括文档的核心观点或目的]

---

## 📌 关键要点

1. **[要点 1]**：[简要说明]
2. **[要点 2]**：[简要说明]
3. **[要点 3]**：[简要说明]
4. **[要点 4]**：[简要说明]
5. **[要点 5]**：[简要说明]

---

## 🧠 核心论点与逻辑

[梳理文档的核心论证逻辑，2-3 段]

---

## 💡 启发与思考

- [这篇文档对我的启发 1]
- [这篇文档对我的启发 2]
- [可以应用到的场景]

---

## 📝 原文金句

> [摘录文档中值得记住的精彩段落 1]

> [摘录文档中值得记住的精彩段落 2]

---

## 🔗 相关延伸

- [可以进一步阅读的方向 1]
- [可以进一步阅读的方向 2]

---

> 本摘要由 AI 助手生成，建议结合原文阅读。

步骤 4：与用户确认

向用户展示摘要并询问：

• “摘要是否准确？有需要调整的地方吗？”
• “要保存到你的语雀知识库吗？”

步骤 5：（可选）保存到语雀

如果用户想要保存：

Tool: yuque_list_repos
Parameters:
  type: "user"

查找或询问目标知识库（通常是“阅读笔记”或“读书摘要”）。

Tool: yuque_create_doc
Parameters:
  repo_id: "<namespace>"
  title: "📖 阅读摘要：[原文标题]"
  body: "<formatted digest>"
  format: "markdown"

步骤 6：确认

✅ 阅读摘要已生成并保存！

📄 **[📖 阅读摘要：原文标题](文档链接)**
📚 已归档到：「知识库名称」

### 摘要概览
- 提炼了 X 个关键要点
- 摘录了 X 条原文金句
- 生成了 X 个延伸阅读方向

指南

• 忠实保留作者的原意，不要歪曲或过度简化
• 关键要点应具体且可执行，避免空泛概括
• 对重要论点引用原文
• “启发与思考”部分应个性化；如果了解用户背景，请结合用户情况
• 默认使用中文；与原文语言保持一致
• 对于特别长的文档（>5000 words），可考虑按原文结构分段撰写摘要

错误处理

情况	操作
yuque_search 未返回结果	请用户提供准确的文档 URL 或知识库/slug
yuque_get_doc 失败（404）	文档可能已删除；告知用户
yuque_get_doc 失败（403）	用户可能没有权限；建议检查访问权限
文档很短（<200 words）	生成简短摘要，而不是完整的摘要模板
文档为非文本格式（幻灯片、电子表格）	告知用户此功能最适合处理文本类文档