SuperAPI AI 工具集

package-json-maintenance

通用与其它

查看项目

更新于 10-16 06:17

技能介绍

用途:在隔离的 git worktree 中执行 JavaScript/Node.js 包的维护任务,包括安全审计与依赖更新,避免影响当前工作目录。

主要能力:自动检测项目使用的包管理器(npm、yarn、pnpm、bun),依据锁文件判断,并以 package.json 的 packageManager 字段为优先。支持指定具体包(如 jest @types/jest)、全部包(.)或 glob 模式(如 @testing-library/* jest*)。根据用户请求选择工作流:安全审计(audit、CVE、vulnerabilities、security)参考 references/audit-workflow.md;依赖更新(update、upgrade、latest、modernize)参考 references/update-workflow.md。

使用方式:先创建隔离环境,优先使用 worktree: git worktree add "$WORKTREE_PATH" -b "$BRANCH_NAME" 若因沙箱目录限制失败,可提示用户改用当前目录新建分支,会先执行 git stash --include-untracked。随后检测包管理器、验证仓库连通性、查找除 node_modules 外的所有 package.json,识别包并应用变更。之后按 build → lint → test 顺序运行现有脚本校验,失败则回滚到先前版本;大版本升级需更新 CLAUDE.md、README.md、docs/*.md 中的版本引用。最后清理 worktree 或恢复分支。

限制与边界:需要 git 仓库,否则报错;无 package.json 会清晰报错;包未找到会提示检查名称;glob 无匹配会警告并列出可用包;网络受限时包管理器命令无法执行,需确认 registry 连通后再继续;不支持的包管理器会提示用户手动指导。