用途 codeprobe-error-handling 是一个代码审查子技能,专门检测错误处理与系统韧性方面的问题。它既可以经由 codeprobe 编排器调用,也支持独立运行;独立运行时需先读取同级 codeprobe 技能目录下的 shared-preamble.md(输出契约、执行模式与约束),并根据项目技术栈加载 codeprobe/references/ 下的参考文件。默认使用 full 模式,除非用户另有指定。
主要能力 检测范围分为七类:
- 被吞掉的异常(ERR):空 catch 块、仅记录日志而不重抛或恢复、过于宽泛的异常捕获。
- 缺失错误处理:外部 API 调用未包裹 try/catch、未处理的 Promise 拒绝、文件 I/O 无错误处理。
- 错误信息:泛化错误消息、向 API 调用方泄露内部错误、缺少结构化错误响应。
- 重试与熔断:外部调用无超时、瞬时失败无重试、微服务调用无熔断或降级。
- 校验:处理前缺少输入校验、隐式 null 假设、类型强制转换缺陷(如 == 代替 ===)。
- 事务安全:多步数据库操作无事务、事务缺少正确回滚。
- 日志:关键失败路径无日志、缺少关联/请求 ID。 所有发现使用 ERR- 前缀顺序编号(ERR-001、ERR-002……),严重级别包括 Critical、Major、Minor、Suggestion。
明确不检测的内容 日志中的敏感数据(归 codeprobe-security 的 SEC 前缀负责);测试文件;框架生成的异常处理器(如 Laravel Handler.php、Next.js 错误边界等脚手架默认实现);CLI 脚本中刻意简单的错误处理(打印错误并以非零码退出);带注释说明原因、刻意吞掉已知无害异常的处理;以及本质属于安全漏洞的问题(由 codeprobe-security 负责,两者重复时由编排器去重并保留安全发现)。
使用方式 通过编排器调用,或独立运行并先读取 shared-preamble.md 和对应参考文件。技能会基于项目技术栈扫描代码,输出带编号的问题清单,并提供修复提示(fix prompt)示例,如为 Stripe 调用添加 try/catch 与领域异常、为订单创建流程添加 DB::transaction()、为 Guzzle 请求添加 timeout 与 retry 配置等。
适用场景 适合在代码审查、质量门禁或重构前对项目进行错误处理与韧性专项检查,尤其适用于包含外部服务集成、支付流程、多步数据库写入的代码库。
限制 具体支持的编程语言清单、命令行参数、输出格式细节和集成方式,资料未完整提供;不覆盖安全类问题与测试文件。