1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | anti-slop |
| 作者/维护者 | dmmulroy(个人开发者) |
| 来源链接 | https://github.com/dmmulroy/anti-slop |
| 许可证 | MIT(GitHub API 确认) |
| GitHub Stars | 2,824(GitHub API 实测) |
| Forks | 50(GitHub API 实测) |
| 最新版本 | 尚无正式 Release——采用“直接 vendor 源码进仓库”的分发方式,不走 npm 包版本号 |
| 安装方式 | npx skills add dmmulroy/anti-slop --skill install-anti-slop,或手动复制 src/ 到目标仓库 |
2. 功能介绍与亮点
anti-slop 是一套 Oxlint 插件规则,专门捕获 TypeScript/JavaScript 中“低置信度”的代码模式——这类模式常见于 AI 编码代理生成的补丁,例如链式类型断言、条件式空对象展开、reflect 元编程调用、运行时 typeof 滥用、object 参数反模式等,共 15 条通用规则,另有一组面向 Effect 生态的可选规则。
设计上刻意不做成固定 npm 依赖,而是把源码直接复制(vendor)进使用者自己的仓库——规则完全透明,用户可以直接读源码并按团队标准修改,不受上游更新节奏束缚。配套的 agent skill 会自动完成“复制插件文件→安装当前版本的 Oxlint 依赖→合并进现有 lint 配置的 ignorePatterns/jsPlugins→跑一遍检查”整套流程,且会先探测项目的包管理器与现有 Oxlint 配置,避免覆盖已有设置。
3. 适用场景
固定分类:工程效率与代码质量
适合已经使用 Oxlint、或愿意引入 Oxlint 的 TypeScript/JavaScript 项目维护者与代码审查者,用在 CI 或 PR 检查前,自动拦截 AI 编码代理常见的低置信度写法,减少人工复核这类补丁的负担。
4. 跨 Agent 兼容性
- Claude Code:✅ 原生支持——通过
skills.sh标准 Agent Skill 目录安装,Claude Code 自动识别SKILL.md - Codex:✅ 原生支持——同一套
skills.sh分发机制官方支持 Codex CLI - OpenClaw:✅ 原生支持——
skills.sh官方指南单独列出了 OpenClaw 的安装路径 - Hermes Agent:❓ 未验证——未找到该平台的明确支持记录
判断依据:skills.sh(Vercel 出品的开放 Agent Skills 安装工具)官方文档与教程页面。
5. 推荐理由
一条命令就能为 TypeScript/JavaScript 项目装上专门拦截“AI 生成代码坏味道”的 lint 规则,规则源码直接进自己仓库、完全透明可审计,解决 AI 编码代理普及后团队真实存在的补丁质量把关痛点。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | GitHub 2,824 stars,创建约一周内快速增长;被 skills.sh、trendshift.io(GitHub 趋势追踪站)收录展示 |
| 可用性 | 8 | 单条命令安装,SKILL.md 步骤与配置示例完整,近一周内持续维护,依赖全部开源免费;限定 TypeScript/JavaScript + Oxlint 技术栈 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单: ① Shell/权限:安装脚本仅 21 行,本地文件复制 + 写入 lint 配置,无越权操作 ② 联网外发:仅在安装时查询 npm 公开注册表的包版本号,目标透明,无用户数据外发 ③ 凭据:不涉及任何 API key 或凭据 ④ 可疑指令:通读 SKILL.md 与安装脚本,未发现提示词注入或夹带无关推广内容 ⑤ 作者信誉:个人开发者,无造假迹象;GitHub 仅 2 条待处理 issue(功能建议、单条规则误报),均为正常迭代反馈 ⑥ License:MIT,明确 ⑦ 维护时间:创建于 2026-08-12,最近一次提交 2026-08-18,活跃
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与 anti-slop 的差异 |
|---|---|---|
| brooks-lint | 通用 lint 规则集成技能 | 覆盖面更泛化,不专门针对“AI 生成代码”这一类低置信度模式 |
| fallow-skills | lint/代码质量类技能 | 面向通用代码规范检查,缺少 anti-slop 这种“vendor 到仓库、可直接改规则”的透明分发设计 |
| 常规人工/Agent 代码审查类技能 | 依赖人或 Agent 逐条复核 diff | anti-slop 是静态 lint 规则,在编译期/CI 阶段自动拦截,不需要额外一轮人工审查即可生效 |
anti-slop 的差异化在于:规则专门针对 AI 编码代理常见的“看起来对但证据不足”的写法(如滥用类型断言掩盖类型错误),且以 vendor 而非依赖的方式交付,避免团队被上游规则变更打断。
8. 用户评价
该技能已被 skills.sh(Agent Skills 安装工具)与 trendshift.io(GitHub 趋势追踪站)收录展示,但目前尚未找到具名第三方用户的评价内容。
9. 其他补充
仓库同时提供面向 Effect 生态的可选规则组(anti-slop-effect),仅在项目依赖声明中显式包含 Effect 时才建议启用,避免误伤未使用该框架的项目。
10. 安装使用方式
方式一(推荐,经 Agent Skill):
npx skills add dmmulroy/anti-slop --skill install-anti-slop
安装后,直接向编码 Agent 提出“在当前仓库安装/配置 anti-slop”,技能会自动复制规则文件、安装匹配版本的 oxlint 与 @oxlint/plugins、合并进现有 Oxlint 配置并跑一遍检查。
方式二(手动安装):将 src/ 复制到目标仓库(如 tools/oxlint/anti-slop/),并在 oxlint.config.ts 中注册 jsPlugins 与对应 rules(详见仓库 README 的完整配置片段)。
注意事项:首次安装前建议先执行 git status 确认无冲突改动;若目标目录已存在同名文件,脚本会拒绝覆盖,需人工确认后加 --force。
11. 注意事项
- 项目创建仅一周多,尚无正式版本号,规则本身可能随时间调整——vendor 到自己仓库后不会被上游变更自动打断,但也需要自行决定何时同步新规则
- 规则集合仅覆盖 TypeScript/JavaScript + Oxlint 技术栈,不适用其他语言或 ESLint 等其他 lint 工具
- 已知一条规则(
no-shape-in-symbol-names)会对 zod 库的.shape属性产生误报,命中该场景需手动在配置中关闭