语雀笔记AI整理助手 - 一键重构润色笔记，零散内容变结构化文档

yuque-personal-note-refine by yuque/yuque-plugin

113 周安装量

67 GitHub Stars

GitHub

安装命令

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

内容创作自动化知识管理

🇨🇳中文介绍

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 — 原地更新原始文档

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

步骤 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：分析与规划

在整理之前，分析原始内容：

识别主题 — 按主题对相关内容进行分组
查找重复项 — 标记重复的想法或信息
发现缺口 — 注意信息不完整的地方
评估结构 — 确定最佳的组织方式

向用户展示分析结果：

## 📋 笔记分析

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

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

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

要按这个方向整理吗？

步骤 4：整理笔记

根据用户确认，执行整理工作：

重构单个文档：

添加清晰的标题和层级结构
移除重复内容
改进措辞和清晰度
补充缺失的上下文或过渡
将按时间顺序的笔记组织成逻辑结构

将多篇笔记合并为主题文档：

按主题分组
跨文档去重
创建连贯的叙述
保留归属信息（注明原始日期/来源）

整理后文档模板：

# [主题标题]

> 整理自 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>"

✅ 笔记整理完成！

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

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

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

始终保留原始笔记 — 默认整理为新文档
去重时不要丢弃信息；应合并并丰富内容
保持用户的语气和术语 — 不要过度正式化随意的笔记
用"【待确认】"标记不确定的解释
对于每日捕获，建议每周或每两周进行一次整理
如果笔记涉及多个主题，请为每个主题创建单独的整理文档
为识别出的缺口添加"待补充"部分 — 这有助于用户了解后续需要补充的内容
默认语言为中文

情况	处理方式
源笔记太少（<3 条）	整理现有内容；建议先捕获更多内容
源笔记太多（>10 篇）	专注于最近的笔记，或请用户缩小范围
内容已经结构良好	如实告知用户；仅建议微小的改进
`yuque_update_doc` 失败	回退到创建新文档
笔记中混合多种语言	保持主要语言；不要强制翻译

Skills CLI 使用指南：AI Agent 技能包管理器安装与管理教程

44,900 周安装

语雀笔记AI整理助手 - 一键重构润色笔记，零散内容变结构化文档

🇨🇳中文介绍

Note Refine — 重构与润色你的笔记

使用时机

所需的 MCP 工具

相关 Skills

工作流程

步骤 1：识别源笔记

步骤 2：读取所有源笔记

步骤 3：分析与规划

步骤 4：整理笔记

4a. 单文档整理

4b. 多文档整合

步骤 5：保存整理后的文档

步骤 6：确认

指导原则

错误处理

最新 Skills