mcpField
D
deslop

deslop

github.com/rawkode-academy测试与质量3270 次安装4 天前更新
代码仓库

关于 deslop

用于检查当前 Git 分支变更中 AI 生成代码冗余内容的 Agent Skill,并在保留功能的前提下进行清理。重点检查多余注释、防御性过度设计、类型绕过和风格不一致。

主要功能

  1. 01检查分支差异
  2. 02识别冗余注释
  3. 03发现防御性过度设计
  4. 04识别类型绕过
  5. 05检查风格不一致

适用场景

  1. 01评审前清理生成的代码
  2. 02移除不必要的检查和注释
  3. 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. 清理

对于发现的每个问题:

  1. 阅读周围的上下文,了解文件现有的风格
  2. 在保留实际功能的前提下,移除或简化冗余代码
  3. 确保代码仍能正常工作
4. 报告

完成所有更改后,提供 1–3 句摘要,说明做了哪些更改。不要逐条列举所有更改,只需概括移除的冗余代码类型及大致数量。

输出示例:

移除了 12 条解释显而易见代码的不必要注释,以及 API 处理程序中 3 个冗余的 try/catch 块。此外,还清理了 2 处掩盖实际类型问题的 any 转换。

评论

支持 Markdown