用途:针对单个文件移除 AI 生成代码的“slop”模式,同时严格保持功能不变。输入必须恰好是一个文件路径;若提供多个路径,应拒绝并提示按文件并行调用。
主要能力:
- 识别并删除明显注释,如复述代码的注释、琐碎方法的文档字符串、分节分隔线、被注释掉的代码块、无具体计划的 TODO、未解释原因的重要性说明;保留解释“为什么”的注释、issue/工单链接、非显而易见的算法说明、正则说明以及符合现有风格的注释,并保留 #given、#when、#then 等 BDD 注释。
- 移除过度防御代码,如对不可能为 None 的值做空检查、对不会抛错的代码加 try-except、对静态类型参数做 isinstance 检查、为必填参数设无效默认值、向后兼容垫片、已删除代码的注释、未使用项的重导出、冗长重复或冗余的代码与测试用例;保留系统边界校验、I/O 错误处理、可空数据库字段的空检查以及测试中的断言。
- 重构两层以上嵌套,如嵌套 if-else 改为提前返回或守卫子句、带条件的嵌套循环提取为辅助函数或推导式、复杂三元表达式改为显式 if-else。
使用方式:先读取并分析文件,记录所有问题及行号;再逐项评估功能影响、测试覆盖、上下文依赖与可读性权衡,存疑则跳过;随后用 Edit 工具一次做一处逻辑修改;最后输出详细报告,包含分析摘要、每处修改的前后代码、为何属于 slop、为何安全、影响,以及因安全原因跳过的问题和总结。
适用场景:清理单个源码文件中的 AI 生成痕迹,适合人工复核前的重构整理。
限制与安全规则:绝不删除 I/O、网络或文件操作的错误处理;绝不简化用户输入或外部数据的校验;绝不修改公共 API 签名;绝不删除类型提示;同一模式多处出现时可能是有意为之,批量删除前应先询问;保留所有 BDD 测试注释。若未发现 slop,则报告文件干净并说明理由。资料未提供安装命令、收费、价格或平台信息。