Bugfix / Refactor / Test 示例
前置条件
- 已经读过 Bugfix / Refactor / Test Runbook。
- 问题是小步维护，而不是需求探索。
- 验收方式已经存在。
示例卡片
| 项目 | 本例内容 |
|---|---|
| 任务类型 | 修复表单校验 bug，并补一条回归测试。 |
| 边界 | 只动表单校验逻辑和对应测试，不改整体交互设计。 |
| 执行入口 | 终端或 IDE 任选其一，但只保留一个主入口。 |
| 最终交付 | 根因说明、最小 patch、测试结果、剩余风险。 |
步骤
示例任务：修复一个表单校验 bug，并补一条回归测试。
- 先写清复现步骤、允许修改范围和本轮不要做什么。
- 让工具先解释根因，而不是直接生成一大段改动。
- 做最小修复，只处理触发 bug 的那一层逻辑。
- 补一条能锁定回归的测试，避免以后同类问题再出现。
- 运行测试并记录结果，再决定是否需要额外人工检查。
这个示例里最重要的判断
- 修复不是从“怎么改”开始，而是从“为什么坏”开始。
- 测试不是附带品，而是这次交付的一部分。
- 如果修复过程中暴露出更大的结构问题，本轮先记风险，不顺手做大。
验证
- bug 行为从失败变为通过。
- 新增测试能锁住这次修复。
- 没有顺手扩大结构改动。
- reviewer 能从结果里看出“修了什么”和“没修什么”。
如果这个示例开始失控
- 如果根因越来越 复杂，切回 Spec-First Runbook。
- 如果问题需要更长执行链，补看 OpenAI Codex 常见任务。
- 如果只是在平台里收口 review，再补 Issue / Jira -> Draft PR Runbook。
下一步
- 看 Bugfix / Refactor / Test Tooling。
- 如果经常越界，回到 Bugfix / Refactor / Test 风险与切换条件。
- 如果你在终端里执行，配合 Claude Code 常见任务。