用途:在目标仓库中安装、配置、更新、升级或迁移 vendored 的 anti-slop Oxlint 插件。anti-slop 属于 vendored 代码,目标仓库拥有其规则、诊断、测试和配置,引入上游变更时需保留这些选择。
主要能力:区分全新安装与已有安装(更新、升级、迁移、重新配置);复制插件到 tools/oxlint/anti-slop/;安装匹配版本的 oxlint 与 @oxlint/plugins;注册通用插件、配置忽略项并启用全部通用规则;在满足条件时注册可选的 Effect 插件;运行 lint 与类型检查;在 UPSTREAM.md 记录来源信息。
使用方式:先阅读仓库的 agent 指令与 git status,确认包管理器、Oxlint/Vite+ 配置及已有 anti-slop 入口。全新安装时在目标仓库运行 node <skill-directory>/scripts/install.mjs,可用第一个参数指定其他相对目标路径;脚本拒绝覆盖已有目标,已有副本应走更新流程而非 --force。依赖方面,若仓库已依赖 oxlint,则按已安装版本精确安装 @oxlint/plugins;若无 oxlint 依赖,则查询 npm view oxlint version 与 npm view @oxlint/plugins version 后安装相同当前版本。随后在 oxlint.config.ts 或 .oxlintrc.json 中合并 ignorePatterns 与 jsPlugins,并启用列出的 anti-slop 规则及原生 oxc/no-accumulating-spread。Vite+ 需同时合并 lint 与 fmt 的忽略项。
适用场景:需要为仓库引入 anti-slop 规则、跟进上游规则或修复、或迁移既有 vendored 安装时。
限制:脚本不覆盖已有目标;Effect 插件仅在包清单直接依赖 effect 或用户明确要求时启用,不因 lockfile 传递依赖而启用;Effect 规则覆盖相对项目导入,包别名导入是当前限制;no-array-filter-map 不推断未知接收者类型;no-reduce-accumulator-copy 不完整分析命名回调、间接辅助函数与嵌套累加器属性;不得为通过 lint 而抑制规则、降低严重级别或添加不安全类型断言。来源信息无法确认时应记为 unknown。