SuperAPI AI 工具集

npmjs

通用与其它

查看项目

更新于 10-16 05:07

技能介绍

用途:在 monorepo 中管理 npm 包的全生命周期,包括健康审计、依赖同步、版本升级、变更日志更新、发布前检查与发布协调。

主要能力:

  • 健康与审计:列出扩展包版本与 private 状态,对比本地与 npm 已发布版本,检查缺失依赖、未使用依赖、幽灵 peer 依赖,以及共享依赖版本一致性。
  • 变更检测:通过 git 标签与提交记录找出自上次发布后有改动的包。
  • 发布前检查:运行 npx tsc --noEmit 类型检查,确认 README.md、CHANGELOG.md、package.json、.npmignore 存在,校验 package.json 必填字段,用 npm pack --dry-run 验证打包内容,并检查 AGENTS.md 是否被 .npmignore 排除。
  • 版本升级:单包或批量执行 npm version <patch|minor|major> --no-git-tag-version,也可只升级有改动的包。
  • 变更日志:按 Keep a Changelog 格式手动编写条目,使用祈使语气、ISO 8601 日期,标注破坏性变更与 PR 编号。
  • 发布:单包或批量执行 npm publish --access public,可只发布版本号与 npm 不一致的包;需要 OTP 时加 --otp=<code>。
  • 发布后验证:用 npm view 核对版本,在临时目录测试安装。
  • Git 打标签:按 <name>@<version> 格式打标签并推送。
  • 依赖同步:查找共享依赖版本差异,批量更新指定依赖版本。

使用方式:按审计、升级、写变更日志、检查、提交、发布、验证、打标签、推送的顺序执行完整发布流程。所有命令以 shell 脚本形式给出,需在仓库根目录运行,依赖 jq、git、npm 等工具。

适用场景:维护 @e9n 作用域下的 monorepo 扩展包,尤其是需要批量发布多个包的场景。

限制:资料未提供该技能的安装方式、收费信息、平台支持范围与效果保证;命令中的路径、作用域与包名需按实际仓库调整。