SuperAPI AI 工具集

refactoring

编程与开发

查看项目

更新于 10-16 06:13

技能介绍

用途:在不改变系统外部可观察行为的前提下,改进可运行代码的设计,防止实现质量在版本迭代中衰减。只有当评审、技术债证据或反复出现的实现摩擦表明当前结构会增加未来成本或风险时,重构才有正当理由。若行为发生变化,则属于功能开发或缺陷修复,而非重构。

主要能力:围绕单一结构问题展开,例如重复代码、超大函数、不稳定的接缝、隐藏依赖或掩盖意图的命名;先定义不可改变的不变量,再以可逆的小步骤推进:为清晰而重命名、在测试通过下提取或内联、把职责移到更清晰的接缝、在新形态被验证后消除重复。每一步后运行相关测试。

输入:source-code(需要结构改进的当前实现)、test-suite(证明行为未变的安全网)、review-report(评审中识别出的结构问题)、tech-debt-registry(证明重构针对的是反复出现的成本而非个人偏好)。

输出:行为等价、结构改进且持续修改成本更低的代码。

质量门:测试证明行为保持稳定;重构针对具体的结构问题;改动范围窄、可评审、可回滚;复杂度、耦合或重复可测量地降低;不混入顺手做的功能开发。

反模式:凭直觉重构;以清理之名夹带行为变更;不安全的大步重写;没有测试安全网的清理。

相关技能:feature-development、tdd、code-review、tech-debt-management。

分发:公开安装面为 skills/.curated,规范编写源为 skills/04-implementation/refactoring/SKILL.md,该包为兼容 npx skills add/update 而导出。打包稳定性与能力就绪度均为 beta。