核心用法
code-refactor 技能用于对现有代码库进行纯结构性改造，在不改变程序行为的前提下提升代码质量。触发场景包括：消除重复代码块、拆分过长函数、优化命名表达、简化嵌套条件、重组模块边界等。该技能通过"先识别问题→再规划重构→最后验证等价性"的三段式工作流，确保重构过程可控、结果可信。
显著优点
行为安全优先：技能设计将"行为不变性"作为最高约束，强制要求重构前确认当前行为，并在重构后执行等价验证，有效避免重构引入的回归缺陷。
问题驱动而非方案驱动：不套用固定重构模式，而是先诊断具体痛点（重复、命名混乱、职责模糊），再针对性选择重构策略，避免过度工程化。
接口保护机制：默认不破坏公共 API 和调用方契约，适合在遗留系统或多人协作场景下渐进式改进，降低重构的社会成本。
业务逻辑隔离：明确禁止"顺手加功能"，确保单一变更目的，便于代码审查和回滚追溯。
潜在缺点与局限性
自动化程度有限：技能本身不提供自动化重构工具链，具体代码修改依赖人工执行或 IDE 辅助，对大型重构的效率提升有限。
验证依赖人工："行为不变"的验证环节需用户自行完成（单元测试、集成测试或手工确认），若测试覆盖不足，仍存在引入缺陷的风险。
语义理解边界：对复杂业务逻辑或隐式副作用（如时序依赖、外部状态耦合）的识别依赖用户输入，无法自动推断所有行为约束。
不适合架构级重构：聚焦于函数级、模块级的代码整理，对跨服务拆分、技术栈迁移等结构性变革支持有限。
适合人群
- 需要维护遗留代码库的开发者
- 进行代码审查并希望给出具体改进建议的技术负责人
- 学习重构手法、希望建立规范流程的初中级工程师
- 追求"干净代码"但需兼顾生产稳定性的务实团队
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 行为漂移 | 重构时意外改变边界条件或执行顺序 | 重构前补充单元测试，覆盖边界场景 |
| 过度抽象 | 为消除少量重复而引入复杂继承或配置层 | 坚持"明显降低复杂度"原则，拒绝过早抽象 |
| 注释失效 | 重构后代码与注释脱节 | 将注释同步纳入代码审查清单 |
| 范围蔓延 | 借重构之名夹带功能变更 | 使用版本控制分离重构提交与功能提交 |