Bugs Are Annoying 是一个对抗式 QA 代码审计技能,适用于任意语言和代码库。其设计出发点是:AI IDE 倾向于生成“看起来完成了”的代码,但并不以“正确”为优化目标;该技能通过主动尝试破坏代码来弥补这一差距,而不是去确认代码能工作。
核心思路:把所有代码视为有罪待证。阅读构建型智能体产出代码时,默认问题不是“这看起来对吗”,而是“它会怎样出错,作者没想到什么”。这是对抗式检查,不是确认式检查,不能略读后直接放行,也不能因为某个类别“看起来没问题”就跳过。
触发时机:当用户提出“找 bug”“审计这段代码/代码库”“运行 bug hunter”“检查错误”“找缺陷”“检查这段代码有没有 bug”“这段代码靠谱吗”等请求,或任何要求深度正确性检查而非风格/可读性审查的场景。
使用流程(按顺序执行,不可跳过或合并为一次略读):
- 确定范围:用户指定文件或文件夹则以之为范围;否则先询问,确认是审计整个代码库、仅审计相对主分支变更的文件(git diff),还是特定区域。不要在未知规模代码库上静默猜测范围。范围内始终排除生成目录和依赖目录(node_modules、vendor、dist、build、.git)以及压缩/打包文件;锁文件默认排除,但在检查依赖问题时必须查看。
- 映射代码库:先识别入口点、整体数据流和调用关系,再开始查找问题。
- 静态逐行检查:完整阅读相关/变更文件,逐行对照缺陷分类表检查。
- 追踪关键数据路径:跨文件/函数边界跟踪数据从输入到输出的流动。
- 对抗式模拟:以敌意/边界输入在脑中执行代码,如 null、undefined、空字符串、空数组、零、负数、最大长度输入、重复调用、并发调用、畸形输入、缺失字段。
- 交叉引用检查:发现一个缺陷后,主动检查同样错误是否在其他地方重复出现。
- 严重程度分级:按既定定义对每项发现分类,不自行发明新的严重等级标签。
- 编写/更新 bugs.md:使用规定格式,这是审计的唯一输出,不在聊天中另作长篇总结,而是引导用户查看该文件。
缺陷分类表(语言无关,需逐类检查):逻辑错误(差一错误、条件反转、运算符优先级错误、布尔逻辑错误);空值/类型安全(未处理的 null/undefined、不安全类型转换、缺少可选链、错误假定类型);边界情况(空输入、零、负数、单元素与多元素集合、循环首末次迭代);错误处理(吞掉异常、易失败调用缺少 try/catch、捕获后不记录不上报、向上传播错误不当);并发/异步(竞态条件、未 await 的 Promise、过期闭包、组件/进程销毁后更新状态);安全(注入点、硬编码密钥、认证或权限绕过、不安全反序列化);资源泄漏(未关闭的文件句柄/流/连接、未移除的监听器或订阅);跨文件一致性(一处修改函数/类型/字段但其他调用点未更新);API/契约不匹配(调用方与被调用方在字段名、类型或必填参数上不一致);状态管理(本应不可变的状态被修改、派生状态过期、重复更新);死代码/不可达代码;性能问题(N+1 查询、可 O(n) 却用 O(n²)、不必要的重复计算或重渲染);依赖问题(过时或有漏洞的包版本、版本要求冲突、使用已弃用但仍可用的 API);文档/注释不匹配(注释或 docstring 与代码不符)。
适用场景:需要对代码进行深度正确性检查、找 bug、审计代码库或判断代码是否可靠的场合。限制:不用于风格或可读性审查;范围未明确时需先询问;大仓库无范围限制的“穷尽”审计可能导致上下文耗尽;不提供额外功能、平台支持或收费信息的资料。