用途：面向 AI 智能体（及开发者）的系统化调试流程技能，用于处理任意技术故障，如测试失败、生产环境缺陷、异常行为、性能问题、构建失败与集成问题。
核心原则：必须先找到根本原因再尝试修复，只治症状视为失败；用户资料将其表述为“铁律”——未完成第一阶段不得提出修复方案。
主要能力：
- 根因调查：仔细阅读错误信息与完整堆栈，记录行号、路径与错误码；稳定复现问题；检查近期改动（git diff、新依赖、配置与环境差异）。在多组件系统（如 CI→构建→签名、API→服务→数据库）中，先在每个组件边界添加诊断性日志，确认数据进入/流出与环境配置传递，跑一次定位失效层，再深入该组件。深层调用栈错误可用目录中的 root-cause-tracing.md 做反向追踪，改在源头而非症状处。
- 模式分析：在代码库中寻找相似的可运行示例，完整阅读参考实现，列出工作版与故障版之间的全部差异，弄清依赖、配置与环境假设。
- 假设与验证：形成单一明确假设并写下，做最小改动、一次只变一个变量，验证成功则进入第四阶段，失败则提出新假设，不在原修复上叠加。
- 实施：先建立失败测试用例（可用 superpowers:test-driven-development 技能），针对根因做单一修复，不做顺带重构，再验证测试通过与无其他测试被破坏。
限制与边界：若修复尝试达到 3 次仍失败，应停止并质疑架构，与人讨论后再动手；若调查后确认问题确为环境、时序或外部因素，需记录调查过程、采取重试/超时/错误提示等处理并补充监控日志。资料称约 95% 的“无根因”情况实为调查不充分。目录另附 defense-in-depth.md（根因定位后多层校验）与 condition-based-waiting.md（用条件轮询替代固定超时）等配套技术。
使用方式：该技能以可安装技能形式发布，具体安装命令与平台支持在资料中暂未提供。