用途:指导对现有代码库做策略性而非战术性的修改。核心主张是“能跑通”不够——每个最小补丁都会加特例、开关或依赖,复杂度会一点点累积;若不改善设计,往往是在让它变坏。
修改前:阅读改动周边的设计,包括模块接口、调用方与既有约定;自问“如果这个模块从一开始就带着此次改动来设计,会是什么样”,并画出其形状;列出当前结构与此次改动冲突之处,常见信号包括需要新增 flag 或布尔参数、把参数穿透到并不使用它的层、知识在第二个模块中重复、为单个调用方加一个 if。
路径选择:理想做法是朝草图重构后再改动,当重构范围贴近所改代码时默认选它,目标多花约 10–20% 精力;次优是找能拿到大部分收益、但成本低得多的变体;只有在真实约束(如截止日期、跨团队不兼容)下才采取战术性修改,且必须显式记录债务(带原因的 TODO 或 issue),不得静默留下。
编辑中:把改动吸收进正常路径而非新增特例;把新增复杂度下拉到接口之后,不暴露给调用方;便宜时顺手修一处邻近设计瑕疵;遵循既有约定,只有同时满足“有显著新信息”且“值得更新所有旧用法”才改约定,改后不留旧痕迹。
编辑后检查 diff:是否新增特例、flag、配置旋钮或透传参数;是否有设计决策现在出现在两处;改动附近的注释是否过时并在原地更新;“为什么”(隐蔽 bug、变通)是否只在提交信息里,应写进代码;是否遗留调试代码或零散 TODO。
限制:不要把小的修复变成无关重写,只重构改动触及或直接阻碍改动之处,较大的清理另行提案。输出时做改动并报告简短设计变化:Design 更好/不变/更差及一行原因、Refactored 做了什么、Debt 记录下的捷径或 none。该技能的收费、平台与具体安装方式暂未提供。