SuperAPI AI 工具集

vestige-record-note

办公与效率

查看项目

更新于 10-15 20:27

技能介绍

用途:把不适合归入更具体类型的项目知识记录到 Vestige 记忆。笔记是兜底类别,信号强度低于决策,但仍值得保留,涵盖顿悟时刻、TIL、坑点、代码异味和长期 TODO。

触发时机:发现代码库中非显而易见的事(如 cargo test --workspace 会在 tmpdir 形状的测试中触发 FTS 触发器);找到工具怪癖的变通方法;遇到意外行为、错误假设或调试后的根因;标记应跨会话保留的代码异味或重构候选;用户说“记一下”“note that”“值得记录”但未指明是决策时。

与同类技能的区分:若带有承诺和原因,用 vestige-record-decision;若是用户观点或约定,用 vestige-record-preference;若答案未知,用 vestige-record-question。

调用方式:vestige note add "<一两句话的事实>" --importance 0.5 --json。body 为位置参数且必填,需写成可独立阅读的形式。--importance 可选,默认 0.5;琐事可降到 0.3,代码异味或根因可升到 0.6,丢失会真正造成损失才用 0.7。--source 可选,用于附上具体文件、PR 或 URL;--source-content 可选,内联片段上限 2 KiB。

调用后:JSON 信封返回 { "id": "mem_<ULID>", ... },只需回一句“Noted mem_…”,无需读回正文。

幂等与去重:每次调用都是新写入。记录前若觉得熟悉,先用 vestige recall "<关键短语>" --json --limit 3 去重;若首条命中是同一事实且重要度相当,则跳过写入。若因内容变化而记录,应写入新笔记并用 vestige-forget 移除过时笔记,不要同时保留两条。

限制:不要记录对话中的确认性回应、已存在于代码中的内容(注释更合适),以及实际属于决策、偏好或问题的内容。