用途
find-npm-packages 用于为 Front-End Checklist 项目中的某条规则识别、验证并添加 npm 包引用。给定一个规则文件或规则 slug,该技能会理解规则检查的内容,调研常用于实现、自动化或强制该规则的 npm 包,验证候选包是否满足质量阈值,选出最佳的 2–3 个包,并将它们添加到规则的 npmPackages frontmatter 字段中。
主要能力
- 理解规则:读取规则文件 packages/content/rules/en/{category}/{slug}.mdx,关注该规则解决什么问题、强制什么技术/规范/行为,以及 tools: 字段中提到的工具或 linter。
- 识别候选包:搜索能够检测问题(linter、审计工具、CLI 扫描器)、修复或实现模式(框架、工具库、polyfill)、测试合规性(测试工具、CI 集成)的包。优先选择官方工具链的一部分(如 eslint、stylelint、官方插件)、行业广泛采用、积极维护的包。
- 验证候选包:对每个候选包,通过 npm registry 获取并核实元数据与周下载量,记录周下载量和最近发布时间,拒绝低于阈值的包。
- 选择 2–3 个包:每条规则不超过 3 个包;优先多样性,相关时优先一个检测器、一个修复器、一个框架辅助工具;若通过阈值的少于 2 个,可以只添加 1 个或留空;绝不虚构包。
- 更新规则 frontmatter:添加 npmPackages 数组,仅包含包名(元数据在构建时获取),放在 tools: 之后、resources: 之前。
- 添加后验证:运行验证脚本确认所有包通过阈值。
质量阈值(强制,不可跳过)
在选择任何包之前,使用 npm registry 对照以下标准检查:
- 周下载量:大于 10,000/周
- 最近发布:18 个月内
- npm registry:必须被收录(registry.npmjs.org/{name})
任何未通过任一阈值的包都必须排除,无论其相关性多高。
使用方式
- 理解规则:读取规则文件,聚焦规则解决的问题、强制的内容以及 tools: 字段提到的工具。
- 识别候选:使用 https://www.npmjs.com/search?q={keywords} 和生态知识寻找候选包。
- 验证每个候选:获取并核实元数据与周下载量,记录周下载量和最近发布日期,拒绝低于阈值者。
- 选择 2–3 个包:不超过 3 个,优先多样性,通过阈值的少于 2 个时可只加 1 个或留空,绝不虚构包。
- 更新规则 frontmatter:添加 npmPackages 数组,仅包名,放在 tools: 之后、resources: 之前。
- 添加后验证:运行 pnpm validate:packages packages/content/rules/en/{category}/{slug}.mdx,若有包未通过则移除或替换。
适用场景
适用于维护 Front-End Checklist 规则、需要为某条前端规则补充相关 npm 包引用的场景。例如为 accessibility/form-labels 规则添加 eslint-plugin-jsx-a11y、axe-core、@testing-library/jest-dom 等包。
限制
- 不得添加周下载量低于 10,000 的包。
- 不得添加最近发布时间超过 18 个月的包。
- 不得添加超过 3 个包。
- 不得添加仅间接相关的通用包。
- 不得虚构包名,必须验证每个包在 npm 上存在。
- 不得添加包版本号(版本在构建时获取)。
- 若通过阈值的包少于 2 个,可以只添加 1 个或留空。