用途:分析当前编码会话,向 AGENTS.md 提出改进建议并在获得批准后应用修改。适合在会话收尾时沉淀经验、记录最佳实践。
主要能力与流程:先读取现有 AGENTS.md 并梳理已有章节;若仓库为指令文件提供了校验或修复命令,需在提出修改前先运行;随后仅提取本次会话中具备持久价值的经验,按 references/change-proposal-format.md 的格式提出变更建议;必须等待用户明确批准后才能应用编辑,批准后合并进既有内容。
可沉淀内容:会话中确立的编码模式与约定、应长期保留的架构决策及其理由、调试手册与反复出现的坑、能提升后续会话效率的工作流偏好。
护栏:不记录很快过时的临时实现细节;优先更新已有章节而非新建标题;使用简洁要点而非长段落;除非行为因工具而异,否则保持指导与工具无关;若本次会话没有有意义的经验,应报告并停止。
指针文件行为:若 CLAUDE.md、CODEX.md 或 GEMINI.md 缺失或为空,创建指向 AGENTS.md 的符号链接。
输出约定:提案阶段只输出拟议变更及明确的增/改/删数量;应用阶段仅在明确批准后更新 AGENTS.md;完成阶段总结改了什么、改在哪里。安装命令、具体校验命令及价格等信息暂未提供。