O que changelog-generator faz?
Gera automaticamente changelogs voltados para o usuário a partir de commits git, analisando o histórico de commits, categorizando alterações e transformando commits técnicos em notas de lançamento claras e amigáveis ao cliente. Reduz horas de escrita manual de changelogs para minutos de geração automatizada.
Como funciona
O skill analisa o histórico de commits do repositório git atual (ou um diretório especificado), categoriza cada commit com base em palavras-chave (como "fix", "feat", "chore") e gera uma saída formatada em markdown ou texto simples, organizada por tipo de alteração. A saída pode ser personalizada para incluir apenas alterações relevantes ao usuário, ignorando commits de desenvolvimento interno.
Uso
# Executar no diretório do repositório git
generate-changelog
# Especificar intervalo de versão (ex.: entre tags)
generate-changelog --from v1.0 --to v2.0
# Salvar em arquivo
generate-changelog --output CHANGELOG.md
Parâmetros
| Parâmetro | Descrição | Padrão |
|---|---|---|
--from | Commit ou tag inicial (hash, tag ou referência) | Última tag |
--to | Commit ou tag final (hash, tag ou referência) | HEAD |
--output | Caminho do arquivo de saída | stdout |
--format | Formato de saída: markdown, plain, json | markdown |
--categorize | Forçar categorização personalizada (ex.: "fix:bug,feat:feature") | automática |
Categorização automática
| Categoria | Padrão nos commits | Exemplo de saída |
|---|---|---|
| ✨ Novas funcionalidades | feat:, feature:, add: | "Adicionado suporte a autenticação OAuth" |
| 🐛 Correções de bugs | fix:, bugfix:, hotfix: | "Corrigido erro ao carregar avatar" |
| 🛠️ Melhorias | improve:, refactor:, perf: | "Melhorado desempenho da busca" |
| 📚 Documentação | docs:, doc:, changelog: | "Atualizada documentação da API" |
| 🔧 Tarefas internas | chore:, test:, build:, ci: | (ignorado por padrão) |
Exemplo de saída (markdown)
# Changelog
## [v2.0.0] - 2025-03-15
### ✨ Novas funcionalidades
- Adicionado suporte a autenticação multifator
- Implementada exportação para CSV
### 🐛 Correções de bugs
- Corrigido erro ao carregar página de configurações
- Resolvido problema de cache em requisições simultâneas
### 🛠️ Melhorias
- Otimizado tempo de consulta ao banco de dados
- Melhorada acessibilidade no formulário de login
Integração com CI/CD
Adicione o comando generate-changelog como etapa pós-release em seu pipeline (GitHub Actions, GitLab CI, etc.) para gerar changelogs automaticamente a cada versão.
Exemplo com GitHub Actions:
- name: Gerar changelog
run: generate-changelog --output CHANGELOG.md
Suporte
Plataformas compatíveis: Claude Code, Cursor, Codex, e qualquer ambiente com acesso a git e Node.js/Python.
Nota: O skill requer que o repositório git esteja acessível e que haja pelo menos uma tag de versão para definir o intervalo inicial (caso não seja especificado --from).