用途:删除没有实际作用的 try/catch 与防御性守卫,目标是让错误干净地传播到知道如何处理它的边界层,而不是用静默回退隐藏 bug。核心原则是:只有当你比默认传播能做得更有用时才捕获,而“记录日志并重新抛出”通常并不比直接抛出更有用。
主要能力:支持检测 TypeScript/JavaScript、Python、Go、Rust。先做预检,识别边界文件并保留其中捕获,包括 HTTP 请求处理器、CLI 入口、消息/队列消费者、测试文件。检测阶段用 grep 及 ESLint(no-useless-catch) 等命令收集 try/catch,并按内容分类:仅重抛、吞掉并返回 null/空值、仅记录日志、记录并重抛、有实质处理。评估后生成报告写到 .claude/cleanup-reports/cleanup-defensive-{YYYY-MM-DD}.md。
使用方式:自动移除仅限高置信项,如静默吞掉、无操作重抛、丢失栈的包装重抛、非边界文件的静默回退、Python 的 except: pass、Go 中被丢弃的 error。中置信只报告,如记录并重抛、带重试的捕获、中间件捕获、有意保留默认值的 unwrap_or。低置信必须保留,如边界文件内、导入期兼容回退、有意义的异常类型转换、配合 finally 做清理的捕获。执行时移除 try 包装并保留主体表达式;若签名因原有捕获而隐含“可能返回 null”,标记人工审阅但不自动改签名。提交信息为 chore(cleanup): cleanup-defensive — removed N useless try/catch blocks。
验证:运行 bun run check 或 npx tsc --noEmit && npx eslint .、bun test、pytest、go test ./...、cargo test。若测试失败,默认回退该处改动并降级为中置信,由人判断暴露出的失败是否为真实 bug。
限制:绝不删除请求处理器、路由、消息消费者或 CLI 入口处的捕获;不删带 finally 做清理的捕获;不删有语义的异常类型转换;不“修复”Go 的 if err != nil { return err };不擅自改 Rust unwrap 前置条件;不为让测试通过而修改错误处理。资料未提供收费、价格、平台和效果信息。