用途:在非平凡实现工作之后、收尾之前,运行一次简短的 AGENTS.md 维护检查,决定是否需要更新这份持久仓库指引。
主要能力:把 AGENTS.md 视为长期有效的仓库级指引,而不是任务日志。仅当已实现代码、测试和文档状态证明新规则成立时才修改。适合更新的内容:必需的构建、测试、lint、类型检查或验证命令;架构不变量或硬性约束;规范数据形状、契约、目录归属或文件位置;仓库级编码、评审或发布期望;未来会话必须避免的重复故障模式。不应更新:一次性功能细节、分支上下文、临时迁移、issue 备注、任务计划、历史总结或实现叙述。
使用方式:比较已实现的 diff 与当前 AGENTS.md;判断完成的工作是否改变了持久仓库指引,若否即停止;若是,做最小有效补丁;再对照当前代码库、测试与文档复核;同一轮中删除或收紧过时、重复或被取代的条目。编辑保持最小、高信号,优先替换、收紧、去重或删除现有条目,而非追加散文。规则写成简短、具体、命令式的要点,便于编码智能体在新会话无先前上下文时直接应用。根 AGENTS.md 只放广泛适用的指引,范围受限的规则放入最近的文件夹级 AGENTS.md,可复用工作流放入技能或引用文档。可使用 $reducing-entropy、$clean-code、$hard-cut 辅助判断增、收或删;若允许且有益,可用小型子智能体比较 diff 与 AGENTS.md 并提出最小补丁。
限制:不得包含 Phase、plan、follow-up 等工作会话措辞;每次编辑必须与当前代码库完全一致。收尾前需逐项验证每处改动是否持久、与仓库相关、不重复、与当前代码和测试一致、对零上下文编码智能体有用;任一检查不通过就保持 AGENTS.md 不变。资料未提供具体安装命令、收费或平台信息。