yuque-personal-reading-digest

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Reading Digest — Document Summarization & Reading Notes

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

Help the user quickly distill a Yuque document into a structured reading digest with key takeaways, core arguments, and actionable insights.

帮助用户快速将语雀文档提炼为结构化的阅读摘要，包含核心要点、核心论点和可落地的洞察。

When to Use

适用场景

User wants a summary of a long Yuque document
User says "帮我总结这篇文档", "summarize this doc", "生成阅读摘要"
User wants to extract key points from an article for future reference
User says "这篇文章讲了什么", "帮我提炼要点"

用户想要总结长篇语雀文档
用户说「帮我总结这篇文档」、「summarize this doc」、「生成阅读摘要」
用户想要提取文章要点供后续参考
用户说「这篇文章讲了什么」、「帮我提炼要点」

Required MCP Tools

所需的MCP工具

All tools are from the

yuque-mcp

server:

```
yuque_search
```
— Find the target document by keyword
```
yuque_get_doc
```
— Read the full document content
```
yuque_list_repos
```
— List personal repos to find the save target
```
yuque_create_doc
```
— Save the reading digest as a new document

所有工具都来自

yuque-mcp

服务：

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

Workflow

工作流

Step 1: Locate the Document

步骤1：定位文档

The user may provide:

A document title or keyword
A direct Yuque document URL
A repo + doc reference

If the user provides a keyword or title:

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

If the user provides a URL or specific reference, extract the

repo_id

and

doc_id

directly.

用户可能提供：

文档标题或关键词
直接的语雀文档URL
知识库+文档的引用标识

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

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

如果用户提供了URL或者特定引用，直接提取

repo_id

和

doc_id

即可。

Step 2: Read the Document

步骤2：读取文档

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

If the document is very long, note the total length and proceed with the full content.

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

如果文档很长，记录总长度后继续处理完整内容即可。

Step 3: Generate the Reading Digest

步骤3：生成阅读摘要

Analyze the document and produce a structured digest:

markdown

undefined

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

markdown

undefined

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

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

🎯 一句话总结

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

📌 关键要点

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

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

🧠 核心论点与逻辑

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

💡 启发与思考

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

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

📝 原文金句

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

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

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

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

🔗 相关延伸

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

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

undefined

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

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

undefined

Step 4: Review with User

步骤4：和用户确认

Present the digest to the user and ask:

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

把生成的摘要展示给用户并询问：

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

Step 5: (Optional) Save to Yuque

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

If the user wants to save:

Tool: yuque_list_repos
Parameters:
  type: "user"

Find or ask for the target repo (often "阅读笔记" or "读书摘要").

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

如果用户需要保存：

Tool: yuque_list_repos
Parameters:
  type: "user"

找到或者询问用户目标知识库（通常是「阅读笔记」或者「读书摘要」）。

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

Step 6: Confirm

步骤6：确认结果

markdown

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

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

markdown

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

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

摘要概览

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

undefined

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

undefined

Guidelines

使用指南

Preserve the author's original intent — don't distort or over-simplify
Key points should be specific and actionable, not vague generalizations
Include direct quotes from the original for important claims
The "启发与思考" section should be personalized — relate to the user's context if known
Default language is Chinese; match the original document's language
For very long documents (>5000 words), consider breaking the digest into sections matching the original structure

保留作者的原意——不要歪曲或者过度简化内容
关键要点要具体、可落地，不要模糊笼统
重要论点要保留原文的直接引用
「启发与思考」部分要个性化——如果已知用户的使用场景可以结合相关内容
默认输出语言为中文，也可以匹配原文档的语言
对于超长文档（>5000字），可以参考原文的结构将摘要拆分为对应章节

Error Handling

错误处理

Situation	Action
`yuque_search` returns no results	Ask user for the exact document URL or repo/slug
`yuque_get_doc` fails (404)	Document may have been deleted; inform user
`yuque_get_doc` fails (403)	User may lack permission; suggest checking access
Document is very short (<200 words)	Generate a brief summary instead of full digest template
Document is non-text (slides, spreadsheet)	Inform user this skill works best with text documents

场景	处理方式
`yuque_search` 无返回结果	询问用户要处理的文档准确URL或者知识库/路径标识
`yuque_get_doc` 调用失败（404）	告知用户文档可能已被删除
`yuque_get_doc` 调用失败（403）	用户可能没有访问权限，建议检查访问权限
文档很短（<200字）	生成简短总结即可，不需要使用完整的摘要模板
文档是非文本类型（幻灯片、表格）	告知用户该功能最适合处理文本文档