用途:当设计决策中途改变(换了方案、概念改名、机制被替换)时,分支常残留旧设计的痕迹,如死分支、只为旧路径服务的垫片、按旧概念命名的标识符、叙述变更的注释、锁定已无意义行为的测试。本技能负责清除这些残留,把结果重写成仿佛当前设计从一开始就存在。
主要能力与步骤:
- 确立决策:用一行表述“设计是 X,被放弃的方案是 Y”,来自用户或会话上下文;若未说明,则从分支 diff 和提交信息重建,并在大范围修改前与用户确认。
- 确定范围:计算分支差异 git diff $(git merge-base HEAD origin/main)...HEAD(回退到 origin/develop,再回退到 develop)。只处理与决策相关的代码,以及引用被改名或删除概念的文件(用旧名称 grep 查找),其余不在范围内。
- 搜寻残留:检查死代码(仅旧路径使用的分支、参数、特性开关、配置键、辅助函数)、垫片与间接层、按旧概念命名的标识符/文件/模块、描述旧设计或叙述变更的注释与文档字符串、锁定废弃行为或旧 API 形态的测试、描述旧机制的文档、为旧计划留下的 TODO。
- 重写而非打补丁:全面按当前概念改名;直接删除死代码,不注释掉也不加开关保留;合并不再有价值的间接层;重写受影响的注释、文档字符串和文档,只描述当前状态。
- 验证与报告:运行项目构建和测试,清理不得改变保留设计的行为;用 previously|instead of|no longer|old |new |V2|legacy 对分支 diff 做冒烟检查;全树 grep 废弃名称确认无悬空引用;按上述类别报告删除、改名和重写的内容,并指出因超出决策范围而未处理的疑点。
适用场景:开发中途设计变更后的分支清理。限制:不授权做无关重构、格式化或顺手改进;若决策理解错误,清理会破坏正确代码,因此需先确认。