---
name: hotfix-pipeline
type: pipeline_procedure
when: '紧急修复管线, 紧急修复, 生产事故处理管线, P0管线, 热修复管线, hotfix pipeline, hotfix, 线上故障管线, 线上问题修复, 线上报错, 紧急上线, P0, P1, 事故修复, 止血'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-procedure-紧急修复流水线
asset_kind: pipeline_procedure
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-delivery-gate
routes:
  - code_change
primary_triggers:
  - 紧急修复流水线
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-delivery-gate
emits:
  - incident_report
  - hotfix_result
  - postmortem_report
required_evidence:
  - execution_evidence
version: 1.1.0
last_reviewed: '2026-06-01'
stages: ["联调验证"]
---

# 紧急修复管线

### 第1步：故障定位
确认问题影响范围和严重程度，通知相关干系人。评估止血方案（配置回滚/功能开关关闭/服务降级/版本回滚），执行止血操作。
产出保存到：.soloforge/output/01-故障定位.md
工具：sf_classify, sf_analyze

### 第2步：最小修复
从 main/release 分支拉取 hotfix 分支。编写最小修复代码（仅修复问题，不重构不优化），快速验证修复场景 + 回归核心功能。
工具：sf_expand, sf_verify

### 第3步：验证部署
合并到 main 和 release 分支，打 hotfix tag。部署到生产环境，验证修复效果，监控 30 分钟。
工具：sf_verify, sf_deliver

### 第4步：故障复盘
编写事故复盘（根因、影响范围、修复过程、暴露的监控盲区、后续改进项）。与 sf_learn 配合形成闭环。
模版：故障复盘模版.md
产出保存到：.soloforge/output/04-故障复盘.md
工具：sf_learn

### 第5步：验证与闭环
确认修复影响范围，评估是否需要数据修复脚本。修复代码必须包含回归测试，防止相同问题复现。修复后执行冒烟测试验证关键路径。修复上线后持续观察 1 小时监控，确认无副作用。修复完成后编写故障复盘（根因、影响、修复、预防措施）。

## 检查点
- [ ] 故障已止血，影响范围已控制
- [ ] 修复代码已合并并部署
- [ ] 影响范围已评估
- [ ] 修复包含回归测试
- [ ] 冒烟测试通过
- [ ] 故障复盘已编写

## 注意事项
- 止血优先于根因修复，先恢复服务再排查问题
- 紧急修复可以简化流程但不能跳过测试
- 修复后必须补齐完整测试用例和文档
- 同一问题重复出现必须升级处理（架构级修复）
