用途
本技能帮助用户把零散、粗糙的笔记转化为结构良好、去重且内容更丰富的文档,将混乱变为清晰。适用于个人语雀知识库中的笔记整理。
主要能力
- 识别来源笔记:支持指定单篇文档、某日期范围的每日捕获、按主题关键词查找的分散笔记,或多篇文档合并。
- 读取与分析:读取最多 5-10 篇来源文档,分析主题分布、发现重复内容、识别信息缺口,并给出整理建议。
- 重构与润色:为单篇文档添加清晰标题与层级、去除重复、改进措辞、补充上下文与过渡,或将时间顺序笔记整理为逻辑结构。
- 多文档合并:按主题分组、跨文档去重、形成连贯叙述,并保留原始日期/来源归属。
- 保存方式可选:默认创建新文档(推荐用于多文档合并),也可原地更新原文档(用于单篇整理)。
- 整理成果确认:展示输入输出字数、去除重复处数、标记待补充处数等信息。
使用方式
技能依赖 yuque-mcp 服务器的以下工具:yuque_search(查找目标笔记)、yuque_get_doc(读取笔记全文)、yuque_list_repos(列出个人仓库)、yuque_list_docs(列出仓库内文档)、yuque_create_doc(创建整理后文档)、yuque_update_doc(原地更新原文档)。
工作流程:
- 识别来源笔记:用户可提供具体文档、日期范围、主题关键词或多篇文档引用。例如用户说“整理我最近的笔记”时,使用 yuque_search,参数 query 为“每日捕获”,type 为“doc”;或按主题关键词搜索。
- 读取所有来源笔记:对每篇文档调用 yuque_get_doc,参数 repo_id 为命名空间,doc_id 为 slug。最多读取 5-10 篇,更多时按新近度和相关性优先。
- 分析与规划:识别主题、发现重复、找出缺口、评估结构,并向用户展示分析结果(来源篇数与字数、主题分布、发现重复/缺口数量、建议整理为几篇主题文档),询问是否按此方向整理。
- 整理笔记:单篇文档重构或多文档合并。整理后文档模板包含主题标题、整理来源与时间跨度、概述、分类与子主题、待补充清单、原始来源链接及日期,以及“本文档由 AI 助手整理,原始笔记已保留”的说明。
- 保存整理后文档:询问用户偏好。创建新文档时调用 yuque_create_doc,参数 repo_id、title、body、format 为 markdown;原地更新时调用 yuque_update_doc,参数 repo_id、doc_id、body。
- 确认:展示文档链接、保存位置、整理成果(输入输出字数、去除重复处数、标记待补充处数),并提示原始笔记已保留。
适用场景
- 用户想清理杂乱笔记,或说“帮我整理笔记”“refine my notes”“把这些笔记理一下”。
- 用户积累了每日捕获,想要合并整理。
- 用户说“这些笔记太乱了”“帮我重新组织一下”“去重整理”。
- 笔记跨多个主题时,可按主题分别创建整理文档。
- 对每日捕获,建议每周或每两周整理一次。
限制与注意事项
- 默认保留原始笔记,整理为新文档。
- 去重时不丢弃信息,而是合并与丰富。
- 保持用户语气与术语,不过度正式化随意笔记。
- 不确定的解释用“【待确认】”标记。
- 为识别出的缺口添加“待补充”部分。
- 默认语言为中文。
- 错误处理:来源笔记过少(少于 3 篇)时整理现有内容并建议先多记录;来源笔记过多(超过 10 篇)时聚焦最新或请用户缩小范围;内容已结构良好时如实告知,仅建议小幅改进;yuque_update_doc 失败时回退为创建新文档;笔记语言混杂时保持主导语言,不强制翻译。