SuperAPI AI 工具集

memory-source-notes

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:为受控自定义记忆源提供唯一追加式传输路径、有界派生摘要工具,以及跨源只读对账应用。仅写入来源证据,路径为 ~/.codex/memories/extensions/<extension>/notes/.md,从不直接写入 memory_summary.md、MEMORY.md 或 skills/。

主要能力:支持 learnings、negative-ledger、synesthesia 三类扩展;通过校验适配器调用 memory-note CLI 写入不可变笔记;提供 Synesthesia 当前状态摘要生成、指令复制部署、doctor 诊断、以及跨 canonical 源、不可变笔记与 Phase 2 可见性的只读对账。拒绝 ad_hoc 与 Chronicle。

使用方式:先加载 $ledger 并执行一次 $ledger ensure。通用追加命令为 run_memory_note_tool append --extension <extension> --kind <kind> --json -。Synesthesia 使用 uv run "$memory_source_notes_root/scripts/synesthesia_memory_note.py" admit --repo "<canonical-custody-root>" --id SYN-...;Negative Ledger 使用对应脚本的 admit、inspect。摘要刷新用 memory-digest,指令同步用 sync-instructions,诊断用 doctor。对账脚本为 source-memory-reconcile.py。

限制:不授予语义权威,不决定来源资格,不直接写编译记忆;失败时不回滚上游成功写入;不得手动编写笔记替代缺失 CLI;不得将实时扩展指令部署为符号链接;不得存储凭据、令牌、私钥或原始聊天记录。