用途:refactor-clean 用于安全识别并移除死代码,在每一步删除后都进行测试验证。它适合在 Codex 中清理未使用的导出、文件、依赖、辅助函数等。
主要能力:先建立基线,记录清理前测试是否已失败;用语言适配的工具检测死代码,如 npx knip、npx depcheck、npx ts-prune、vulture src/、deadcode ./...、cargo +nightly udeps;将发现分为 SAFE、CAUTION、DANGER 三级;每次只删除一个 SAFE 项并立即重跑验证;CAUTION 项需先排查间接使用;DANGER 项默认跳过,除非用户明确要求深入调查;死代码清理稳定后再合并明显重复项。
使用方式:按工作流执行。先跑最小基线,再跑仓库要求的更广检查。若目标区域基线为红,暂停并告知用户。删除时保持原子性,不批量混合无关删除。失败则仅恢复该项,保留无关用户改动。CAUTION 项删除前检查 import()/require()、配置与路由中的字符串引用、入口再导出、外部消费者、框架自动加载约定。
适用场景:清理未使用的内部工具、私有辅助函数、无调用者的包装函数、未使用测试辅助等。
限制:不删除前未跑基线验证;一次只删一项;不确定就跳过;不把大范围重构混入删除循环;CAUTION 或 DANGER 项残留时需明确说明残余风险。