SuperAPI AI 工具集

diagnose

编程与开发

查看项目

更新于 10-16 05:04

技能介绍

用途:该技能是处理困难缺陷与回归问题的诊断纪律,核心价值在于顺序——先建立紧凑的通过/失败信号(反馈回路),再提出假设,而不是反过来。适用于某处损坏、抛错、失败、变慢,或用户报告可复现的问题等场景。它改编自 mattpocock/skills 的 diagnosing-bugs(MIT © 2026 Matt Pocock)。

主要能力:入口关卡要求先有按需触发的失败信号(失败的测试、脚本、CI 产物或可运行的用户复现),否则停止,不进行假设;转而向用户索取复现(环境、步骤、产物),或在线索不明时先调查。协议分三阶段:第一阶段建立紧凑反馈回路,尝试不同构造直到回路对该缺陷呈红色;持续收紧回路,使其更快、信号更锐利(断言具体症状而非仅“未崩溃”)、更确定(固定时间、随机种子、隔离文件系统与网络)。完成标准是能说出一个已运行过的命令,具备红信号能力、确定性、速度快。第二阶段在回路为红的前提下修复,只有第一阶段完成后才改动生产代码;fail-to-pass 测试是诊断工具而非补丁规范。第三阶段锁定回归,把回路交给 tdd 转成保留的回归测试,必要时参考 codebase-design.md 和 code-review 做结构清理。

使用方式:按 output-schema.md 输出,结尾包含 Diagnosis 段,列出 Symptom、Loop(一条命令及红/绿、确定性、快速)、Cause、Fix、Regression lock、What to do next。可根据 references/research-basis.md 校准动作,但不要习惯性加载。项目特定注入上下文会在读取技能时附加,不要就地编辑同步副本。

限制:若确实无法建立回路,需明确说明并列出尝试过的内容,请求环境访问、捕获产物或临时插桩许可,不得继续假设。只有明确论证时才可跳过阶段。收费、价格、平台与效果等细节暂未提供。