SuperAPI AI 工具集

deslop

编程与开发

查看项目

更新于 10-16 04:24

技能介绍

用途

deslop 用于从代码分支中移除“AI 风格代码垃圾”(AI-style code slop)。当被要求执行以下操作时使用:

  • “remove AI slop”(移除 AI slop)
  • “clean up generated code style”(清理生成代码风格)
  • “review branch diff for weird comments/defensive checks/casts”(审查分支 diff 中奇怪的注释/防御性检查/类型转换)

主要能力

  • 审查 git diff,识别新增代码中的候选 slop。
  • 删除不一致的防御性噪音、多余注释、类型转换、lint 忽略、占位符和调试残留。
  • 在完整文件上下文中审查每个候选,并与邻近本地模式比较。
  • 仅删除不一致的 slop,保留行为与领域有效的守卫。
  • 重新运行项目检查并修复回归。
  • 报告具体改动文件,以及删除了哪些 slop、有意保留了哪些。

使用方式

工作流程:

  1. 设定比较基准(默认 main),检查 git diff <base>...HEAD。
  2. 使用 rg 在新增行中构建候选列表(注释、catch、类型转换、lint 忽略、占位符、调试残留)。
  3. 在完整文件上下文中审查每个候选,并与邻近本地模式比较。
  4. 仅删除不一致的 slop;保留行为与领域有效的守卫。
  5. 重新运行项目检查(bun check、bun typecheck)并修复回归。
  6. 报告具体改动文件,以及删除了哪些 slop、有意保留了哪些。

Slop 检查清单:阅读并应用 references/slop-heuristics.md。

适用场景

  • 清理由 AI 生成或辅助生成的代码分支。
  • 审查分支 diff 中不自然的注释、防御性检查或类型转换。
  • 在合并前统一代码风格,去除生成代码带来的噪音。

限制与护栏

  • 不要删除信任边界(用户输入、认证、网络、数据库、文件 I/O)处的保护。
  • 不要用更弱的类型替代真实类型。
  • 优先最小编辑,而非大范围重写。
  • 保持项目约定(hooks/query 风格、组件模式、命名)。