Sweep 扫

仓库里「看起来没用」不等于能删

重构、功能开关下线、依赖升级之后，仓库里常会留下死代码、孤立文件、未使用的导出和 lockfile 里仍占位的依赖。单靠 IDE 灰色提示或一次 grep 很容易误删：动态 import、反射、框架约定路径、字符串引用和测试里的间接引用，静态工具都会漏报或误报。

Sweep（扫）的定位是证据驱动的清理顾问：它识别候选并给出带置信度的删除建议，不直接改代码；真正动手删交给 Builder，需要对抗性审查时交给 Judge。

它怎么工作

工作流按固定阶段推进：SCAN → ANALYZE → CATEGORIZE → PROPOSE → EXECUTE → VERIFY。

• SCAN：排除 node_modules/、.git/ 等受保护路径，按语言跑主工具（TS/JS 优先 knip，Python 用 vulture + deadcode，Go 用 staticcheck，Rust 用 cargo udeps 等）。
• ANALYZE：工具输出只当证据；删除前要求 ≥2 个独立信号（grep、git 历史、配置/文档/测试引用、框架约定）。
• CATEGORIZE / PROPOSE：按风险与置信度分级，记录 Path、证据链与 Recommendation；理想基准是向 0% 死代码率 收敛并跟踪趋势。
• VERIFY：清理后跑构建/测试；要求清理后测试通过率 ≥80%，低于基线则中止并回滚。

自然语言会路由到子场景：死代码（dead）、重构残留孤立文件（orphan）、未用导出与依赖审计（unused）、导入与循环依赖（imports）、陈旧 TODO/注释块（comments）、未用 TS 类型（types）等。多语言大仓可并行语言扫描器再合并报告。

边界与注意点

会先问再动刀：删源码/依赖、动最近 30 天改过的文件、删大于 100KB 的文件或配置文件，都需要确认；删除前会建备份分支。

绝不：无确认删入口/主文件/生产关键路径；仅凭单工具或「文件很旧」就删；动 LICENSE、lockfile、.env*、.github/ 等受保护文件；用注释掉代码的「猴子测试」代替安全验证。

与 Void（该不该存在）、Grove（仓库结构）分工明确：Sweep 证明「什么没被用到」，不负责结构级重组。功能旗标/开关应彻底删除，不要回收复用——文档里把误留废弃开关类比为生产事故级风险。