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