Peter Bugfix Loop

---

name: peter-bugfix-loop description: 代码缺陷修复闭环。聚焦“先复现、再定位、最小修复、同上下文补测试”，并衔接现有 Peter 门禁与 PR 收口流程。 version: 1.0.0

---

Peter Bugfix Loop

30 秒简介

用于“把一个 Bug 从问题描述推进到可合并修复”。

它聚焦 6 件事： 1. 建立可执行 Bug 卡 2. 先做最小复现（先红） 3. 假设驱动定位根因 4. 最小修复（控制 blast radius） 5. 同上下文补测试 6. 接入现有门禁与 PR 收口

适用场景

用户提到“修 bug”“定位回归”“线上缺陷修复”

CI 失败怀疑是代码问题而非偶发波动

希望把修复过程沉淀成可复用步骤

执行步骤

1. 建立 Bug 卡（最小输入）

记录：现象、期望行为、影响范围、复现入口。

必须写一条可验证验收句（示例：给定 A 输入，接口应返回 200；当前返回 500）。

2. 最小复现（先红）

优先新增最小失败测试用例。

暂时无法写测时，至少保留 CLI/HTTP/页面复现脚本与命令。

3. 假设驱动定位

先列出 2-3 个候选根因。

只读取与路径相关代码，避免未定位时大面积重构。

4. 最小修复

只改根因相关文件与必要调用链。

顺手重构拆到后续独立 PR。

5. 同上下文补测试

非纯 UI 微调，必须补自动化测试。

至少覆盖：触发条件、边界输入、错误分支。

6. 接入现有 Peter 流程

提交前审查：peter-code-review

提交建 PR：peter-commit-ops

CI 门禁：peter-ci-gate

PR 收口：peter-pr-ops

输出格式（固定）

1. ## Bug 修复报告 2. ### Bug 卡（现象 / 期望 / 影响范围 / 验收句） 3. ### 复现与根因（复现证据 / 候选根因 / 最终根因） 4. ### 修复与测试（改动文件 / 新增或更新测试 / 本地结果） 5. ### 门禁与收口（code-review 结论 / CI gate 状态 / PR 状态） 6. ### 结论（已修复可收口 / 需继续修复 / 阻塞）

护栏

禁止“未复现先改代码”。

禁止把“CI 重跑成功”当作根因修复。

默认原子提交，不混入无关重构。

发现高风险回归时，优先回滚（revert PR）再补回归测试。