用途：clean-codebase 用于清理代码库的卫生债务，包括堆积的 lint 警告、未使用的导入与变量、从未删除的死代码路径、不一致的格式，以及静态分析工具报告的可修复问题。它明确不用于架构重构、缺陷修复或业务逻辑变更。
主要能力：按流程执行预清理评估（统计 lint 警告与代码行数）、自动修复 lint 警告、识别死代码路径、移除未使用导入、按模式删除死代码、统一格式、运行测试并生成清理报告。支持 JavaScript/TypeScript、Python、R、Rust 等语言，使用 eslint、prettier、black、isort、ruff、styler、cargo fmt、cargo clippy、ts-prune、depcheck、vulture、autoflake 等工具。
使用方式：输入参数包括 codebase_path（必填，代码库根目录绝对路径）、language（必填，主语言）、cleanup_mode（可选，safe 默认或 aggressive）、run_tests（可选，默认 true）、backup（可选，默认 true）。流程为：预清理评估、自动修复 lint、识别死代码、移除未使用导入、按模式删除死代码、统一格式、运行测试、生成 CLEANUP_REPORT.md。safe 模式仅删除明确标记为废弃的代码、超过 10 行且超过 6 个月的注释代码块、引用已完成 issue 的 TODO；aggressive 模式删除所有未使用函数、零引用私有方法、废弃功能的特性开关。
适用场景：快速开发后 lint 警告堆积、未使用导入与变量杂乱、存在死代码路径、格式不一致、静态分析报告可修复问题。
限制与注意事项：静态分析可能漏掉通过反射、eval 或元编程的动态调用；移除导入可能破坏隐式依赖；删除特性开关可能影响其他环境；格式化工具可能产生不必要 diff；测试覆盖率低时无法安全清理；删除前必须备份。验证清单要求测试通过、无新增 lint 警告、已创建备份、CLEANUP_LOG.md 记录所有删除、生成清理报告、审查 git diff、CI 通过。相关技能包括 tidy-project-structure、repair-broken-references、escalate-issues、r-packages/run-r-cmd-check、devops/dependency-audit。