# Yuque Personal Note Refine

> Refine and restructure existing notes into well-organized, deduplicated, and enriched documents in your personal Yuque knowledge base. For personal/individual use — reads and writes your own docs.

- Skill: `yuque/yuque-personal-note-refine` (Agent Skill)
- Install (CLI): `npx skillmds add yuque/yuque-personal-note-refine`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yuque/yuque-personal-note-refine/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- License: Apache-2.0
- Author: yuque (https://skillmd.com/u/yuque)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/yuque/yuque-personal-note-refine

---


# Note Refine — Restructure & Polish Your Notes

Help the user transform scattered, rough notes into well-structured, deduplicated, and enriched documents. Turn chaos into clarity.

## When to Use

- User wants to clean up messy notes
- User says "帮我整理笔记", "refine my notes", "把这些笔记理一下"
- User has accumulated daily captures and wants to consolidate them
- User says "这些笔记太乱了", "帮我重新组织一下", "去重整理"

## Required MCP Tools

All tools are from the `yuque-mcp` server:

- `yuque_search` — Find the target notes to refine
- `yuque_get_doc` — Read the full content of notes
- `yuque_list_repos` — List personal repos
- `yuque_list_docs` — List documents in a repo
- `yuque_create_doc` — Create the refined document
- `yuque_update_doc` — Update the original document in place

## Workflow

### Step 1: Identify the Source Notes

The user may provide:
- A specific document to refine
- A date range of daily captures to consolidate
- A topic keyword to find related scattered notes
- Multiple document references to merge

If the user says "整理我最近的笔记":

```
Tool: yuque_search
Parameters:
  query: "每日捕获"
  type: "doc"
```

Or for topic-specific notes:

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

### Step 2: Read All Source Notes

For each identified document:

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

Read up to 5-10 source documents. If there are more, prioritize by recency and relevance.

### Step 3: Analyze and Plan

Before refining, analyze the raw content:

1. **Identify themes** — Group related content by topic
2. **Find duplicates** — Flag repeated ideas or information
3. **Spot gaps** — Note where information is incomplete
4. **Assess structure** — Determine the best organizational approach

Present the analysis to the user:

```markdown
## 📋 笔记分析

**来源**：X 篇文档，共约 XXXX 字

### 主题分布
- **[主题 1]**：X 条相关记录
- **[主题 2]**：X 条相关记录
- **[主题 3]**：X 条相关记录

### 发现
- 🔄 发现 X 处重复内容
- 🕳️ 发现 X 处信息缺口
- 📊 建议整理为 X 篇主题文档

要按这个方向整理吗？
```

### Step 4: Refine the Notes

Based on user confirmation, perform the refinement:

#### 4a. Single Document Refinement

Restructure one document:
- Add clear headings and hierarchy
- Remove duplicate content
- Improve wording and clarity
- Add missing context or transitions
- Organize chronological notes into logical structure

#### 4b. Multi-Document Consolidation

Merge multiple notes into themed documents:
- Group by topic
- Deduplicate across documents
- Create a coherent narrative
- Preserve attribution (note original dates/sources)

Refined document template:

```markdown
# [主题标题]

> 整理自 X 篇笔记，时间跨度：YYYY-MM-DD 至 YYYY-MM-DD
> 最后整理：YYYY-MM-DD

---

## 概述

[对这个主题的整体概述，2-3 句话]

---

## [分类 1]

### [子主题 1.1]

[整理后的内容]

### [子主题 1.2]

[整理后的内容]

---

## [分类 2]

### [子主题 2.1]

[整理后的内容]

---

## 待补充

- [ ] [识别出的信息缺口 1]
- [ ] [识别出的信息缺口 2]

---

## 原始来源

- [原文档 1 标题](链接) — YYYY-MM-DD
- [原文档 2 标题](链接) — YYYY-MM-DD

---

> 本文档由 AI 助手整理，原始笔记已保留。
```

### Step 5: Save the Refined Document

Ask the user's preference:
- **Create new** — Save as a new document (recommended for multi-doc consolidation)
- **Update in place** — Replace the original document (for single doc refinement)

For new document:

```
Tool: yuque_create_doc
Parameters:
  repo_id: "<namespace>"
  title: "[主题标题]"
  body: "<refined content>"
  format: "markdown"
```

For in-place update:

```
Tool: yuque_update_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"
  body: "<refined content>"
```

### Step 6: Confirm

```markdown
✅ 笔记整理完成！

📄 **[[主题标题]](文档链接)**
📚 已保存到：「知识库名称」

### 整理成果
- 📥 输入：X 篇原始笔记，约 XXXX 字
- 📤 输出：1 篇结构化文档，约 XXXX 字
- 🔄 去除重复：X 处
- 🕳️ 标记待补充：X 处

💡 原始笔记已保留，可随时对照。
```

## Guidelines

- Always preserve the original notes — refine into a new document by default
- Don't discard information during deduplication; merge and enrich instead
- Maintain the user's voice and terminology — don't over-formalize casual notes
- Flag uncertain interpretations with "【待确认】" markers
- For daily captures, suggest a weekly or bi-weekly refinement cadence
- If notes span multiple topics, create separate refined documents per topic
- Add a "待补充" section for identified gaps — this helps the user know what to add later
- Default language is Chinese

## Error Handling

| Situation | Action |
|-----------|--------|
| Source notes are too few (<3 items) | Refine what's available; suggest capturing more first |
| Source notes are too many (>10 docs) | Focus on most recent or ask user to narrow the scope |
| Content is already well-structured | Tell user honestly; suggest minor improvements only |
| `yuque_update_doc` fails | Fall back to creating a new document |
| Mixed languages in notes | Maintain the dominant language; don't force translation |