技能包

用 autoship 自动化 changesets 发版

适合已用 changesets 的仓库、要用 AI 生成说明并自动化发版的人;需 Node.js 18+、Git、已登录的 gh 和 AI_GATEWAY_API_KEY。

官方来源 · autoship

安装

npx skills add vercel-labs/autoship

适合谁

适合仓库已经用 changesets 做版本管理,并想用 AI 生成发版说明、把 changeset 发版流程自动化的人。官方仓库是 https://github.com/vercel-labs/autoship ,把它写成 CLI tool to automate changeset-based releases with AI-generated descriptions。前置条件写得很硬:Node.js 18+、Git、已对目标仓库鉴权的 GitHub CLI(gh),以及环境变量 AI_GATEWAY_API_KEY。目标仓库 must use changesets。缺少其中任何一项,都不要把第一次尝试做成正式发版。

它适合先在你有权修改的仓库里做一次可撤回的演练,不适合对未使用 changesets 的生产库直接开刀。材料写了若干 Supported 界面,正文不展开名单,也不要从这份名单推断未写出的界面一定不可用。

3 分钟完成第一次尝试

先核对立项条件,再安装技能。官方技能安装命令是:

npx skills add vercel-labs/autoship

这是材料给出的技能安装命令。先确认当前目录允许写入技能配置,再执行;副作用是把 autoship 技能装进当前代理环境。装完后先看技能是否可被唤起,不要立刻发版。

低风险任务:在已能运行该技能的代理里,只做检查——确认本机 Node.js 为 18+、git 与 gh 可用、gh 对目标仓库有权限、环境里已有 AI_GATEWAY_API_KEY、目标仓库确实使用 changesets。变更点到此为止。成功信号是上述检查都通过,且技能已安装。不要在检查失败时改用未出现的安装器,也不要编造密钥值。

若检查通过,且目标仓库是你明确允许写入的演练库,才考虑官方示例:

npx autoship add myproject

材料把仓库名写成 myproject;只有在你把该名字对应到自己有权限、且已使用 changesets 的仓库之后才能执行。执行前再次确认不会对生产渠道发版。成功信号是仓库被加入 autoship,而不是已经发布到登记处。

使用案例

案例一:先装技能,只做发版前置检查。对应 npx skills add vercel-labs/autoship,以及 Node.js 18+、Git、gh、AI_GATEWAY_API_KEY、changesets 这些条件。适合还不确定仓库是否合格的人。材料没有写检查命令的输出格式;能确认的是这些条件必须同时满足。不要把案例一写成已经生成发版说明。

案例二:把已使用 changesets 的仓库加进 autoship,准备带 AI 说明的发版。对应 npx autoship add myproject 与 automate changeset-based releases with AI-generated descriptions。适合前置检查已通过、只差登记仓库的人。材料没有写如何预览说明、如何撤回或如何跳过 AI;能确认的只有「先 add 仓库」。没有出现发布或回滚命令,不要补。

使用边界

没有 changesets 的仓库不在材料覆盖范围内。AI_GATEWAY_API_KEY 是必需环境变量名,材料没有写申请入口或免费额度;不要用占位密钥凑合。gh 必须已对目标仓库鉴权,材料没有写组织策略或细粒度权限模型。changesets 的说明指向 https://github.com/changesets/changesets ,但那只证明版本策略依赖它,不证明 autoship 已替你初始化 changesets。第一次尝试不要初始化生产发版。材料没有给出其它安装命令。