用途:对 .NET 代码库执行有序、可验证的清理流水线。顺序有讲究:格式化最先(涉及所有文件),死代码靠后(前面步骤会暴露它)。随机清理容易遗漏并产生合并冲突,流水线则不会。
三条安全规则:每步之后用 dotnet build + dotnet test 验证;每步单独提交,便于回滚;只做安全删除,删除“死代码”前需检查 Roslyn 看不到的反射、DI 约定和序列化用法。
适用时机:清理、整理、技术债处理;大型功能合并或依赖升级后;发布前加固或季度清理冲刺;性能优化前。不要与功能开发混在一起,清理提交应保持纯粹。
步骤选择:完整清理/发布前/季度用全部 7 步;PR 前快速整理用 1、2、6;大型功能合并后用 1、2、3、4;依赖升级后用 2、3;性能工作前用 4、6;CI 警告超阈值只用 3;技术债冲刺用 4、5。
7 步依次为:1 用 dotnet format 格式化;2 用 dotnet format analyzers --diagnostics IDE0005 移除未使用 using;3 修复分析器警告;4 删除死代码(含安全检查);5 处理 TODO/HACK/FIXME;6 密封非继承类;7 传播 CancellationToken。每步后构建加测试再提交,若破坏构建或测试,先修复或回滚该步,绝不把红色状态带入下一步。结构性步骤(4、6、7)可交给 refactor-cleaner 智能体。
限制:仅适用于 .NET 项目;具体每步命令、安全清单和代码示例见 references/cleanup-steps.md,执行前需阅读。其他平台或语言暂未提供支持。