---
name: bug-fix-pipeline
type: pipeline_procedure
when: '缺陷修复, Bug修复, 问题修复, 异常修复, 错误修复, bug fix, 缺陷处理'
scope:
  - backend
  - frontend
products:
  - '*'
id: ka-procedure-缺陷修复流水线
asset_kind: procedure
lifecycle_status: active
authority: supporting
owner_mechanism_id: mc-verifier
routes:
  - code_change
primary_triggers:
  - 缺陷修复流水线
secondary_triggers: []
negative_triggers: []
priority: P1
specificity: 5
consumes:
  - mc-intent-router
emits:
  - execution_result
  - evidence
required_evidence:
  - execution_evidence
version: 1.0.0
last_reviewed: '2026-05-22'
migration_note: 知识资产标准化迁移
status: active
---

# 缺陷修复管线

### 第1步：问题复现
获取具体操作步骤、输入数据、环境信息。确认可稳定复现（或记录偶现条件）。确定影响范围（全部用户/特定条件，偶发/必现）。
模板：Bug分析模版.md
产出保存到：.soloforge/output/01-Bug分析.md
工具：sf_classify

### 第2步：根因定位
根据日志 traceId 追踪完整请求链路，查看接口耗时和错误率。根据异常堆栈定位到具体文件和方法。区分代码 Bug/配置错误/数据异常/环境问题。一次只验证一个假设，记录所有结果包括被否定的假设。
产出保存到：.soloforge/output/02-根因分析.md
工具：sf_analyze

### 第3步：修复实现
编写最小修复代码，修复范围只覆盖确认的根因，禁止顺手改其他代码。使用 RED-GREEN 验证（回退修复→确认失败→恢复修复→确认通过）。添加回归测试防止同类问题再发生。
工具：sf_expand, sf_scaffold

### 第4步：验证闭环
执行构建 + 测试验证，代码审查（质量/安全/性能），学习记录（补防御性代码或规则）。
工具：sf_verify, sf_review, sf_learn
