SuperAPI AI 工具集

save-note

办公与效率

查看项目

更新于 10-16 07:12

技能介绍

用途

save-note 用于把对话中产生的洞察保存为一条可再次找到的笔记,可按主题、日期或项目检索。当用户表达“保存这个”“记下这个”“保留这个”等意图时使用。

主要能力

  • 提炼洞察:用一到三句话陈述洞察,使没有参与该对话的读者也能理解;在措辞重要时引用用户或来源的原话。
  • 记录上下文:说明当时在做什么、属于哪个项目、是什么引出了该洞察。
  • 命名主题:用二到六个词概括笔记内容。
  • 保存与回放:写入记录,然后回放。

记录存储

记录存放在存储路径 ${CLAUDE_PLUGIN_DATA}/records/,并在镜像文件夹 ${user_config.records_mirror} 中保留一份副本。

  • 当存储路径不是绝对路径时,表示此处不存在存储。此时仍构建记录,并在回复末尾以 jsonl 代码块形式、按其文件名给出,供用户自行保存。
  • 当镜像路径为空或仍是占位符时,跳过镜像。否则,在本次运行的最后一行之后,把记录文件以相同名称复制到镜像中。
  • 任一文件夹缺失时创建它。

记录格式

每条记录按本节末尾模板的形式写入:先写文件名,然后每行一个 JSON 对象,每个事件一行,按事件发生顺序排列,替换所有方括号中的值。某类事件在本次运行中产生几次就写几次,未产生的类型则省略。时间取自 UTC 时钟,例如文件名使用 date -u +%Y%m%dT%H%M%SZ。主题是二到六个小写单词,用连字符连接。答案的 q 指明它所回答的问题或开放项。

只能追加行;绝不修改或删除某一行。

当多行共享同一 id 时,以最新者为准。链接的 id 由其 from、to 和 rel 组成。"retired": true 会移除该条目。

要恢复一次运行,读取其文件(若只有镜像持有该文件,先从镜像复制),并追加一行带 "resumed": true 的 run 行。

回答某条记录问题的智能体,把它的 answer、skip 和 open 行追加到同一文件,并在 by 中写明自己的名称。

在一次运行结束时,按 assets/playback.md 的形式回放记录:先给出保存到的路径,然后给出回复中尚未展示的每一部分。绝不展示原始行。

把洞察作为 subject 记录为一行,把洞察及其上下文记录为 note,把其留下的每个问题记录为一行 open。

文件与模板

文件名:save-note_[start time, UTC, YYYYMMDDTHHMMSSZ]_[topic].jsonl

{"kind": "run", "at": "[time, UTC, YYYY-MM-DDTHH:MM:SSZ]", "skill": "save-note", "topic": "[topic]", "subject": "[the insight in one line]", "project": "[repository or project name, or empty]", "resumed": false}
{"kind": "note", "at": "[time]", "text": "[the insight, one to three sentences]", "context": "[what was being worked on and what led to it]"}
{"kind": "open", "at": "[time]", "id": "open-1", "text": "[a question the insight leaves]", "q": ""}

适用场景

  • 对话中产生了值得保留的洞察,用户希望日后能按主题、日期或项目找回。
  • 需要把一次工作过程的关键结论连同上下文一起归档。
  • 需要记录洞察留下的开放问题,供后续回答或跟进。

限制

  • 当存储路径不是绝对路径时,本技能无法写入存储,只能把记录以 jsonl 代码块形式交给用户自行保存。
  • 当镜像路径为空或仍是占位符时,不会执行镜像复制。
  • 记录只能追加,不能修改或删除已有行;同一 id 以最新行为准,"retired": true 用于移除条目。
  • 回放时不展示原始行。
  • 关于收费、价格、平台支持范围等信息,资料中暂未提供。