用途:在保持可观察行为不变的前提下,重构代码的阅读性、分解方式或分层结构。它把重构纪律叠加在基础 implement-task 规则之上,属于执行环节,基线、批次计划与回滚由工作区的变更计划负责。
主要能力与规则:用等价性检查证明行为保持,而非依赖测试全绿;可用属性测试、差分测试(保留旧路径并对比)或变更前固定的黄金输出。若测试失败,视为行为已变,先调查再动测试。逐文件修改,禁止批量 codemod。每个批次都运行检查并粘贴输出,默认约 10 个文件一批,风险处收紧。优先删除而非修改,删除每个符号需粘贴源码与测试中零调用者的搜索证据,并单独搜索字符串形式以覆盖动态分派、注册表、反射、生成代码与配置。每个垫片在引入前须有可验证的移除条件,例如 git grep -c '<old-name>' src/ 返回 0。禁止“顺手”做语义改进;迁移后确认旧位置已空。粘贴真实输出,命令从 AGENTS.md 解析,未定义时询问,且不得对自己的工作写评审结果。
适用场景:需要安全重构、清理死代码、引入临时兼容层并计划移除的工程任务。
限制:这些是评审包检查的约定,编辑时无强制机制;若可观察行为发生变化,就不再是重构,而是重写或迁移,应停止并说明。官方文本暂未提供。