SuperAPI AI 工具集

investigate

测试与质量

查看项目

更新于 10-15 17:32

技能介绍

用途:系统性调试。该技能强制 Iron Law 原则——未确认根因前不得修复,并以结构化调试报告记录完整证据链、最小修复与回归测试。

主要能力:五阶段流程。阶段1根因调查:复现缺陷、收集错误/日志/堆栈证据,输出 investigation-report.json。阶段2模式分析:在代码库搜索同类错误、模块或反模式,判断问题是孤立还是系统性。阶段3假设测试:基于证据提出至多3个假设,用只读方式验证;连续失败3次即停止并升级,附诊断转储。阶段4实现(门禁:需阶段3确认根因):做最小修复并添加回归测试。阶段5验证与报告:运行完整测试套件、检查回归,生成报告到 .workflow/.debug/。

使用方式:先执行 mkdir -p .workflow/.debug。阶段1至3可使用 ccw cli --tool gemini --mode analysis 做初始诊断、跨文件模式搜索与假设验证,均为只读模式,禁止写入调用。完成状态分为 DONE、DONE_WITH_CONCERNS、BLOCKED、NEEDS_CONTEXT。

适用场景:需要严谨定位缺陷根因、避免盲目改代码的调试任务。限制:最小修复优先,重构不属于调试;必须有可复现证据;缺少复现步骤或错误条件不明时应标记 NEEDS_CONTEXT。具体安装与费用信息暂未提供。