用途：在遇到任何 bug、测试失败或异常行为时，先做根因调查再提修复方案。核心铁律是“未完成第一阶段根因调查，不得提出修复”。
主要能力：四阶段协议。第一阶段根因调查：仔细阅读完整错误信息与堆栈、稳定复现问题、用 git diff HEAD~1、git log --oneline -10、git stash && pnpm turbo run test 检查近期改动，在多组件系统中于各边界加日志收集证据，并沿调用栈向上追踪数据来源。第二阶段模式分析：用 grep 查找可工作的相似代码，完整阅读参考实现，列出所有差异，确认环境变量与 Docker 依赖。第三阶段假设与验证：提出单一具体假设，最小化改动逐一验证。第四阶段实现：先写失败测试（如 pnpm test --filter=web、cd apps/backend && uv run pytest tests/unit/test_specific.py -v），做单一修复，再用 pnpm turbo run test 验证无回归。
熔断机制：第 1、2 次修复失败返回第一阶段并补充信息或埋点；第 3 次失败必须停止，转入质疑架构，不得在未讨论架构前尝试第 4 次修复。
适用场景：vitest/pytest 失败、FastAPI 500/422/401/403、React 渲染问题、TypeScript 类型错误、Docker/PostgreSQL 连接失败、LangGraph 智能体异常、CI/CD 失败、性能回退；尤其适用于时间紧迫、看似“只需一处小改”、已多次尝试失败或尚未完全理解问题时。
限制与说明：该技能改编自 obra/superpowers（MIT），用于增强 bug-hunter 智能体，并建议配合 tdd、verification-before-completion、execution-guardian 使用。资料未提供安装命令、收费方式与平台支持信息。