Implantação em Staging

Implanta a aplicação atual em staging — executa testes, build, pede confirmação humana, então executa o script de deploy e uma verificação de saúde. Use quando o usuário quiser implantar em staging (alvo demo: ex_staging).

O que é Implantação em Staging?

Este skill automatiza o processo de deploy para um ambiente de staging de forma segura e repetível. Ele guia o agente através de uma sequência de passos: primeiro, verifica se a árvore do git do diretório alvo está limpa, depois executa os testes (`npm test`) e a build (`npm run build`). Caso alguma etapa falhe, o processo é interrompido automaticamente. Em seguida, é obrigatório solicitar confirmação explícita do usuário antes de prosseguir com o deploy — uma barreira de segurança que garante que ações irreversíveis não sejam tomadas sem supervisão. Após a confirmação, executa o script de deploy (`npm run deploy:staging`) e realiza um smoke check de saúde através de uma requisição GET para o endpoint `/health` lido de `.staging-url`, verificando se a resposta é HTTP 200 com `ok: true`. Por fim, resume o que foi implantado, a URL e o resultado do smoke check. É ideal para agentes de IA que atuam como engenheiros de software (ex: Claude Code, Cursor, Codex) em projetos Node.js com staging simulado ou real. Suporta monorepos e ignora sujeira em outras pastas, concentrando-se apenas no diretório alvo.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/olonok69/cursor_code_ml_engineer/tree/HEAD/.cursor/skills/deploy-staging

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Implantação em Staging faz?

Fluxo repetível para implantar em staging de forma segura. Alvo demo: pasta ex_staging/ (staging local simulado — sem nuvem real).

Passos

  1. cd para o destino (ex_staging ou o caminho mencionado com @).
  2. Verifica a árvore git do destino: git status --porcelain -- . (a partir dessa pasta) ou git status --porcelain -- ex_staging. Se houver alterações não commitadas no destino, PARE e avise. (Sujeira em outras pastas do monorepo do curso pode ser ignorada após aviso.)
  3. Execute os testes: npm test. Se falhar, PARE e mostre a saída.
  4. Compile: npm run build. Se falhar, PARE.
  5. Peça confirmação humana antes de implantar (ação externa / irreversível em produção). Não execute o deploy até um OK explícito do usuário neste chat.
  6. Após OK: npm run deploy:staging (equivale a node scripts/deploy.mjs staging).
    • Neste demo, isso sobe um servidor local e escreve .staging-url.
    • Em um repositório real, substitua por ./scripts/deploy.sh staging ou seu pipeline.
  7. Smoke check: leia .staging-url e chame GET {url}/health (curl, Invoke-WebRequest ou fetch). Deve retornar HTTP 200 e ok: true.
  8. Resuma: o que foi implantado, URL, resultado do smoke. Mencione npm run staging:stop para desligar o demo.

Regras

  • Nunca implante com testes vermelhos ou destino sujo.
  • Nunca implante sem solicitação/confirmação humana explícita (portão de handoff).
  • Mostre sempre a saída real de cada comando.
  • Não use staging.example.com neste repositório — o smoke é contra a URL local de .staging-url.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas