SuperAPI AI 工具集

memory

编程与开发

查看项目

更新于 10-16 01:38

技能介绍

用途:对从过往 AI 编码会话中挖掘出的上下文记忆候选做筛选,产出少量耐久、可复用的事实,供后续 agent 参考。

主要能力与用法:使用 sessions memory 命令族。sessions memory mine --repo <path> --json 挖掘候选(省略 --repo 为当前仓库,--all 挖掘索引中所有仓库,--since-last 只挖自上次以来变化的转录);stdout 为候选记录 JSON 数组,进度输出到 stderr,命令不存在时应说明并停止,不得改用搜索;数组为空应说明无可筛选内容并停止,不得编造候选。sessions memory report --repo <path> --json 返回模糊 paraphrases 对,需人工确认或否认;确认用 sessions memory merge <memory-id> <cluster-id>,否认用 sessions memory snooze <cluster-id>。sessions memory documented --json 列出已被绑定的陈述(只读不写)。可用 sessions memory import --from pi-hermes(或 claude、all)先导入其他 agent 的记忆作为候选。

筛选规则:只提出同时满足“超出出现该事实的会话”且“未被已绑定内容陈述”的簇。通过项包括长期约束、仓库或工具事实、架构规则;不通过项包括一次性任务指令、bug 报告、命名具体临时产物者、已文档化者、疑似复制粘贴的提示词或评测夹具。与已绑定内容矛盾的不得擅自裁决,应呈现给用户决定。kind 分 instruction 与 information。写入事实而非原话,可用 sessions memory approve <id> --as "<the fact>" 重写陈述,原始保留为证据。审批项持久化:merge、approve(加 --always-on 为长期约束)、reject、snooze,未知 id 时退出非零表示未记录。

限制:repo 与 workflow 作用域由证据推导、只展示不可编辑,group 可指定,workflow 永不可指定。always-on 集合有硬上限(20 条/2000 字符)。缺失事实暂未提供的部分未在资料中说明。