Bug修复工作流
入口交互
用户输入 /fix 后，读取 bugs/pending.csv 列出待修复bug
交互流程
- •读取
bugs/pending.csv - •AskUserQuestion 列出待修复bug让用户选择（by ID）
- •更新选中bug状态为
in_progress（整行更新，重写文件无空行） - •全自动执行八阶段
CSV 结构
pending.csv（QA 写入，RD 读取）
id,title,description,severity,reporter,created_at,status,related_dev
- •related_dev: 关联的开发任务目录名（如 用户积分-20260120143052）
archived.csv（RD 写入，QA 验收）
id,title,description,severity,reporter,created_at,root_cause,fix_plan,affected_scope,fix_report,fixed_at,fixed_by
八阶段流程
阶段1：分析Bug
- •解析bug描述
- •结合当前项目代码复现问题路径
- •输出：问题现象描述
阶段2：确定根因
- •定位具体文件、函数、行号
- •分析代码逻辑找出根本原因
- •输出：根因分析报告
阶段3：审核根因
- •AskUserQuestion 确认根因判断
- •用户确认后继续
阶段4：修复方案
- •基于现有架构设计修复方案
- •评估修复复杂度
- •输出：修复方案概要
阶段5：影响范围
- •列出受影响的模块/接口/组件
- •评估回归风险
- •输出：影响范围清单
阶段6：执行修复
- •⚠️ 执行前重新读取 CLAUDE.md 规范
- •分批修改（≤20行）
- •实时标记修复进度
阶段7：复测验证
- •Playwright 自动化验证或手动验证
- •确认问题已修复
- •输出：验证结果
阶段8：归档留痕
- •⚠️ 执行前重新读取 CLAUDE.md 规范
- •从 pending.csv 删除该行（重写文件，无空行）
- •整行数据+修复字段追加到 archived.csv
CSV 操作规范
- •删除行后必须重写整个文件，确保无空行
- •整行操作，禁止单独操作某列导致错位
- •移动到 archived 时完整复制原行所有字段后追加新字段
与 QA 联动
- •QA 提交 bug 到 pending.csv（生成唯一 ID: BUG-yyyymmdd-xxx）
- •RD 通过 /fix 选择 ID 执行修复
- •QA 查询 archived.csv 验收修复结果