SuperAPI AI 工具集

Refactoring Safely

编程与开发

查看项目

更新于 10-16 02:35

技能介绍

用途:指导在不改变代码行为的前提下改进代码结构,适用于改名、提取方法或类、降低复杂度、改善结构以及响应代码评审意见等场景。

主要能力:给出三条铁律——重构前必须有通过的测试(无例外)、一次只做一处改动、绝不把重构与修 bug 或新功能混在一起;并提供分步流程:确认测试存在且通过、做一处最小结构改动、运行完整测试、提交单一改动、重复直至完成。

必要用法:测试已存在且通过则直接重构;测试失败先修测试;没有测试则先补测试并观察其通过再重构。大型重构按增量方式逐段提取,每步测试并提交。若重构中发现 bug,立即停止,用 git stash 暂存或提交进行中的重构,先写失败测试、修复、验证通过并单独提交(fix: ...),再恢复重构并单独提交(refactor: ...)。发现可加功能时同理,先记录,完成重构后再单独提交。

适用场景:日常代码整理、代码评审后的结构调整、大函数拆分等。

限制:资料未提供具体语言、工具链或平台要求;核心约束是不得在无测试或测试失败时重构,不得混合行为变更与结构变更。