SuperAPI AI 工具集

debug

测试与质量

查看项目

更新于 10-15 22:38

技能介绍

用途:这是一个系统化调试技能,目标是定位缺陷根因、分类并给出建议解决方案,而非实现修复。它明确禁止编写修复代码或修改生产行为,修复交由用户或组合技能(如 /ship、/implement)完成。

主要能力:采用五阶段工作流——阶段1分类(按症状加载对应排查手册)、阶段2复现与理解、阶段3假设驱动调查、阶段4根因分类、阶段5报告与建议。支持两种运行模式:监督模式(默认,写诊断代码需先提议并等待批准)和无头模式(在已批准的动作类别内自由迭代)。动作分为观察、诊断、升级调查、实现四个层级,其中实现为硬边界,任何模式下都禁止。

使用方式:可通过 --headless 参数、检测到容器环境(/.dockerenv 或 CONTAINER=true)或用户在检查点明确授权进入无头模式。诊断代码包括临时日志、复现脚本、失败测试等;升级调查工具包括浏览器自动化(agent-browser、Playwright)、临时验证脚本、服务端可观测性等,在无头模式下受触发条件限制。

适用场景:本地开发中的构建失败、运行时异常、测试失败、回归、类型错误、偶发失败、静默失败、性能退化、配置/环境差异等缺陷排查。

限制:绝不实现修复;在未识别具体根因、未形成解释全部症状的假设、未通过至少一次诊断动作验证前,不得提出或尝试修复。临时日志须在交付前移除,复现脚本和失败测试应保留。具体安装命令、价格与平台支持资料暂未提供。