Read an article or document, extract core insights, golden quotes, and action items, then generate structured reading notes and optionally save them to a Yuque knowledge base.
When to Use
- User has finished reading an article and wants to capture key takeaways
- User says "Help me make reading notes", "extract key points from this article", "reading notes"
- User shares a Yuque document link and wants structured notes
- User wants to build a personal reading notes knowledge base
Required MCP Tools
All tools are from the yuque-mcp server:
yuque_get_doc— Read full document contentyuque_list_books— List user's knowledge bases (to find the target repo for saving)yuque_create_doc— Create a new document (to save reading notes)yuque_search— Search for existing reading notes to avoid duplicates
Workflow
Step 1: Get the Source Article
Case A — Yuque document link:
Extract repo_id and doc_id from the URL and fetch the content:
Tool: yuque_get_doc
Parameters:
repo_id: "<namespace>"
doc_id: "<slug>"
Case B — User pastes article text directly: Use the provided text as the source content. No tool call needed.
Case C — User provides an external URL: Inform the user: "I can currently only process Yuque document links or directly pasted text. If it's an external article, please paste the content to me."
If the document is not found (404) or permission denied (403), inform the user and stop.
Step 2: Analyze and Extract
Read through the full content and extract the following elements:
- Core Insights — The main arguments or ideas the author presents (3-7 items)
- Golden Quotes — Memorable, well-crafted sentences worth saving (2-5 items)
- Action Items — Concrete things the reader can do based on this article (0-5 items)
- Key Concepts — Important terms or frameworks introduced (0-5 items)
- Personal Relevance — How this might connect to the reader's existing knowledge
Step 3: Generate Structured Reading Notes
Format the reading notes as follows:
# 📖 阅读笔记：[原文标题]
> **来源**：[文档标题](文档链接)
> **作者**：[原文作者]
> **阅读日期**：YYYY-MM-DD
> **阅读耗时**：约 X 分钟（按 300 字/分钟估算）
## 一句话总结
[用一句话概括这篇文章的核心价值]
## 核心观点
1. **[观点标题]**：[展开说明，2-3 句话]
2. **[观点标题]**：[展开说明，2-3 句话]
3. **[观点标题]**：[展开说明，2-3 句话]
## 金句摘录
> [原文金句 1]
> [原文金句 2]
> [原文金句 3]
## 关键概念
| 概念 | 解释 |
|------|------|
| [概念 1] | [简要解释] |
| [概念 2] | [简要解释] |
## 行动项
- [ ] [具体可执行的行动 1]
- [ ] [具体可执行的行动 2]
- [ ] [具体可执行的行动 3]
## 我的思考
[基于文章内容，提出 1-2 个延伸思考问题，帮助读者深入反思]
---
*由 AI 辅助生成的阅读笔记*
If the article has no clear action items, omit that section. If there are no notable golden quotes, omit that section too. Adapt the template to fit the content.
Step 4: Save to Knowledge Base (Optional)
Ask the user: "Do you want to save these reading notes to a Yuque knowledge base? If so, please tell me which knowledge base to save them to."
If the user specifies a knowledge base:
First, check if a reading notes document for this article already exists:
Tool: yuque_search
Parameters:
query: "[原文标题] 阅读笔记"
type: "doc"
If a duplicate is found, ask the user: "A reading note about this article already exists. Do you want to overwrite it or create a new one?"
Then create the document:
Tool: yuque_create_doc
Parameters:
repo_id: "<target namespace>"
title: "📖 阅读笔记：[原文标题]"
body: "<generated reading notes in markdown>"
After saving, confirm: "The reading notes have been saved to「[knowledge base name]」:[new document link]"
If the user doesn't want to save, just present the reading notes in the chat.
Guidelines
- Always answer in the same language the user used (Chinese or English)
- Golden quotes must be exact quotes from the original text — never paraphrase them
- Action items should be specific and actionable, not vague ("Learn React hooks" not "study more")
- Core insights should capture the author's intent, not your interpretation
- Estimate reading time based on ~300 Chinese characters/minute or ~200 English words/minute
- If the article is very short (< 200 words), simplify the output — skip sections that don't apply
- The "My Thoughts" section should pose genuine questions, not rhetorical ones
Error Handling
| Situation | Action |
|---|---|
| Document not found (404) | Inform user the document may have been deleted or the link is incorrect |
| Permission denied (403) | Tell user they may lack permission to access this document |
| Document content is empty | Inform user: "The document content is empty, unable to generate reading notes" |
| Target repo not found when saving | List user's repos with yuque_list_books and ask them to pick one |
yuque_create_doc fails |
Inform user the save failed, present the notes in chat instead |
| Article is not text-based (e.g., pure images) | Inform user: "The document is mainly image content, unable to extract text for analysis" |