用途
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、有意保留了哪些。
使用方式
工作流程:
- 设定比较基准(默认 main),检查
git diff <base>...HEAD。 - 使用 rg 在新增行中构建候选列表(注释、catch、类型转换、lint 忽略、占位符、调试残留)。
- 在完整文件上下文中审查每个候选,并与邻近本地模式比较。
- 仅删除不一致的 slop;保留行为与领域有效的守卫。
- 重新运行项目检查(
bun check、bun typecheck)并修复回归。 - 报告具体改动文件,以及删除了哪些 slop、有意保留了哪些。
Slop 检查清单:阅读并应用 references/slop-heuristics.md。
适用场景
- 清理由 AI 生成或辅助生成的代码分支。
- 审查分支 diff 中不自然的注释、防御性检查或类型转换。
- 在合并前统一代码风格,去除生成代码带来的噪音。
限制与护栏
- 不要删除信任边界(用户输入、认证、网络、数据库、文件 I/O)处的保护。
- 不要用更弱的类型替代真实类型。
- 优先最小编辑,而非大范围重写。
- 保持项目约定(hooks/query 风格、组件模式、命名)。