用途:debug-investigate 是调查专用技能,目标是把根因定位到拥有该不变量的最低层,并给出 file:line 证据,随后交给 $fix 修复,而不是在崩溃点打补丁。
主要能力:按缺陷类型分类(前端、后端、跨服务/消息总线、性能内存、安全鉴权、失败或偶发的集成测试)并路由到相应代理;对失败的集成测试先做故障裁定,输出 TEST-WRONG、TEST-NOT-OPTIMAL、SOURCE-WRONG、ENVIRONMENT 或 AMBIGUOUS 之一;复现症状并收集证据;提出 2-3 个排序假设;从终点到起点回溯调用链,枚举所有写入路径;用假设矩阵确认单一根因能解释全部症状;通过 $why-review 校验门后才宣布确认。
使用方式:按声明顺序执行各步骤,每步更新任务跟踪并给出证据;存在 graph.db 时用 python .claude/scripts/code_graph query callers_of <function> --json、importers_of、tests_for 以及 trace <suspect-file> --direction both --json 等命令做依赖追踪;结论需标注 Confidence: X% 与 file:line 证据,低于 60% 只能报告“假设,未确认”并列出证据缺口。修复后必须运行 $prove-fix。
适用场景:需要严谨根因分析的缺陷调查,尤其是跨服务、事件总线、性能内存和集成测试失败类问题。
限制:本技能只做调查,不在此处打补丁;不得削弱断言、加跳过或放宽超时来强行变绿;$why-review 两轮未通过须停止并直接询问用户;环境不支持某步骤时应先停下询问用户。资料未提供具体收费、平台支持范围与更多安装细节。