Capture random thoughts, inspirations, and fragments throughout the day. Periodically organize and merge them into structured thematic notes saved to your Yuque knowledge base.
When to Use
- User wants to quickly jot down an idea or thought
- User says "take a note", "jot this down", "I have an idea", "capture this", "note this for now"
- User wants to review and organize accumulated captures
- User says "organize my recent ideas", "categorize my fragmentary notes", "organize my captures"
Required MCP Tools
All tools are from the yuque-mcp server:
yuque_search— Search for existing capture documents or thematic notesyuque_get_doc— Read existing capture log or thematic notesyuque_create_doc— Create new capture log or thematic notesyuque_update_doc— Append to capture log or update thematic notesyuque_list_books— List knowledge bases to find the target repo
Workflow
Phase A: Quick Capture
When the user shares a fleeting idea or thought:
Step 1: Receive the Input
Accept the user's input as-is. It can be:
- A sentence or fragment
- A question they want to explore later
- A link with a brief comment
- A random observation or insight
Step 2: Classify the Capture
Assign a lightweight tag based on content:
| Tag | When to Use |
|---|---|
| 💡 Ideas | Original ideas, hypotheses, "what if" thoughts |
| 📌 To-dos | Things to do or follow up on |
| 🔗 References | Links, references, things to read later |
| 💬 Excerpts | Quotes or snippets from conversations |
| ❓ Questions | Questions to research or think about |
| 🎯 Inspiration | Creative sparks, project ideas |
Step 3: Append to Capture Log
Find or create a daily capture log document:
Tool: yuque_search
Parameters:
query: "每日碎片 YYYY-MM-DD"
type: "doc"
If no log exists for today, create one:
Tool: yuque_create_doc
Parameters:
repo_id: "<target namespace>"
title: "📝 每日碎片 — YYYY-MM-DD"
body: "<capture log template>"
If the log exists, append the new capture:
Tool: yuque_update_doc
Parameters:
repo_id: "<namespace>"
doc_id: "<slug>"
body: "<existing content + new capture entry>"
Each capture entry format:
### [HH:MM] [Tag] 简短标题
[用户的原始内容]
---
Confirm to the user: "Recorded ✅ — [tag] [short title]"
Phase B: Organize and Merge
When the user asks to organize their captures, or when there are enough accumulated entries:
Step 1: Gather Recent Captures
Search for recent capture logs:
Tool: yuque_search
Parameters:
query: "每日碎片"
type: "doc"
Fetch the content of recent capture logs (last 7 days or as specified by the user).
Step 2: Analyze and Group
Read through all captures and group them by theme:
- Identify themes — Find captures that relate to the same topic, project, or idea
- Detect connections — Note captures that build on each other or are complementary
- Flag actionable items — Separate TODO items from reflective thoughts
Present the grouping to the user:
## 📊 碎片整理预览
过去 [N] 天共 [X] 条碎片,归为 [Y] 个主题:
### 主题 1:[主题名称]([N] 条相关)
- [碎片摘要 1]
- [碎片摘要 2]
- [碎片摘要 3]
### 主题 2:[主题名称]([N] 条相关)
- [碎片摘要 1]
- [碎片摘要 2]
### 🔮 未归类([N] 条)
- [碎片摘要]
要把哪些主题合并成正式笔记?
Step 3: Generate Thematic Notes
For each theme the user confirms, generate a structured note:
# [主题标题]
> 📅 整理自 YYYY-MM-DD ~ YYYY-MM-DD 的碎片笔记
> 📝 包含 [N] 条相关想法
## 核心想法
[将相关碎片整合成连贯的叙述,保留原始洞察]
## 关键要点
1. **[要点 1]**:[展开说明]
2. **[要点 2]**:[展开说明]
3. **[要点 3]**:[展开说明]
## 待探索
- [ ] [从碎片中提取的待办或待研究项]
- [ ] [延伸问题]
## 原始碎片
<details>
<summary>查看原始记录</summary>
[按时间排列的原始碎片内容]
</details>
Step 4: Save Thematic Notes
Tool: yuque_create_doc
Parameters:
repo_id: "<target namespace>"
title: "[主题标题]"
body: "<structured thematic note>"
Confirm: "Theme note \"[theme title]\" has been saved to \"[knowledge base name]\": [document link]"
Guidelines
- Always answer in the same language the user used (Chinese or English)
- Quick capture should be instant — don't over-process, just record and confirm
- Preserve the user's original wording in captures — don't rephrase their thoughts
- When organizing, respect the user's intent — ask before merging if themes are ambiguous
- Don't force organization — some captures are standalone and that's fine
- The "Uncategorized" category is valid — not everything needs a theme
- Suggest organizing when captures accumulate (e.g., > 15 unorganized items)
Error Handling
| Situation | Action |
|---|---|
| Document not found (404) | Create a new capture log for today |
| Permission denied (403) | Tell user they may lack permission to access or edit this document |
| Target repo not found | List user's repos with yuque_list_books and ask them to pick one |
yuque_create_doc fails |
Present the capture/note in chat and suggest manual saving |
| No captures found for organization | Inform user: "No fragmentary records found recently, jot down a few first!" |
| Capture content is empty | Ask user: "What do you want to record?" |