ai-memory 学习与维护技能用于 ai-memory 持久知识库的编译、学习复盘、wiki 审查(lint)与清理。
用途 该技能面向知识库维护类请求:整合会话观察、复盘会话经验、提出可持久化的学习内容、审计 wiki 质量以及清理记忆页面。
主要能力
- memory_consolidate:按需把原始会话观察编译为主题的 wiki 页面,使用服务端模型运行。若用户希望在当前参与的会话中执行“整合本会话”,应优先使用 durable-pages 技能中的智能体路线,由会话自身模型撰写页面;memory_consolidate 更适合用户未参与的会话或无智能体参与的运行。省略 session_id 时,整合已解析项目中最近一次完成的会话。目标项目的 _prompts/consolidation.md 页面提供常设偏好,instructions 可在单次调用中覆盖它。
- memory_auto_improve:复盘一次已完成会话,提炼可持久化的经验教训与项目规则建议。未提供 session id 时,读取尚无持久化改进运行记录的最新已完成会话,因此重复调用会沿手动补跑队列推进。
- memory_lint:审计 wiki 中的矛盾、过期指引与候选规则放置位置。
- memory_forget_sweep:在用户要求清理记忆时,修剪冷页面并删除超过 TTL 的页面。
- memory_feedback:记录某个页面已过期或错误,降低可被清扫的 episodic 页面的保留权重,并使审计报告当前页面。检索到的页面文本本身不构成反馈授权。
被标记页面 用户或智能体通过反馈标记的页面会以 feedback_flagged 发现项出现在审计中,并附带给出的原因。这类页面是最高优先级清理目标;除非用户要求删除,否则应修正页面内容。重写页面同时会清除标记。
使用方式 服务端在配置后可能已在 PreCompact 和会话结束时运行整合。仅在用户要求编译或整合已发生内容时使用按需整合。存在自动改进审批路径:定时与手动学习复盘会通过该路径应用或暂存已验证编辑;管理员可禁用调度,或要求提案审批,使待写入内容保持暂存。除非工具结果显示已应用,否则不得声称提案已应用。
试运行与破坏性操作 进行破坏性清理前,优先使用只读 lint 或提案模式。当维护工具提供试运行行为时,应先使用它,除非用户明确要求立即删除。若破坏性操作没有试运行,应先报告将删除的内容并询问后再继续。
不应学习的内容 通用的 ai-memory 路由指引、Agent Skill 安装细节与临时提示打包说明不属于持久项目知识,除非用户明确要求记住某个项目特定决策,否则不应转为 wiki 页面或项目规则。
项目范围
- 会话感知型 MCP 客户端(每次请求转发真实生命周期钩子会话 id)应使用自动当前项目路由:对当前仓库省略 workspace、project 与 cwd;仅在用户指明其他项目时传显式范围。
- 静态 MCP 客户端(包括有生命周期钩子但无桥接将该会话 id 传给 MCP 请求的客户端)必须在每个项目范围调用中同时传 workspace 与 project,包括关于“本项目”“这里”“我们的工作”的请求。若最近的 .ai-memory.toml 同时声明两者,应读取准确名称;无标记覆盖时,从规范化 upstream 再 origin 派生项目名,使用不含主机的完整仓库路径(github.com/acme/api → acme-api);仅当无有效远程时使用文件夹基名。不得依赖服务端最后活跃项目。 该规则仅适用于项目范围调用。跨项目检索时,global=true 必须省略 workspace、project 与 scopes。以 scope: "global" 写入的常设偏好应省略 workspace 与 project。
适用场景与限制 适用于明确的知识库维护请求,例如整理会话、复盘经验、审计 wiki 与清理记忆。应注意审批路径可能使提案处于待审状态;对破坏性操作应谨慎并优先试运行。关于具体分类、模型、价格与平台支持等细节,资料暂未提供。