用途:把当前会话经验沉淀为长期可执行规则,统一维护在 docs/rules/,并让项目级提示词始终引用最新规则。触发词包括“反思”“复盘”“沉淀规则”“lessons learned”“把经验写进规则”。
主要能力:从会话中提炼可迁移、可执行的教训;合并并反思 docs/rules/ 既有内容而非只追加;更新或创建 AGENTS.md 与 CLAUDE.md 并建立 docs/rules/.md 引用;按规范格式控制规则文档规模。完成时必须同时检查并同步 docs/rules/.md、AGENTS.md、CLAUDE.md;缺失时创建最小可用版本;新增规则文件未被引用时必须补齐引用与一句话摘要。
使用方式:先评估当前系统,读取 docs/rules/**/*.md、AGENTS.md、CLAUDE.md,判断是否满足重整触发条件(涉及 3 个及以上规则文件、同义规则跨文件重复、单文件承载多主题、主题边界无法容纳新教训、索引描述与实际职责不一致、需决定保留/合并/迁移/退役旧规则)。满足则走体系重整,否则走增量更新。随后建立规则清单、设计目标结构、执行重写/合并/拆分/退役/迁移,再同步项目级提示词,运行一致性检查并汇报治理变更。主题文件预计超过 200 行时提前拆分为 topic-part-1.md、topic-part-2.md 等分片。
适用场景:项目规则库治理、会话经验沉淀、AGENTS.md 与 CLAUDE.md 索引维护。
限制:不把会话具体事件原样写成长期规则;仅会话局部、不可迁移的偶发经验不进入长期规则库;规则需可验证,避免空泛表述;文件名须为 kebab-case 且与主题一致。docs/rules/ 不存在时先创建目录;历史规则格式混乱时先归一化再分类重写;主题不明确时先放入最接近主题并标注“待后续重构”。