SuperAPI AI 工具集

diagnose

编程与开发

查看项目

更新于 10-15 23:44

技能介绍

用途:面向严重错误和性能回归的规范诊断流程,核心是六阶段循环:构建反馈循环、重现、假设、检测、修复与回归测试、清理与事后分析。仅在明确合理时才跳过阶段。探索代码库时建议使用项目领域词汇表,并检查相关区域的 ADR。

主要能力:第一阶段强调先构建快速、确定性、可运行的通过/失败信号,方法包括失败测试、curl/HTTP 脚本、CLI 固定输入对比快照、无头浏览器脚本(Playwright/Puppeteer)、重放捕获的跟踪、一次性 harness、属性/fuzz 循环、二分法 harness、差异循环,最后才是 HITL bash 脚本(scripts/hitl-loop.template.sh)。随后迭代循环本身,追求更快、信号更清晰、更确定。对非确定性错误,目标是提高重现率而非干净重现。

使用方式:无法构建循环时应停止并明确说明,列出已尝试内容,向用户请求环境访问、捕获工件(HAR、日志转储、核心转储、录屏)或临时生产检测权限;没有循环不要进入假设阶段。重现阶段需确认失败模式与用户描述一致、可重复、已捕获确切症状。假设阶段生成 3-5 个可证伪的排序假设,并在测试前展示给用户。检测阶段每个探测对应一个预测,一次只改一个变量,优先调试器/REPL,日志加唯一前缀如 [DEBUG-a4f2];性能问题先建立基线测量再二分。修复阶段先写回归测试,但仅在存在正确接缝时;接缝太浅会带来虚假信心,缺失接缝本身即为发现。

限制与收尾:声明完成前需确认原始重现不再出现、回归测试通过或记录接缝缺失、删除所有调试标记、清理一次性原型,并在提交/PR 中说明结果正确的假设。若根因涉及架构问题,建议在修复后移交 /improve-codebase-architecture 技能。