CommunityEscrita e Ediçãogithub.com

JulienLerosty/claude-code-team-kit

Escreva notas de versão a partir dos commits desde a última tag. Use quando o usuário pedir notas de versão, uma entrada de changelog ou 'o que foi lançado'.

O que é claude-code-team-kit?

Esta skill automatiza a geração de notas de versão (release notes) para projetos de software, a partir do histórico de commits do Git. Ela é útil para desenvolvedores e equipes que precisam criar changelogs rápidos e bem estruturados, sem esforço manual. A skill suporta ambientes que integram Claude Code e ferramentas MCP, como o servidor `team-kit`. O fluxo de trabalho é: primeiro, identifica a última tag Git e coleta os commits desde ela; em seguida, utiliza uma ferramenta MCP (`group_commits`) para agrupar os commits por tipo (ex.: breaking changes, features, correções) e gerar uma saída em Markdown. Caso a ferramenta não esteja disponível, a skill realiza o agrupamento manualmente. O resultado final é uma nota de versão com versão numérica, data, parágrafo de destaque e seções agrupadas, escrita de forma legível para usuários finais, sem jargões técnicos ou ruídos de tickets.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JulienLerosty/claude-code-team-kit/tree/HEAD/template/skills/release-notes

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

Escrever notas de versão

  1. Encontre o intervalo: git describe --tags --abbrev=0 fornece a última tag. Se não houver, use todo o histórico.
  2. Liste os assuntos: git log <última-tag>..HEAD --no-merges --pretty=format:%s.
  3. Chame a ferramenta MCP group_commits (servidor team-kit) com esses assuntos. Ela retorna Markdown agrupado por tipo, com breaking changes primeiro. Se a ferramenta não estiver disponível, agrupe manualmente usando os mesmos cabeçalhos.
  4. Re-escreva para leitores, não para committers: uma frase simples por item, efeito visível para o usuário primeiro, sem ruído de tickets. Mescle duplicatas. Mantenha tudo sob "Breaking changes" e informe o que os usuários devem fazer.
  5. Saída:
## <versão> (<AAAA-MM-DD>)

<parágrafo de destaque de 2 a 3 frases>

<seções agrupadas>

Nunca invente mudanças que não estejam na lista de commits. Se um commit não estiver claro, leia seu diff (git show <sha> --stat) antes de descrevê-lo. Pergunte ao usuário pelo número da versão caso não consiga inferi-lo.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas