# Bug Fixer

> 在维护路线中根据报错、失败测试、审查意见或可复现现象定位并修复软件缺陷。用于恢复已经明确的预期行为；如果正确行为不清或修复需要改变产品契约，停止并升级到 product-spec-builder 的产品变更模式。

- Skill: `arctan303/bug-fixer` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add arctan303/bug-fixer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arctan303/bug-fixer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: arctan303 (https://skillmd.com/u/arctan303)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/arctan303/bug-fixer

---


# 缺陷修复技能 (bug-fixer)

## Purpose

用可复现证据定位根因并恢复已经明确的预期行为。不要靠猜测修复，也不要把新的产品决策伪装成 Bug。

## Trigger

- 报错、失败测试、审查意见或稳定复现步骤表明既有行为失效。
- 正确行为能由 Product Spec、公开接口、历史行为、测试或用户确认确定。
- 仅改变内部实现且不新增能力、不改变外部契约。

正确行为不清、证据互相矛盾或需要改变公开行为时，不触发本技能，转交 `product-spec-builder`。

## Required context

- 预期行为及来源。
- 实际现象、复现步骤、日志或失败测试。
- 范围、非目标、完成证据和 R0/R1/R2。
- 相关代码、历史变更和当前验证入口。

缺少复现条件时，先形成最小诊断假设；无法验证任何假设则停止。

## Workflow

1. 复现问题，区分已证实事实、合理推断和未知项。
2. 一次验证一个根因假设，找到最小充分证据链。
3. 实施最小完整修复，不用大重构掩盖未知根因。
4. 复跑原失败证据，并补充与风险相称的回归检查。
5. 范围改变时更新相关契约，按具体影响重新评级；只有 R2 才自动要求 fresh reviewer，路线升级不自动等于 R2。
6. 修复后同步受影响现状、命令与任务状态，不引用已失效的历史决定。

## Output

- 根因与证据。
- 修改文件和修复说明。
- 原问题验证、回归结果、失败或跳过项。
- 风险级别、残余风险和 reviewer 结论（如适用）。

## Stop or escalate

- 正确行为需要用户或产品决策：升级为产品变更。
- 唯一方案会改变公开 API、数据、权限、业务流程或兼容性：升级为产品变更。
- 只能通过吞错、禁用检查或扩大范围隐藏问题：停止。
- 没有可复现或可替代验证证据：标记阻塞，不声明已修复。

## References

执行前读取 [stage-contract.md](references/stage-contract.md)。