codebase-sweep

用途：对代码库进行大规模质量清理，派出最多 8 个子代理并行审计并修复结构性问题。\n\n主要能力（子代理）：1 去重，所有语言，仅在降低复杂度时应用 DRY；2 类型合并，适用于 JS/TS、Java、C#、Go 等强类型语言；3 死代码清理，JS/TS 用 knip，其他语言用 grep 分析，删除前全库 grep 验证；4 循环依赖解决，JS/TS 用 madge --circular，禁止用懒加载掩盖；5 弱类型消除，替换 any/unknown 或补 Python 类型注解；6 防御性代码裁剪，移除隐藏错误的 try/catch，保留处理不可信输入的；7 废弃/遗留代码移除；8 AI slop 清除，去除占位符、进行中注释与过度注释。\n\n用法：先从 package.json、tsconfig.json、Cargo.toml、pyproject.toml、go.mod 等识别语言并决定适用子代理；确认测试运行器且测试通过，否则中止；创建分支 cleanup/<YYYY-MM-DD>；排除生成文件、node_modules、dist、vendor、锁文件与 .gitignore 路径。分两阶段执行：阶段 1 并行运行 1、2、5、6、7、8；阶段 2 在阶段 1 提交后并行运行 3、4。每个子代理独立提交，前缀 cleanup(<task>):；每次提交后跑测试，失败则回滚该提交并写入报告，不自动修复；触碰同一文件的子代理串行处理。禁止 --no-verify 或 force-push。\n\n适用场景：需要系统性清理的中大型代码库。超过约 200 个文件时建议限定到高活跃目录，可用 git log --format='%H' --since='3 months ago' -- <path> 找出高变更区域。\n\n限制：需先有可通过的测试；低置信度问题不自动修复，仅列给人工审查；具体安装与调用方式暂未提供。