By name: github-diff-changelog-publisher version: 1.0.0 description: Gera e publica CHANGELOG.md a partir de git log entre dois refs (tags, branches, commits). Use quando precisar de notas de release estruturadas antes de publicar uma release no GitHub. Nao use para publicar a release em si — use github-release-publication-flow para isso.
GitHub Diff Changelog Publisher
Procedimentos
Etapa 1: Identificar o intervalo de diff
- Confirmar que o contrato de carga base definido em
AGENTS.mdfoi cumprido. - Determinar o ref de inicio (tag anterior ou commit base) e o ref de fim (HEAD ou nova tag).
- Executar
git log <base>..<head> --oneline --no-mergespara listar commits. - Filtrar commits por prefixo Conventional Commits (
feat,fix,perf,breaking).
Etapa 2: Categorizar e formatar
- Agrupar commits por categoria:
### Added(feat),### Fixed(fix),### Changed(perf, refactor),### Breaking Changes. - Remover commits de chore, ci, docs de baixo impacto que nao afetam usuarios.
- Incluir referencias a PRs e issues quando disponíveis (
(#123)). - Formatar em Markdown seguindo Keep a Changelog.
Etapa 3: Atualizar CHANGELOG.md
- Inserir a nova versao no topo do arquivo, mantendo versoes anteriores.
- Formato de header:
## [x.y.z] - YYYY-MM-DD. - Confirmar com o usuario antes de sobrescrever.
Etapa 4: Registrar resultado
- Mostrar o bloco de changelog gerado.
- Sugerir proximo passo: criar tag Git ou usar
github-release-publication-flow.
Tratamento de Erros
- Se nao houver commits no intervalo, reportar e encerrar sem modificar CHANGELOG.md.
- Se o historico de commits nao seguir Conventional Commits, categorizar como
### Changede alertar. - Nao inferir numeros de versao automaticamente sem confirmacao do usuario.