AgentSkillsCN

Systematic Release Management

以系统化流程进行版本控制、文档更新，以及安全地为发布打上标签。

SKILL.md
--- frontmatter
name: Systematic Release Management
description: Workflow sistemático para versionamento, atualização de documentação e tagueamento seguro de releases.

Systematic Release Management

Esta skill guia o Release Manager (ou o desenvolvedor) através de um processo seguro e padronizado de release.

Fluxo de Trabalho

Phase 1: Pre-Release Check (Segurança)

  1. •Git Clean Check: Verifique se o diretório de trabalho está limpo.
    • •IMPORTANTE: Todo o código da versão (features/fixes) já deve estar commitado ANTES de iniciar o release.
    • •Cmd: git status --porcelain (Deve estar vazio)
  2. •Testes: Executar suite de testes para garantir que nada está quebrado.
    • •Ação: Rode os testes unitários/integração relevantes. Se falhar, ABORTE.

Phase 2: Version Analysis (Planejamento)

  1. •Identificar Versão Atual: Leia a versão atual do lib/core.sh ou arquivo equivalente.
  2. •Analisar Commits: Liste os commits desde a última tag para entender o impacto.
    • •Cmd: git log $(git describe --tags --abbrev=0)..HEAD --oneline
  3. •Advanced Discovery:
    • •Busque por arquivos que contenham a versão atual para garantir que nada foi esquecido.
    • •Cmd: grep -r "vCURRENT_VERSION" . --exclude-dir={.git,node_modules,vendor}
  4. •Determinar Incremento:
    • •MAJOR: Quebra de compatibilidade (Breaking changes).
    • •MINOR: Novas features compatíveis (Feat).
    • •PATCH: Correções de bugs (Fix, Docs, Chore, Style).
  5. •Definir Nova Versão: Calcule o número exato (ex: 3.3.0 -> 3.3.1).

Phase 3: Content Updates (Execução)

  1. •Atualizar Arquivos de Versão:
    • •Substitua a string de versão em TODOS os arquivos mapeados (libs, configs, readmes).
  2. •Atualizar Changelog:
    • •Crie uma nova seção no topo do CHANGELOG.md.
    • •Data: Hoje (YYYY-MM-DD).
    • •Agrupe os commits em seções: 🚀 Novidades, ⚡ Melhorias, 🐛 Correções.

Phase 4: Finalization (Release)

  1. •Verificação Visual: Use git diff para rever as mudanças automáticas.
  2. •Commit de Release:
    • •Mensagem Padrão: chore(release): prepare vX.Y.Z
  3. •Version Tag:
    • •Cmd: git tag -a vX.Y.Z -m "Release vX.Y.Z"
  4. •Push:
    • •Cmd: git push origin main --tags (Solicite confirmação do usuário antes deste passo).

Dicas do Mestre

  • •Nunca releia código sujo: Se houver mudanças locais, elas podem ser acidentalmente incluídas no release. Force git stash ou commit antes.
  • •Sincronia é Chave: O número da versão deve ser idêntico em todos os lugares. Um grep pós-alteração ajuda a verificar.