refactor

用途

refactor 是一个代码重构工作流技能，用于在保证行为不变的前提下安全地重构代码。它适用于以下场景：

• “Refactor X”（重构某段代码）
• “Clean up this code”（清理代码）
• “Extract this into a module”（将代码提取为模块）
• “Improve the architecture of Y”（改进某处架构）
• 大规模代码重构
• 减少技术债务

主要能力

该工作流由五个阶段组成，每个阶段由不同的子代理（agent）执行：

1. phoenix：分析当前代码，识别改进点，输出分析报告。
2. plan-agent：创建安全的重构计划，输出分步计划。
3. kraken：实现重构，输出代码变更。
4. plan-reviewer：审查变更的正确性，输出审查报告。
5. arbiter：验证所有测试仍然通过，输出测试报告。

工作流概览：

phoenix → plan-agent → kraken → plan-reviewer → arbiter
分析      计划         实现      审查            验证

重构原则

• 测试优先：重构前确保有足够的测试覆盖。
• 小步前进：每次变更都应可独立验证。
• 保持行为：重构期间不改变功能行为。
• 可审查：变更应易于审查。

使用方式

通过 /refactor 命令触发工作流。各阶段通过 Task 调用子代理执行，示例：

阶段 1：分析

Task(
  subagent_type="phoenix",
  prompt="""
  Analyze for refactoring: [TARGET_CODE]

  Identify:
  - Current pain points
  - Code smells
  - Improvement opportunities
  - Risk areas
  - Test coverage gaps
  """
)

阶段 2：计划

Task(
  subagent_type="plan-agent",
  prompt="""
  Plan refactoring: [TARGET_CODE]

  Analysis: [from phoenix]

  Create:
  - Step-by-step refactoring plan
  - Each step should be:
    - Small and focused
    - Independently testable
    - Reversible
  - Identify files affected
  - Risk mitigation strategy
  """
)

阶段 3：实现

Task(
  subagent_type="kraken",
  prompt="""
  Implement refactoring: [TARGET_CODE]

  Plan: [from plan-agent]

  Requirements:
  - Follow plan exactly
  - Run tests after each step
  - Stop if tests fail
  - NO behavior changes
  """
)

阶段 4：审查

Task(
  subagent_type="plan-reviewer",
  prompt="""
  Review refactoring: [TARGET_CODE]

  Changes: [git diff from kraken]

  Check:
  - Behavior preserved
  - No unintended changes
  - Code quality improved
  - Patterns consistent
  """
)

阶段 5：验证

Task(
  subagent_type="arbiter",
  prompt="""
  Validate refactoring: [TARGET_CODE]

  - Run full test suite
  - Verify no regressions
  - Check type errors
  - Run linting
  """
)

重构类型

• 提取模块：phoenix → plan-agent → kraken → plan-reviewer → arbiter
• 重命名/重构结构：phoenix → kraken → arbiter（更简单，跳过详细计划）
• 架构变更：phoenix → plan-agent → [kraken → plan-reviewer] × N 个阶段 → arbiter

示例

用户：/refactor Extract the validation logic into a separate module

Claude：启动 /refactor 工作流……

阶段 1：分析当前结构…… [启动 phoenix] 发现：验证逻辑分散在 4 个文件中

• form.ts（第 45-120 行）
• api.ts（第 200-280 行）
• user.ts（第 15-45 行）
• order.ts（第 88-130 行）

阶段 2：计划提取…… [启动 plan-agent] 计划：

1. 创建 src/validation/index.ts
2. 提取通用验证器
3. 逐个文件更新导入
4. 每次变更后运行测试

阶段 3：实现中…… [启动 kraken] 完成全部 4 步，每步后测试均通过

阶段 4：审查变更…… [启动 plan-reviewer] ✅ 所有行为保持不变 ✅ DRY 改进（移除 45 行重复代码） ✅ 新结构一致

阶段 5：最终验证…… [启动 arbiter] ✅ 312 个测试通过，0 个回归

重构完成！

安全标志

• --dry-run：只计划，不实现
• --step-by-step：每次变更后暂停等待批准
• --coverage-check：要求覆盖率超过 80% 才继续

限制

资料中未提供关于收费、价格、平台支持范围、具体性能效果等方面的信息。