SuperAPI AI 工具集

diagnosing-bugs

编程与开发

查看项目

更新于 11-07 16:46

技能介绍

用途 本技能提供一套针对疑难缺陷和性能回归的诊断纪律,把“凭感觉读代码猜原因”改为“先建可自动运行的失败信号,再层层收敛”。只有在理由充分时才允许跳过阶段。

主要能力

  1. 反馈回路构建:优先构建能对该缺陷变红的通过/失败信号,方式包括失败测试(单元、集成、端到端)、对运行中开发服务器的 curl/HTTP 脚本、带固定输入的 CLI 调用并与已知良好快照比对、Playwright/Puppeteer 无头浏览器脚本、重放捕获的请求/负载/事件日志、一次性最小化测试装置、属性/模糊测试循环、二分查找装置、新旧版本或双配置的差分循环,最后才用 scripts/hitl-loop.template.sh 驱动人工点击的 HITL 脚本。
  2. 回路收紧:把回路当产品优化,使其更快(缓存初始化、缩小测试范围)、信号更锐利(断言具体症状而非“没崩”)、更确定(固定时间、设置随机种子、隔离文件系统、冻结网络)。
  3. 非确定性缺陷处理:目标不是干净复现而是提高复现率,可循环触发、并行、加压、收窄时间窗口、注入 sleep,直到达到可调试的复现率。
  4. 复现与最小化:确认失败模式与用户描述一致,裁剪输入、调用方、配置、数据与步骤,直到每个残留元素都是承重的。
  5. 假设生成:先给出 3–5 个排序假设,每个必须可证伪并写明预测,可先给用户看以利用其领域知识。
  6. 插桩:每个探针必须对应一个具体预测,一次只改一个变量;优先调试器/REPL,其次在区分假设的边界打定向日志,禁止“全量日志再 grep”。所有调试日志加唯一前缀(如 [DEBUG-a4f2])便于最后一次 grep 清除。性能回归分支先建基线测量(计时装置、performance.now()、分析器、查询计划)再二分,先测量后修复。
  7. 修复与回归测试:在存在正确接缝时先写回归测试并看它失败,再修复并看它通过,最后用第一阶段回路跑原始未最小化场景。若唯一接缝过浅,应把“架构无法锁定缺陷”本身作为发现记录下来。
  8. 清理:确认原始复现不再出现、回归测试通过(或记录接缝缺失)、用前缀 grep 清除全部调试插桩、删除一次性原型,并在 commit/PR 信息中写明最终正确的假设。

使用方式 用户说“diagnose”“debug this”,或报告某处损坏、抛错、失败、变慢时启用。探索代码库时读取 GLOSSARY.md(若存在)以建立模块心智模型,并查看所触及区域的 ADR。展示命令、输出与捕获产物前须先脱敏,用 <REDACTED> 替代密钥,并尽量基于环境变量构建回路,使凭据留在环境中。若脱敏后的输出不足以诊断,应明确说明并向用户索取。

适用场景 疑难缺陷定位、性能回归排查、间歇性/非确定性故障、需要结构化调试流程的工程任务。

限制 若确实无法构建回路,应停止并明确说明已尝试的方法,向用户索取可复现环境访问、脱敏后的捕获产物(HAR、日志转储、核心转储、带时间戳的录屏)或添加临时生产插桩的许可,不得在没有回路的情况下进入假设阶段。第一阶段完成标准是:能说出至少已运行过一次的具体命令(脚本路径、测试调用、curl),并展示其调用与脱敏输出,且该命令能对该缺陷变红、结果确定、耗时以秒计、可由智能体无人值守运行。没有可红命令不得进入第二阶段。