agent-Specialization/workflows/bug-fix-triage/WORKFLOW.md

86 lines
2.5 KiB
Markdown

---
name: bug-fix-triage
description: 缺陷分诊修复流程:复现确认、按严重程度三向分流、热修/常规双轨、统一回归把关
review_mode: active
max_stage_rounds: 30
end_conditions: 修复通过回归审核且更新日志落盘;或分诊为不跟进直接归档
nodes:
- id: start-1
kind: start
name: 开始
next: reproduce
- id: reproduce
kind: stage
name: 复现确认
goal: 稳定复现缺陷并确认影响面
instructions: 记录复现步骤与环境;无法复现的缺陷退回报告人补充信息。
next: severity-branch
- id: severity-branch
kind: branch
name: 严重程度分诊
next:
- target: hotfix
condition: 线上崩溃、数据丢失或安全漏洞,必须立即修复
- target: fix
condition: 功能异常但存在变通方法,随正常节奏修复
- target: end-1
condition: 影响极低、无法复现或重复反馈,记录后不再跟进
- id: hotfix
kind: stage
name: 紧急热修
goal: 以最小改动止血
instructions: 只修阻断点,不做顺手重构;附带最小复现用例验证。
next: hotfix-gate
- id: hotfix-gate
kind: review
name: 热修审核
prompt: 热修是否最小化且无副作用,复现用例是否真实跑过
next: merge
reject_to: hotfix
max_rejects: 2
- id: fix
kind: stage
name: 常规修复
goal: 根治缺陷并补齐防护
instructions: 定位根因后修复;必须补回归测试覆盖该缺陷路径。
next: fix-gate
- id: fix-gate
kind: review
name: 修复审核
prompt: 是否根治而非掩盖症状,回归测试是否真实运行过
next: merge
reject_to: fix
max_rejects: 3
- id: merge
kind: branch
name: 汇总
next:
- target: regress-gate
condition: ''
- id: regress-gate
kind: review
name: 回归审核
prompt: 整体回归是否通过,修复是否引入新问题
next: document
reject_to: severity-branch
max_rejects: 2
- id: document
kind: stage
name: 更新日志
goal: 记录缺陷根因与修复内容
instructions: 写入更新日志;标注受影响版本范围。
next: end-1
- id: end-1
kind: end
name: 结束
---
## 工作方式
先复现再分诊,按严重程度走对应修复轨道。
## 验证方式
热修必须有最小复现用例;常规修复必须补回归测试。
## 结束方式
回归审核通过后更新更新日志并归档。