SuperAPI AI 工具集

yuque-personal-note-refine

办公与效率

查看项目

更新于 10-16 09:12

技能介绍

用途

本技能帮助用户把零散、粗糙的笔记转化为结构良好、去重且内容更丰富的文档,将混乱变为清晰。适用于个人语雀知识库中的笔记整理。

主要能力

  • 识别来源笔记:支持指定单篇文档、某日期范围的每日捕获、按主题关键词查找的分散笔记,或多篇文档合并。
  • 读取与分析:读取最多 5-10 篇来源文档,分析主题分布、发现重复内容、识别信息缺口,并给出整理建议。
  • 重构与润色:为单篇文档添加清晰标题与层级、去除重复、改进措辞、补充上下文与过渡,或将时间顺序笔记整理为逻辑结构。
  • 多文档合并:按主题分组、跨文档去重、形成连贯叙述,并保留原始日期/来源归属。
  • 保存方式可选:默认创建新文档(推荐用于多文档合并),也可原地更新原文档(用于单篇整理)。
  • 整理成果确认:展示输入输出字数、去除重复处数、标记待补充处数等信息。

使用方式

技能依赖 yuque-mcp 服务器的以下工具:yuque_search(查找目标笔记)、yuque_get_doc(读取笔记全文)、yuque_list_repos(列出个人仓库)、yuque_list_docs(列出仓库内文档)、yuque_create_doc(创建整理后文档)、yuque_update_doc(原地更新原文档)。

工作流程:

  1. 识别来源笔记:用户可提供具体文档、日期范围、主题关键词或多篇文档引用。例如用户说“整理我最近的笔记”时,使用 yuque_search,参数 query 为“每日捕获”,type 为“doc”;或按主题关键词搜索。
  2. 读取所有来源笔记:对每篇文档调用 yuque_get_doc,参数 repo_id 为命名空间,doc_id 为 slug。最多读取 5-10 篇,更多时按新近度和相关性优先。
  3. 分析与规划:识别主题、发现重复、找出缺口、评估结构,并向用户展示分析结果(来源篇数与字数、主题分布、发现重复/缺口数量、建议整理为几篇主题文档),询问是否按此方向整理。
  4. 整理笔记:单篇文档重构或多文档合并。整理后文档模板包含主题标题、整理来源与时间跨度、概述、分类与子主题、待补充清单、原始来源链接及日期,以及“本文档由 AI 助手整理,原始笔记已保留”的说明。
  5. 保存整理后文档:询问用户偏好。创建新文档时调用 yuque_create_doc,参数 repo_id、title、body、format 为 markdown;原地更新时调用 yuque_update_doc,参数 repo_id、doc_id、body。
  6. 确认:展示文档链接、保存位置、整理成果(输入输出字数、去除重复处数、标记待补充处数),并提示原始笔记已保留。

适用场景

  • 用户想清理杂乱笔记,或说“帮我整理笔记”“refine my notes”“把这些笔记理一下”。
  • 用户积累了每日捕获,想要合并整理。
  • 用户说“这些笔记太乱了”“帮我重新组织一下”“去重整理”。
  • 笔记跨多个主题时,可按主题分别创建整理文档。
  • 对每日捕获,建议每周或每两周整理一次。

限制与注意事项

  • 默认保留原始笔记,整理为新文档。
  • 去重时不丢弃信息,而是合并与丰富。
  • 保持用户语气与术语,不过度正式化随意笔记。
  • 不确定的解释用“【待确认】”标记。
  • 为识别出的缺口添加“待补充”部分。
  • 默认语言为中文。
  • 错误处理:来源笔记过少(少于 3 篇)时整理现有内容并建议先多记录;来源笔记过多(超过 10 篇)时聚焦最新或请用户缩小范围;内容已结构良好时如实告知,仅建议小幅改进;yuque_update_doc 失败时回退为创建新文档;笔记语言混杂时保持主导语言,不强制翻译。