用途:把代码中的弱类型逃逸口替换为可从实际用法推断的强类型,逐处验证,破坏编译即回滚,对公共 API 保守。
主要能力:预处理检查语言(TypeScript/JavaScript 的 any、unknown、as unknown as、Function、Object,Python 的 Any 与缺失类型提示,Go 的 interface{} 与 any,Rust 的 Box<dyn Trait>);检查 Git 工作区是否干净(脏则拒绝);读取项目约定(package.json 的 check:weak-types 脚本、tsconfig 的 strict/noImplicitAny、mypy 配置);读取并尊重允许弱类型的白名单文件。检测阶段用 grep 与编译器/类型检查器找弱类型,例如 npx tsc --noImplicitAny --noEmit、mypy --disallow-untyped-defs、go build、cargo check。评估阶段生成 .claude/cleanup-reports 报告,按 HIGH/MEDIUM/LOW 分级。执行阶段只自动修复 HIGH,且一次一处、每处之间跑类型检查;失败则 git checkout 回滚并降级为 MEDIUM。最后统一提交并运行全仓库类型检查与测试。
适用场景:内部/私有函数的弱类型清理;同一仓库内调用方类型一致、可机械推断的改动。
限制:公共 API、SDK 导出、泛型化改造、as unknown as 转换只报告不自动改;边界代码(HTTP 请求体、JSON.parse、动态配置)、第三方 shim、测试文件通常保留。禁止批量把 any 换成 unknown、禁止加 @ts-ignore 或 # type: ignore、禁止改生成类型与第三方 .d.ts、禁止自动给公共 API 加泛型。