SuperAPI AI 工具集

learnings

办公与效率

查看项目

更新于 10-16 06:42

技能介绍

用途:在仓库范围内维护有证据支撑的执行学习记录(execution learnings),存放于由 $ledger 解析出的持久保管位置,并仅选择性把高价值快照录入全局 Codex 记忆编译器。工作树共享历史,但不共享产物的适用范围。

主要能力:

  • 捕获或回忆学习记录,支持浏览、查看最近、搜索、排序、汇总。
  • 通过 Capture Gate 判断是否值得记录,条件包括验证状态转变、策略转向、隐藏陷阱或脆弱假设、重复加速模式、有用的或失败的回忆学习、真实实现工作后的交付边界。要求存在决策增量、可迁移性和反事实成本;优先一条关键学习,每轮最多追加三条。
  • 记忆准入:经授权的准入、取代或撤回操作,将快照写入 ~/.codex/memories/extensions/learnings/notes/.md,编译记忆仅由 Phase 2 写入 memory_summary.md / MEMORY.md / skills/。
  • 每次实质激活保留唯一内部结论:appended、duplicate-skip、no-op 或 blocked。

使用方式:在交付或捕获触发点,先依据任务证据评估 Capture Gate。若不通过且未请求回忆或规范操作,则内部保留 no-op 并返回,不加载存储/准入手册、不解析存储、不引导 Ledger。交付时评估是强制的,追加是条件性的。按所选操作读取对应文档:规范浏览/查询/回忆读 store.md 和 recall.md;已接受的捕获或规范取代读 store.md 和 capture.md;已授权恢复已退役 Learnings 读 retired-import.md;记忆准入等读 memory-admission.md。已接受的准入需在调用 run_memory_note_tool 前加载 $memory-source-notes。

适用场景:仓库内实现工作后的提交、PR 或交接前;失败转通过、通过转失败、超时转稳定;策略转向、陷阱、重试循环或加速模式;“我们已知关于 X 什么”;经验教训、总结、交接等。

限制:所有行须基于观察到的证据;写有边界的规则,不写变更日志式条目或缺乏支持的普遍结论;不可从未验证的非仓库 cwd 追加;不强制添加私有规范源存储;不绕过 Ledger、不编辑持久记录、不回退到 checkout 存储;不把每条学习都录入记忆,不直接写编译记忆;不用源笔记绕过规范保管;不因 Learnings 激活就调用同级源。更改学习验证规则使用 validation-probes.md,这些是包评估用例,不是运行时清单或捕获前提。学习可播下负面证据,但它不是操作路由门;目睹的失败假设通过 Negative Evidence 定义的捕获事务提升,再用其记忆笔记投影准入。