---
name: 重构方案模版
when: '重构方案, 代码重构, 模块重构, 结构优化'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-artifact_template-重构方案模版
asset_kind: artifact_template
lifecycle_status: active
authority: supporting
routes:
  - '*'
primary_triggers:
  - 重构方案
  - 代码重构
  - 模块重构
  - 结构优化
priority: P2
specificity: 3
version: 1.0.0
last_reviewed: '2026-05-22'
consumes: []
emits:
  - acceptance_report
secondary_triggers: []
negative_triggers: []
type: acceptance_template
status: active
---

# 重构方案文档

## 1. 重构动机
- 当前问题（坏味道描述 + 量化数据）：
- 不重构的长期风险：

## 2. 重构目标
- 目标状态描述：
- 可衡量的改善指标（圈复杂度/行数/类数）：

## 3. Before/After 对比
### Before（当前结构）
- 类/方法职责描述
- 调用关系图
- 关键度量（行数、分支数）

### After（重构后结构）
- 类/方法职责描述
- 调用关系图
- 关键度量（预期行数、分支数）

## 4. 实施步骤
| 步骤 | 变更内容 | 可独立验证 | 回滚方式 |
|------|---------|-----------|---------|
| 1 | | | |
| 2 | | | |

## 5. 风险评估
- 影响范围（受影响的接口/模块/测试）：
- 行为等价性保障（如何确认不改变外部行为）：
- 回滚策略：

## 6. 质量保障检查
- [ ] 重构是否保持功能等价（有测试用例保障）
- [ ] 是否分阶段执行（可增量发布，每阶段独立验证）
- [ ] 是否有回滚方案（每阶段独立可回滚）
- [ ] 重构是否清理了遗留的待办占位和临时代码
- [ ] 重构后性能是否有回归测试（基准对比）
- [ ] 是否更新了相关文档和注释
