用途
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用于移除条目。 - 回放时不展示原始行。
- 关于收费、价格、平台支持范围等信息,资料中暂未提供。