- name
- peter-bugfix-loop
- description
- 代码缺陷修复闭环。聚焦“先复现、再定位、最小修复、同上下文补测试”，并衔接现有 Peter 门禁与 PR 收口流程。
- version
- 1.0.0
Peter Bugfix Loop
30 秒简介
用于“把一个 Bug 从问题描述推进到可合并修复”。
它聚焦 6 件事：
- 建立可执行 Bug 卡
- 先做最小复现（先红）
- 假设驱动定位根因
- 最小修复（控制 blast radius）
- 同上下文补测试
- 接入现有门禁与 PR 收口
适用场景
- 用户提到“修 bug”“定位回归”“线上缺陷修复”
- CI 失败怀疑是代码问题而非偶发波动
- 希望把修复过程沉淀成可复用步骤
执行步骤
- 建立 Bug 卡（最小输入）
- 记录：现象、期望行为、影响范围、复现入口。
- 必须写一条可验证验收句（示例：
给定 A 输入，接口应返回 200；当前返回 500）。
- 最小复现（先红）
- 优先新增最小失败测试用例。
- 暂时无法写测时，至少保留 CLI/HTTP/页面复现脚本与命令。
- 假设驱动定位
- 先列出 2-3 个候选根因。
- 只读取与路径相关代码，避免未定位时大面积重构。
- 最小修复
- 只改根因相关文件与必要调用链。
- 顺手重构拆到后续独立 PR。
- 同上下文补测试
- 非纯 UI 微调，必须补自动化测试。
- 至少覆盖：触发条件、边界输入、错误分支。
- 接入现有 Peter 流程
- 提交前审查：
peter-code-review - 提交建 PR：
peter-commit-ops - CI 门禁：
peter-ci-gate - PR 收口：
peter-pr-ops
输出格式（固定）
## Bug 修复报告### Bug 卡（现象 / 期望 / 影响范围 / 验收句）### 复现与根因（复现证据 / 候选根因 / 最终根因）### 修复与测试（改动文件 / 新增或更新测试 / 本地结果）### 门禁与收口（code-review 结论 / CI gate 状态 / PR 状态）### 结论（已修复可收口/需继续修复/阻塞）
护栏
- 禁止“未复现先改代码”。
- 禁止把“CI 重跑成功”当作根因修复。
- 默认原子提交，不混入无关重构。
- 发现高风险回归时，优先回滚（revert PR）再补回归测试。