---
name: refactor-pipeline
type: pipeline_procedure
when: '代码重构, 模块拆分, 模式优化, 提取公共方法, 重构, refactor, 代码改善, 结构优化'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-procedure-重构流水线
asset_kind: pipeline_procedure
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-task-context-lifecycle
routes:
  - code_change
primary_triggers:
  - 重构流水线
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-task-context-lifecycle
emits:
  - refactoring_analysis
  - refactoring_plan
  - refactoring_result
required_evidence:
  - execution_evidence
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["编码与单元测试", "联调验证"]
---

# 重构管线

### 第1步：现状分析
识别当前代码的坏味道和重构目标。量化现状（圈复杂度、方法行数、类职责数）。确定重构类型（提取方法/提取类/内联/重命名/搬移/模式替换）。
模版：重构方案模版.md
产出保存到：.soloforge/output/01-重构分析.md
工具：sf_classify, sf_analyze

### 第2步：方案设计
定义重构目标和 Before/After 对比。评估影响范围（哪些模块/接口/测试受影响）。识别风险点（破坏性变更风险等级、回归风险）。制定分步执行计划（每步可独立验证）。
产出保存到：.soloforge/output/02-重构方案.md

### 第3步：分步实施
按计划逐步执行重构，每步完成后运行测试确认无回归。禁止一次改多步再验证。保持测试始终可通过（绿色），如需修改测试先确认测试本身正确。
工具：sf_expand

### 第4步：验证验收
执行全量构建和测试。代码审查重点关注：行为等价性（重构不改变外部行为）、接口兼容性、性能影响。学习记录（重构模式、发现的设计问题）。
工具：sf_verify, sf_review, sf_learn
