AgentSkillsCN

refactoring

执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

中文原作
SKILL.md
--- frontmatter
name: refactoring
description: 执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。
stage: EXECSPEC_FULFILL
level_supported: [L1-STREAMLINED, L2-BALANCED, L3-RIGOROUS]

Refactoring Skill

Scope: EXECSPEC_FULFILL — Fulfill ExecSpec（落实 ExecSpec）

版本: 0.1.0（占位）| 创建日期: 2025-11-27

概述

Refactoring 是在不改变外部行为的前提下改进代码内部结构：

code
┌─────────────────────────────────────────────────────┐
│              🔧 Refactoring Cycle                   │
├─────────────────────────────────────────────────────┤
│  识别坏味道 → 选择手法 → 小步修改 → 运行测试       │
│  (Smell)     (Technique) (Small Step) (Verify)    │
│       ↑                                   │        │
│       └───────────────────────────────────┘        │
└─────────────────────────────────────────────────────┘

核心原则：

  • •小步前进，每步都可验证
  • •测试必须始终通过
  • •行为不变，结构改进

代码坏味道

常见坏味道

坏味道信号重构方向
重复代码相似代码块 > 2 处Extract Method
过长函数> 20 行Extract Method
过大类> 300 行Extract Class
过长参数> 4 个参数Introduce Parameter Object
特性依恋方法更多使用其他类数据Move Method
数据泥团相同数据组合多处出现Extract Class
基本类型偏执过度使用基本类型Replace with Object
Switch 语句多处相同 switchReplace with Polymorphism

重构手法

提取类手法

code
Extract Method      → 提取函数
Extract Class       → 提取类
Extract Interface   → 提取接口
Extract Variable    → 提取变量

移动类手法

code
Move Method         → 移动方法
Move Field          → 移动字段
Move Class          → 移动类

简化类手法

code
Inline Method       → 内联方法
Inline Class        → 内联类
Remove Parameter    → 移除参数
Rename              → 重命名

L1-STREAMLINED 检查清单

  • • 重构前测试全绿
  • • 每步修改后运行测试
  • • 无新功能添加
  • • 代码可读性提升

通过标准

  • •4 项全部通过（100%）

重构流程

1. 准备阶段

code
□ 确保测试覆盖充分
□ 理解现有代码行为
□ 识别要重构的坏味道

2. 执行阶段

code
□ 选择合适的重构手法
□ 小步修改（每步 < 5 分钟）
□ 每步后运行测试
□ 提交小步变更

3. 验证阶段

code
□ 所有测试通过
□ 代码结构改善
□ 无行为变化

>> 命令

code
>>smell_detect       # 检测代码坏味道
>>refactor_suggest   # 建议重构手法
>>refactor_verify    # 验证重构结果

相关 Skills

  • •前置: tdd-cycle（GREEN 后进入 REFACTOR）
  • •并行: code-quality（质量检查）
  • •原则: principle-dry, principle-kiss, principle-solid

TODO: 待细化各重构手法的详细步骤和示例