用途:系统性清理代码库中的死代码、重复代码与过度抽象,在不破坏可用代码的前提下提升质量。
主要能力与五阶段流程:
- 死代码移除:检查未被使用的导入、无引用函数与类、未使用的异常类,以及无 TODO 说明或超过一个月的历史注释代码。删除前用 grep 全库搜索,覆盖主代码、脚本、测试与示例目录,并检查字符串引用与配置文件。
- 去重:对出现 3 次及以上的模式提取 helper,出现 2 次则保留,避免不必要的间接层。典型模式包括 provider 初始化、配置获取、nonce 管理、错误处理与校验逻辑。
- 简化:移除仅有一种实现的工厂、无逻辑的配置包装、单次使用的工具类与直通函数;保留定义了清晰接口的基类。
- 注释与 TODO 标准化:统一为 # TODO: 描述,移除无意义前缀,删除显而易见的注释,保留领域逻辑与“为什么”类注释,保留全部 docstring。
- 最终审查:运行测试、检查导入有效性,并输出删除行数、删除的函数/类数、提取的 helper 数与标准化的 TODO 数等统计。
使用方式:调用该命令后,先创建包含全部五阶段的待办列表,按顺序执行,每阶段完成后标记;批量修改前展示发现示例,对删除整个文件、移除公共 API、更改核心抽象请求确认;最后提供汇总统计。
限制与不修改内容:不重构可用的抽象、不移除类型提示、不删除良好 docstring、保留可能即将用到的基类与领域特有模式、除非明确损坏否则不改测试代码。资料未提供具体收费、平台支持或安装命令信息。