SuperAPI AI 工具集

deslop

编程与开发

查看项目

更新于 10-16 00:22

技能介绍

用途:在每次提交前清理分支改动过的代码中的“AI slop”,并保持行为不变。触发方式包括 /deslop、“deslop it”、“clean the diff”或“strip the slop”。它只清理代码;文案由 unslop 技能负责,注释审查由 no-comments 技能负责。

范围:使用调用者指定的文件或 diff;否则与当前分支所基于的分支比较(含工作区与未跟踪文件,git status --short)。若存在 PR 则以 PR 的 base 为准(gh pr view <branch> -R <owner>/<repo> --json baseRefName),否则用被切出的分支(git branch -vv 或 git reflog show <branch>),再否则用 main。堆叠分支上用 main 会把父分支提交拉进 diff。只编辑分支新增或改动过的 hunk。

主要能力与规则要点:删除叙述性注释与注释掉的代码;保留许可证头、外部依赖强制的非显然行为、prettier-ignore、定义公共 API 契约的文档注释等。删除对不可能状态的守卫、不可信路径上的防御性包装、重复校验,但系统边界的守卫保留。删除无调用者的兼容垫片、未使用参数/导出/标志、调试残留。修正仅用于骗过类型检查器的类型消音。内联单调用者包装、投机性抽象,调用已有 helper,用提前返回扁平化嵌套,避免小差异复制粘贴,标记 diff 无法修复的结构问题。回退无关编辑(格式、重命名、导入重排),按 hunk 回退以保留同文件中未提交的改动。

流程:逐 hunk 阅读并命名其任务;按规则顺序做最小编辑,先删后改;遇到需要新形状(类型、helper、状态模型)的切分点时停下,交给 Refactoring playbook;在真实产物上运行 diff 涉及的测试与类型检查以证明行为不变,若测试必须修改则行为已变,回退该切分;将剩余部分交给相邻技能;最后按指定格式报告。

限制:deslop 从不为了消除 slop 而新增抽象;范围外的 slop 只报告不修改;不负责文案与注释审查本身。项目位于 https://www.skills.sh/mdsmithaustin/pstack/deslop。