systematic-debugging

用途：遇到任何技术问题时使用，包括测试失败、生产环境 bug、异常行为、性能问题、构建失败与集成问题；在时间紧迫、想直接“快速修复”、已多次尝试修复或尚未完全理解问题时尤其适用。主要能力：以“无根因调查不得修复”为铁律，要求依次完成四个阶段。阶段一为根因调查：仔细阅读错误与堆栈、稳定复现、检查近期变更（git diff、提交、依赖与配置），并在多组件系统（如 CI→构建→签名、API→服务→数据库）中先加入诊断埋点，记录各组件边界的数据进出与环境配置，运行一次定位失败层，再顺着数据流向上追溯来源。阶段二为模式分析：寻找同类可用示例，完整阅读参考实现，列出工作与故障版本之间的全部差异，理解依赖、配置与环境假设。阶段三为假设与测试：提出单一明确假设，最小化改动、每次只变一个变量，验证后再继续；失败则重新提出假设，而非叠加修复。阶段四为实现：先写出可失败的最小测试（可使用 superpowers-extended-cc:test-driven-development），针对根因做单一修改，再验证测试通过且无其他破坏。若修复连续失败三次以上，应停止并质疑架构，与人类伙伴讨论。限制与说明：资料提供了一些支持技术文件（root-cause-tracing.md、defense-in-depth.md、condition-based-waiting.md）与相关技能（verification-before-completion），但未提供安装命令、平台支持、收费信息与实际认证效果，这些信息暂未提供。该技能强调 95% 的“无根因”情况实为调查不完整。