Promover Mudanças
Executa o fluxo completo de release do estado de trabalho atual até uma release do GitHub taggeada na main.
Branch atual: !git branch --show-current 2>/dev/null || echo "desconhecida"
Status do git: !git status --short 2>/dev/null || echo "não é um repositório git"
Última tag: !git describe --tags --abbrev=0 2>/dev/null || echo "nenhuma"
Commits recentes desde a última tag:
!`git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --oneline -10 2>/dev/null || git log --oneline -10`
Próxima versão (calculada a partir dos commits acima):
!`(last=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0"); IFS='.' read -r ma mi pa <<< "${last#v}"; log=$(git log "${last}..HEAD" --format="%s" 2>/dev/null); if echo "$log" | grep -qE "^[a-z]+(\([^)]+\))?!:"; then echo "v$((ma+1)).0.0"; elif echo "$log" | grep -qE "^feat"; then echo "v${ma}.$((mi+1)).0"; else echo "v${ma}.${mi}.$((pa+1))"; fi)`
Etapa 0: Verificações de pré-voo
gh auth status 2>&1 || { echo "ERRO: gh não está autenticado. Execute: gh auth login"; exit 1; }
Verifique arquivos .env não rastreados que possam ser acidentalmente preparados:
git status --short | grep -E '^\?\? .*\.env' && echo "AVISO: arquivos .env não rastreados detectados — revise antes de preparar"
cat .gitignore 2>/dev/null | grep -q '\.env' || echo "AVISO: .gitignore não exclui arquivos .env"
Se algum arquivo .env for preparado:
if [ -t 0 ]; then
# Interativo — peça confirmação antes de continuar
read -p "AVISO: arquivos .env detectados. Continuar? (s/N) " confirm
[[ "$confirm" =~ ^[Ss]$ ]] || { echo "Abortado."; exit 1; }
else
# Não interativo — parada brusca; arriscado demais para prosseguir sem revisão humana
echo "ERRO: arquivos .env não rastreados detectados em modo não interativo. Abortando."
exit 1
fi
Etapa 1: Commitar quaisquer mudanças não commitadas
Se o status do git acima mostrar mudanças não commitadas ou não rastreadas:
- Revise o diff:
git diffegit diff --cached - Prepare as mudanças seletivamente — prefira arquivos rastreados:
git add -u, depois revise e adicione quaisquer novos arquivos intencionais individualmente. Evitegit add -Aa menos que o usuário confirme explicitamente. - Elabore uma mensagem de commit convencional a partir das mudanças — comece com um prefixo de tipo
(
feat:,fix:,docs:,chore:, etc.) e um resumo conciso - Commit usando um heredoc para que mensagens de várias linhas sejam formatadas corretamente
Se não houver nada não commitado, pule para a Etapa 2.
Etapa 2: Enviar
Envie a branch atual para o repositório remoto:
git push -u origin HEAD
Etapa 3: Mesclar para main (apenas branch de funcionalidade)
Pule esta etapa se já estiver em main (ou na branch padrão do repositório).
Se estiver em uma branch de funcionalidade:
-
Escaneie commits desde a última tag em busca de referências a issues:
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --format="%B"Procure por
Closes #N,Fixes #N,Resolves #N(sem distinção de maiúsculas/minúsculas). Colete todos os números de issues encontrados. Se nenhum for encontrado:if [ -t 0 ]; then # Interativo — pergunte ao usuário read -p "Alguma issue do GitHub que isso resolve? (ex.: 12 15 — ou Enter para pular) " issues else # Não interativo — pule silenciosamente issues="" fi -
Crie um PR direcionado para a main, incluindo palavras-chave de fechamento no corpo para que o GitHub feche as issues automaticamente ao mesclar:
gh pr create --title "<tipo>: <resumo>" --body "$(cat <<'EOF' ## Resumo <pontos dos commits> Closes #N, Closes #N 🤖 Gerado com [claude-workflow-skills:promote](https://github.com/ali5ter/claude-workflow-skills) em nome de [Alister](https://github.com/ali5ter) EOF )"Omita as linhas
Closesse nenhuma issue foi identificada. -
Ative a mesclagem automática (squash preferido):
gh pr merge --auto --squash -
Consulte até que seja mesclado:
gh pr view --json state --jq '.state' -
Mude para a main e faça pull:
git checkout main && git pull
Etapa 4: Confirmar a próxima versão
A próxima versão é pré-calculada no bloco de contexto acima usando estas regras semver:
- Assunto do commit com
!:(ex.:feat!:,fix!:) → incremento major - Assunto do commit começando com
feat→ incremento minor - Todos os outros commits → incremento patch
Confirme se a versão calculada está correta dada a lista de commits. Se não houver tag anterior, use
v1.0.0. Substitua apenas se a versão calculada estiver claramente errada (ex.: a injeção retornou
um erro ou saída vazia).
Etapa 5: Sincronizar manifesto do plugin (se presente)
Se .claude-plugin/plugin.json existir, atualize seu campo version para <próxima-versão> (sem prefixo v
— manifestos de plugin usam semver simples como 1.2.3):
node -e "
const fs = require('fs');
const f = '.claude-plugin/plugin.json';
const d = JSON.parse(fs.readFileSync(f, 'utf8'));
d.version = '<próxima-versão>';
fs.writeFileSync(f, JSON.stringify(d, null, 2) + '\n');
"
Depois, commitar e enviar:
git add .claude-plugin/plugin.json
git commit -m "chore: sincronizar versão do plugin.json para v<próxima-versão>"
git push
Pule esta etapa inteiramente se .claude-plugin/plugin.json não existir.
Etapa 6: Tag e release
git tag -a v<próxima-versão> -m "Release v<próxima-versão>"
git push origin v<próxima-versão>
gh release create v<próxima-versão> \
--generate-notes \
--title "v<próxima-versão>"
Etapa 7: Fechar issues resolvidas (apenas branch main)
Pule esta etapa se um PR foi criado na Etapa 3 — o GitHub fechará as issues automaticamente quando
o PR for mesclado através das palavras-chave Closes #N no corpo do PR.
Se a promoção foi diretamente na main (sem PR), feche quaisquer issues identificadas agora:
gh issue close <N> --comment "Resolvido em $(gh release view v<próxima-versão> --json url --jq '.url')"
Etapa 8: Limpar branch de funcionalidade mesclada
Se uma branch de funcionalidade foi mesclada na Etapa 3, exclua-a local e remotamente:
git branch -d <branch-de-funcionalidade>
git push origin --delete <branch-de-funcionalidade>
Etapa 9: Confirmar estado limpo
git status
git log --oneline -5
Relate a URL da release do GitHub de gh release view v<próxima-versão> --json url --jq '.url'.