Skills

Automatize lançamentos changeset com autoship

Para repositórios que já usam changesets e querem notas de IA mais lançamentos automatizados; é preciso Node.js 18+, Git, um gh autenticado e AI_GATEWAY_API_KEY.

Official source · autoship

Install

npx skills add vercel-labs/autoship

Para quem

Serve para quem já usa changesets para versionar e quer notas de lançamento geradas por IA mais um fluxo de release changeset automatizado. O repositório oficial é https://github.com/vercel-labs/autoship Ele se descreve como CLI tool to automate changeset-based releases with AI-generated descriptions. Os pré-requisitos são rígidos: Node.js 18+, Git, um GitHub CLI (gh) já autenticado no repositório de destino, e a variável de ambiente AI_GATEWAY_API_KEY. O repositório de destino must use changesets. Se faltar qualquer item, não transforme a primeira tentativa num lançamento real.

Serve para um ensaio reversível num repositório que você pode alterar. Não serve para abrir um repositório de produção que não usa changesets. O material escreve várias interfaces Supported; o corpo não amplia essa lista, e você não deve inferir que uma interface não escrita seja necessariamente indisponível.

Primeira tentativa em 3 minutos

Confira primeiro as condições do projeto e então instale a skill. O comando oficial de instalação da skill é:

npx skills add vercel-labs/autoship

É o comando de instalação de skill que o material dá. Confirme que o diretório atual pode receber configuração de skill e então execute. O efeito colateral é instalar a skill autoship no ambiente de agente atual. Depois, veja primeiro se a skill pode ser chamada; não lance imediatamente.

Tarefa de baixo risco: num agente que já consegue executar esta skill, só conferir — Node.js desta máquina em 18+, git e gh disponíveis, gh com permissão no repositório de destino, AI_GATEWAY_API_KEY já no ambiente, e o destino realmente usa changesets. A alteração para aí. Sinal de sucesso: todas essas conferências passam e a skill está instalada. Se uma conferência falhar, não mude para um instalador que não aparece nem invente um valor de chave.

Se as conferências passarem, e o destino for um repositório de ensaio em que você autorizou escrita de forma explícita, só então considere o exemplo oficial:

npx autoship add myproject

O material escreve o nome do repositório como myproject; execute só depois de mapear esse nome a um repositório ao qual você tem acesso e que já usa changesets. Antes de executar, confirme de novo que não vai lançar para um canal de produção. Sinal de sucesso: o repositório é adicionado ao autoship, não que já tenha sido publicado num registro.

Casos de uso

Caso 1: instalar a skill primeiro e só fazer as conferências prévias de lançamento. Corresponde a npx skills add vercel-labs/autoship e às condições Node.js 18+, Git, gh, AI_GATEWAY_API_KEY e changesets. Serve para quem ainda não tem certeza de que o repositório se qualifica. O material não escreve o formato de saída de um comando de conferência; o confirmável é que essas condições precisam ser verdadeiras ao mesmo tempo. Não escreva o caso 1 como se as notas de lançamento já tivessem sido geradas.

Caso 2: adicionar ao autoship um repositório que já usa changesets, para preparar um lançamento com descrições de IA. Corresponde a npx autoship add myproject e automate changeset-based releases with AI-generated descriptions. Serve para quem já passou nas conferências prévias e só falta registrar o repositório. O material não escreve como pré-visualizar notas, como desfazer ou como pular a IA; o confirmável é só «add o repositório primeiro». Não aparece comando de publicação nem de rollback; não invente.

Limites de uso

Repositórios sem changesets ficam fora da cobertura. AI_GATEWAY_API_KEY é um nome de variável de ambiente obrigatório; o material não escreve entrada de pedido nem cota gratuita. Não improvise com uma chave de espaço reservado. gh já deve estar autenticado no repositório de destino; não há política de organização nem modelo de permissão fina. A documentação de changesets aponta para https://github.com/changesets/changesets Isso só prova que a estratégia de versão depende dele, não que o autoship já inicializou changesets por você. Não inicialize um lançamento de produção na primeira tentativa. O material não dá outro comando de instalação.