关于 deslop
用于检查当前 Git 分支变更中 AI 生成代码冗余内容的 Agent Skill,并在保留功能的前提下进行清理。重点检查多余注释、防御性过度设计、类型绕过和风格不一致。
主要功能
- 01检查分支差异
- 02识别冗余注释
- 03发现防御性过度设计
- 04识别类型绕过
- 05检查风格不一致
适用场景
- 01评审前清理生成的代码
- 02移除不必要的检查和注释
- 03使变更文件符合现有风格
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ rawkode-academy/ rawkode-academy --skill deslop安装后在 Claude Code 中输入/deslop确认已加载。
详细介绍
此技能用于识别并移除当前分支更改中由 AI 生成的冗余代码。
流程
1. 获取差异
运行 git diff main...HEAD,查看此分支引入的所有更改。
2. 分析每个有更改的文件
对于每个有更改的文件,查找以下 AI 冗余代码模式:
不必要的注释
- 解释显而易见代码的注释,人类通常不会添加这类注释
- 与文件其余注释风格不一致的注释
- 添加到简单内部函数上的 JSDoc 或文档字符串,而文件中其他此类函数没有这些注释
- 不具备可执行操作的
// TODO或// NOTE注释
防御性过度设计
- 内部代码路径中存在的 try/catch 块,而这些路径已在上游完成验证
- 对类型系统或调用上下文已保证存在的值进行 null/undefined 检查
- 永远不会用到的回退值
- 对类型已明确的参数进行类型守卫
类型变通
- 为绕过类型错误而转换为
any @ts-ignore或@ts-expect-error注释- 为满足编译器要求而使用过于宽泛的联合类型
风格不一致
- 与文件其余部分不同的命名约定
- 不同的格式模式(即使格式有效)
- 过多的空行或与文件风格不符的分组方式
- 留在生产代码中的 Console.log 语句
3. 清理
对于发现的每个问题:
- 阅读周围的上下文,了解文件现有的风格
- 在保留实际功能的前提下,移除或简化冗余代码
- 确保代码仍能正常工作
4. 报告
完成所有更改后,提供 1–3 句摘要,说明做了哪些更改。不要逐条列举所有更改,只需概括移除的冗余代码类型及大致数量。
输出示例:
移除了 12 条解释显而易见代码的不必要注释,以及 API 处理程序中 3 个冗余的 try/catch 块。此外,还清理了 2 处掩盖实际类型问题的
any转换。
评论
支持 Markdown