mcpField
Y
yuque-personal-note-refine

yuque-personal-note-refine

github.com/yuque生产力74167 次安装35 周前更新
代码仓库

关于 yuque-personal-note-refine

面向 Yuque 用户的笔记整理技能，可将零散内容改写为结构清晰的文档，支持单篇润色与多篇合并，默认保留原笔记。

主要功能

  1. 01查找并读取来源笔记
  2. 02归纳主题并识别重复内容
  3. 03重组内容并改善表达
  4. 04新建整理文档或更新原文
  5. 05标记内容缺口与待确认项

适用场景

  1. 01按主题合并每日记录
  2. 02整理结构混乱的单篇笔记
  3. 03合并零散笔记并保留来源

MCP 相关

通过 yuque-mcp 服务的工具搜索和读取笔记、列出知识库与文档，并创建或更新文档。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/yuque/yuque-plugin --skill yuque-personal-note-refine

安装后在 Claude Code 中输入/yuque-personal-note-refine确认已加载。

详细介绍

笔记精炼 — 重组并润色你的笔记

帮助用户将零散、粗糙的笔记整理成结构清晰、去重且内容充实的文档。化混乱为清晰。

适用场景

  • 用户想要整理杂乱的笔记
  • 用户说“帮我整理笔记”“refine my notes”“把这些笔记理一下”
  • 用户积累了每日记录，想要整合起来
  • 用户说“这些笔记太乱了”“帮我重新组织一下”“去重整理”

必需的 MCP 工具

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

  • yuque_search — 查找要精炼的目标笔记
  • yuque_get_doc — 读取笔记的完整内容
  • yuque_list_repos — 列出个人知识库
  • yuque_list_docs — 列出知识库中的文档
  • yuque_create_doc — 创建精炼后的文档
  • yuque_update_doc — 原位更新原始文档

工作流

第 1 步：确定源笔记

用户可能会提供：

  • 要精炼的特定文档
  • 要整合的每日记录日期范围
  • 用于查找相关零散笔记的主题关键词
  • 要合并的多个文档引用

如果用户说“整理我最近的笔记”：

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

或者针对特定主题的笔记：

Tool: yuque_search
Parameters:
  query: "<topic keyword>"
  type: "doc"
第 2 步：阅读所有源笔记

对于每份已确定的文档：

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

最多读取 5-10 份源文档。如果数量更多，则优先选择近期且相关的文档。

第 3 步：分析并制定计划

精炼前，先分析原始内容：

  1. 识别主题 — 按主题归类相关内容
  2. 查找重复内容 — 标记重复的观点或信息
  3. 发现信息缺口 — 记录信息不完整之处
  4. 评估结构 — 确定最佳组织方式

向用户展示分析结果：

## 📋 笔记分析

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

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

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

要按这个方向整理吗？
第 4 步：精炼笔记

根据用户确认，进行精炼：

4a. 精炼单份文档

重组一份文档：

  • 添加清晰的标题和层级
  • 删除重复内容
  • 改进措辞，让表达更清晰
  • 补充缺失的上下文或过渡内容
  • 将按时间顺序记录的笔记整理成逻辑清晰的结构
4b. 整合多份文档

将多份笔记合并为按主题分类的文档：

  • 按主题归类
  • 跨文档去重
  • 形成连贯的叙述
  • 保留出处信息（记录原始日期和来源）

精炼后的文档模板：

# [主题标题]

> 整理自 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 助手整理，原始笔记已保留。
第 5 步：保存精炼后的文档

询问用户的偏好：

  • 创建新文档 — 保存为新文档（多文档整合时推荐）
  • 原位更新 — 替换原始文档（适用于精炼单份文档）

创建新文档：

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

原位更新：

Tool: yuque_update_doc
Parameters:
  repo_id: "<namespace>"
  doc_id: "<slug>"
  body: "<refined content>"
第 6 步：确认
✅ 笔记整理完成！

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

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

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

指南

  • 始终保留原始笔记；默认精炼到新文档中
  • 去重时不要丢弃信息，而应进行合并和补充
  • 保留用户的表达风格和术语；不要把随意的笔记改得过于正式
  • 对不确定的解读使用“【待确认】”标记
  • 对于每日记录，建议每周或每两周精炼一次
  • 如果笔记涉及多个主题，按主题分别创建精炼后的文档
  • 为已发现的信息缺口添加“待补充”部分，方便用户了解后续需要补充的内容
  • 默认语言为中文

错误处理

情况操作
源笔记太少（<3 项）精炼现有内容；建议用户先多记录一些
源笔记太多（>10 份文档）聚焦近期内容，或请用户缩小范围
内容结构已经清晰如实告知用户；仅建议做少量改进
yuque_update_doc 失败改为创建新文档
笔记包含多种语言保留占主导地位的语言；不要强行翻译

评论

支持 Markdown