SuperAPI AI 工具集

investigate

测试与质量

查看项目

更新于 10-16 03:37

技能介绍

用途:为 bug、失败和异常行为提供系统化的根因查找流程。输入可选 $ARGUMENTS,包含问题描述或错误信息。

主要能力与步骤: 第一步特征化:收集错误信息、堆栈、测试输出、日志或用户描述,判定问题类型(运行时错误、测试失败、构建失败、类型错误、性能、异常行为),并建立复现命令与输出。 第二步隔离:用 git log、git blame 等做代码考古,必要时 git bisect;在上游依赖的 issue 中搜索错误特征;按类型缩小范围,并确认证据确由被测系统产生,警惕导入、种子、手工编辑或旧数据。 第三步假设:先核对失败行引用的每个路径、包、符号、资源是否可解析,再提出 2-4 个可证伪假设并排序。复杂问题(3+ 假设且非明显笔误/缺 import/语法错误)可并行派出 Subagent 调查,同时用 /consult-codex 咨询,之后 /evaluate-findings 评估结论。并行前应识别会重置共享外部资源(数据库、固定端口、缓存)的测试层并在提示中列为禁区;共享工作树与 git index 视为只读,HEAD 不变。 第四步验证:用 Grep、Read、git 命令、隔离测试、依赖版本检查、临时日志、一次性夹具等最小手段逐条验证假设;夹具用后删除,临时改动用 git diff -- <file> 确认还原。对外部或线上系统的写入须经 AskUserQuestion 明确批准。

迭代与升级:最多 2 个完整循环(假设→验证→学习→重复);仍无结论时经用户同意再升级 /consult-oracle。最终以文本输出 Investigation Report,包含问题、类型、根因、证据、建议修复、复现命令及假设验证结果。

限制:只诊断、不应用修复;若问题属环境(运行时版本、依赖未安装、OS 差异)应明确报告,可能无需代码修复;未声明的依赖属清单缺陷需作为代码修复报告;依赖内部问题应记录并建议变通方案而非直接修补依赖。