关于 deslop
deslop 是用于清理当前变更中 AI 生成代码冗余的 Skill,面向审查和精简代码差异的开发流程。它检查防御性冗余、宽泛类型规避和过度抽象等问题,同时要求保持行为并运行类型检查与测试。
主要功能
- 01检查当前变更中的代码差异
- 02移除不必要的防御性检查与兜底
- 03清理绕过类型检查的宽泛类型
- 04简化可用提前返回处理的嵌套逻辑
- 05删除缺乏实际需要的抽象
适用场景
- 01审查 AI 生成的代码变更
- 02精简不必要的类型断言和抑制注释
- 03减少提交中的过度防御逻辑
- 04修改后运行类型检查与测试
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ riffingonsoftware/ agent-skills --skill deslop安装后在 Claude Code 中输入/deslop确认已加载。
附带文件LICENSE
详细介绍
移除 AI 生成的冗余代码
移除此次更改中引入的 AI 生成冗余代码。使用调用方提供的 diff;否则,使用相对于基准分支的 diff,包括已暂存、未暂存和未跟踪的文件。完成后,确保已移除更改中每个重点领域的实例,或因防护要求而保留。
重点领域
- 在受信任的代码路径中不合常理的防御性检查、
try/catch块或回退默认值,或会掩盖错误的此类代码 - 仅用于绕过类型问题的
any类型转换(或类似语言中特别宽泛的类型),以及达到相同目的、更隐蔽的规避方式(如as unknown as T、抑制注释) - 本可通过提前返回简化的深层嵌套代码
- 过度推测的通用设计:只有一个实现的接口、无人设置的选项、始终传入相同值的参数、仅做转发的包装器
- 为代码库中已有名称的事物另取的名称
防护要求
- 除非是在修复明确的错误,否则保持行为不变。
- 只有在能确证冗余,或移除后能修复错误时才删除防护。保留信任边界上的验证,以及可防止数据丢失的错误处理。
- 优先进行最小且聚焦的修改,避免大范围重写。
- 编辑后运行项目的类型检查和测试。
- 最终总结保持简洁(1–3 句)。
评论
支持 Markdown