用途：该技能适用于任何技术问题的排查，包括失败的 vitest 或 pytest 测试、FastAPI 接口错误（500、422、401、403）、React 组件渲染问题、TypeScript 类型错误、Docker 或 PostgreSQL 连接失败、LangGraph 智能体异常行为、CI/CD 流水线失败以及性能退化。核心铁律是：在完成根因调查前不得提出修复方案。
四阶段流程：第一阶段为根因调查，要求仔细阅读错误信息与堆栈、稳定复现问题、用 git diff HEAD~1、git log --oneline -10、git stash && pnpm turbo run test 检查近期改动，并在多组件系统中于各边界加日志收集证据，再沿调用栈追溯数据流，定位源头而非症状。第二阶段为模式分析，在代码库中搜索可用示例（如 grep -r "similar_function" apps/backend --include=".py"、grep -r "SimilarComponent" apps/web --include=".tsx"），完整阅读参考实现，列出所有差异，并确认环境变量与 Docker 服务依赖。第三阶段为假设与验证，提出单一具体假设，每次只改一个变量做最小化测试，失败则换新假设而非叠加修复。第四阶段为实现，先用 tdd 技能写复现缺陷的失败测试（如 pnpm test --filter=web、cd apps/backend && uv run pytest tests/unit/test_specific.py -v），再针对根因做单一修复，最后用 pnpm turbo run test 跑全量测试确认无回归。
熔断机制：第一次失败返回第一阶段补充信息，第二次失败返回第一阶段并增加仪表，第三次失败必须停止，转而质疑架构，先与人类伙伴讨论，不得在未讨论前尝试第四次修复。若多次修复各自暴露不同位置的新耦合或共享状态，通常意味着架构本身有问题。
危险信号：出现“先快速修复稍后调查”“试试改 X 看行不行”“大概就是 X”等想法时应立即返回第一阶段。该技能与 bug-hunter 智能体集成，并引用 tdd、verification-before-completion、execution-guardian 等关联技能。限制与收费方式暂未提供。