Menu
执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
实现关注点分离，确保不同职责模块化和边界清晰。当需要架构分层设计、模块职责划分、横切关注点处理时使用。覆盖层次分离、功能分离、横切关注点三大维度，提供分离检查清单和耦合问题的诊断修复方法。
应用面向对象设计五大原则（单一职责、开闭、里氏替换、接口隔离、依赖倒置），系统化评审类与模块设计质量。当需要评审架构设计、重构现有代码、审查类职责划分时使用。支持多层次检查清单和违反原则的诊断修复。
识别并消除过度设计，确保只实现当前明确需要的功能。当需要评审功能范围、重构冗余代码、权衡技术债务时使用。覆盖功能必要性、过度设计信号、技术债务权衡三大维度，提供具体的识别标准和删减建议。
多维度审查 Markdown 文档质量，覆盖结构、内容、格式、引用、元数据五大维度。当需要评审文档质量、统一格式规范、验收交付文档时使用。提供分级检查清单、通过标准、常见问题修复指南，支持从快速检查到深度审计的多层次需求。
识别并消除知识重复，确保系统中每条知识有唯一权威表示。当需要重构代码、整理文档、优化配置、建立单一数据源时使用。覆盖代码重复、数据冗余、文档重复三大维度，提供具体消除策略和权衡建议。
评估用户故事质量的六维度框架（独立性、可协商、有价值、可估算、小粒度、可测试），系统化审查需求质量。当需要编写用户故事、评审需求文档、拆分史诗故事时使用。提供分级检查清单和低质量故事的改进建议。
| name | refactoring |
| description | 执行代码重构（识别坏味道→选择手法→小步修改→运行测试），在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。 |
| stage | EXECSPEC_FULFILL |
| level_supported | ["L1-STREAMLINED","L2-BALANCED","L3-RIGOROUS"] |
Scope: EXECSPEC_FULFILL — Fulfill ExecSpec（落实 ExecSpec）
版本: 0.1.0（占位）| 创建日期: 2025-11-27
Refactoring 是在不改变外部行为的前提下改进代码内部结构：
┌─────────────────────────────────────────────────────┐
│ 🔧 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 语句 | 多处相同 switch | Replace with Polymorphism |
Extract Method → 提取函数
Extract Class → 提取类
Extract Interface → 提取接口
Extract Variable → 提取变量
Move Method → 移动方法
Move Field → 移动字段
Move Class → 移动类
Inline Method → 内联方法
Inline Class → 内联类
Remove Parameter → 移除参数
Rename → 重命名
□ 确保测试覆盖充分
□ 理解现有代码行为
□ 识别要重构的坏味道
□ 选择合适的重构手法
□ 小步修改（每步 < 5 分钟）
□ 每步后运行测试
□ 提交小步变更
□ 所有测试通过
□ 代码结构改善
□ 无行为变化
>>smell_detect # 检测代码坏味道
>>refactor_suggest # 建议重构手法
>>refactor_verify # 验证重构结果
TODO: 待细化各重构手法的详细步骤和示例