Agent Skills
返回列表
💻

AI 代码 De-Slop

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/brennerspear-deslop-100。

技能介绍

要解决什么问题

用 AI 辅助写代码或做大块生成后,分支里常常会多出与项目风格不一致的痕迹:冗长注释、catch 里吞掉一切、无意义的 as 强转、eslint-disable 堆砌、占位符和调试残留。这类「AI slop」不一定改坏行为,但会让 review 成本上升,也会让后续维护的人怀疑每一处 guard 是否都有理由。

本技能面向的是:你已经有一版 diff,想系统性地挑出并删掉多余油腻,同时别把真正的安全校验一起扫掉。

技能如何工作

默认以 main(或可指定的对比基线)为基准,用 git diff ...HEAD 看本次分支相对基线的变更。接着对新增行做候选扫描,常见信号包括:

  • 注释、try/catch、类型断言与 cast
  • lint 忽略指令、占位文本、调试输出残留

借助 rg 等工具拉出候选点后,会在完整文件上下文里逐条对照邻近代码的既有写法,再决定删或留。原则上是只去掉与本地模式不一致的 slop;领域上合理的 guard(例如对外部输入的校验)会保留。

清理后会按项目约定重跑检查(资料中示例为 bun check、bun typecheck),若有回归再修,最后汇报改了哪些文件、哪些 slop 已删、哪些有意保留。具体启发式清单见 references/slop-heuristics.md。

边界与注意点

  • 不要在信任边界上砍防护:用户输入、鉴权、网络、数据库、文件 I/O 等处的校验应保留。
  • 不要用更弱的类型替换本来正确的类型标注。
  • 倾向最小改动,避免整文件重写;命名、组件与 hooks/query 等风格应继续贴合仓库惯例。

使用场景

  • 合并 AI 生成功能分支前,要对 `git diff main...HEAD` 里的多余注释和 lint 忽略做一次对照清理
  • 接手同事用 Copilot 改过的 PR,需要把 catch 块、类型断言和调试残留按仓库既有写法逐项决定去留
  • 发版前发现 diff 里大量防御性检查风格与邻行不一致,要在不削弱输入校验的前提下删 slop
  • 重跑 `bun typecheck` 前先收口分支:用 ripgrep 扫新增行,再按 slop-heuristics 清单人工确认

适合人员

  • 维护 monorepo 的工程师,经常在 review 里看到 AI 补丁带来的冗余注释和 eslint-disable
  • 负责合并长期功能分支的 Tech Lead,希望 diff 清理有清单、有汇报而不是凭感觉删代码
  • 用 Bun 工具链的前端/全栈开发者,需要在删 slop 后自动重跑 check 与 typecheck
  • 开源协作者,想在上游 PR 里只提交最小改动、又别让信任边界上的 guard 被误删