用途:按用户需求,从零搭建一个配置完整、可直接发布的生产级 npm 包项目。若未提供包名,会先向用户询问。
主要能力:先进行需求确认,询问包描述、是否使用作用域(如 @org/package)、运行时目标(Node、浏览器或通用)、入口形式(单一或多子路径导出)、测试框架(默认 Vitest,可选 Jest)、CI 平台(默认 GitHub Actions)、许可证(默认 MIT)、最低 Node 版本(默认 18)。随后生成目录结构,包括 src/index.ts、tests/index.test.ts、.github/workflows/ci.yml、.changeset/config.json、package.json、tsconfig.json、tsconfig.build.json、tsup.config.ts、vitest.config.ts、eslint.config.mjs、prettier.config.mjs、.gitignore、.npmignore、LICENSE、README.md、CHANGELOG.md。
生成内容涵盖:package.json 的 exports 双格式配置(import 指向 .mjs、require 指向 .cjs,含类型声明),tsup 构建 ESM/CJS 并生成类型文件,Vitest 覆盖率阈值 80%,TypeScript 严格模式,ESLint 严格 TypeScript 规则,Prettier 格式化,Changesets 版本管理,GitHub Actions CI(Node 18/20/22 矩阵,含发布试运行)。还会生成带 JSDoc 的起始源码、基础测试与 README(含徽章、安装、快速开始、API、开发、贡献、许可证)。
使用方式:该技能按阶段执行,先安装依赖(开发依赖包括 typescript、tsup、@changesets/cli、eslint、@eslint/js、typescript-eslint、prettier、vitest、@vitest/coverage-v8,Jest 方案替换为 jest、ts-jest、@types/jest),再依次运行 npm run typecheck、npm run lint、npm run test、npm run build、npm pack --dry-run 进行验证,最后执行 git init 并创建初始提交。
适用场景与限制:适合需要快速获得完整发布配置的 npm 包项目。要求用户先确定包名与关键选项;默认无生产依赖。部分细节(如具体价格、平台支持范围)暂未提供。