用途:本技能用于重构(含结构、边界、契约的再设计)的取舍与推进,目标是降低未来的变更成本。适用于本地开发完成、尚未反映到预发布或生产环境的代码,此时可不受外部影响大胆调整结构。触发场景包括代码难以理解或维护、函数或类过大、需要处理 Code Smell、因代码结构导致功能难以追加,以及用户提出“把代码整理一下”“重构一下”“优化一下”等要求。
主要能力:重构分两个维度。一是内部卫生,改善可读性并保持外部可观测行为不变,包括传达意图的命名、消除重复、关注点分离、删除无用内容。二是结构再设计,重审职责、边界、契约与依赖关系,修正 AI 易产生的局部最优结构,关注未来变更成本。技能给出判断原理,如耦合布置、循环依赖必须消除、命名体现职责、抽象化是成本、管理本质性与偶然性复杂度等,并列出抽象化、复杂度、命名的观测信号。
使用方式:先执行 Phase 1 内部卫生:理解代码、按观测信号评估、对征兆建立假设,再用调用方与依赖关系验证假设,最后选择合适改动;检测到征兆不得立即修改,边界与职责配置相关事项需参照 module-boundary-design 技能。随后执行 Phase 2 结构再设计:理解目的与范围、观察职责与依赖、进行边界设计,再统一重构相关范围,避免半途而废。
限制:不适用于琐碎逻辑修正或外观调整;文档所述原则面向以人为主体的传统开发方式,对具备更大认知范围与执行步数的 AI 不再适用。文档未提供安装命令、价格、平台与效果等信息。