Changelog da App Store

Visão Geral

Gere um changelog abrangente, voltado para o usuário, a partir do histórico do git desde a última tag, e então traduza os commits em notas claras para a App Store.

Quando Usar

• Quando o usuário pedir o texto "Novidades" ou notas de lançamento da App Store a partir do histórico do git.
• Quando você precisar transformar commits brutos em marcadores concisos e voltados para o usuário.

Fluxo de Trabalho

1) Coletar alterações

• Execute scripts/collect_release_changes.sh a partir da raiz do repositório para coletar commits e arquivos tocados.
• Se necessário, passe uma tag ou ref específica: scripts/collect_release_changes.sh v1.2.3 HEAD.
• Se não houver tags, o script volta para o histórico completo.

2) Triagem para impacto no usuário

• Analise commits e arquivos para identificar mudanças visíveis ao usuário.
• Agrupe as mudanças por tema (Novos, Melhorados, Corrigidos) e deduplique sobreposições.
• Descarte trabalho interno (scripts de build, refatorações, atualizações de dependências, CI).

3) Rascunhar notas da App Store

• Escreva marcadores curtos e focados em benefícios para cada mudança visível ao usuário.
• Use verbos claros e linguagem simples; evite jargões internos.
• Prefira de 5 a 10 marcadores, a menos que o usuário solicite um número diferente.

4) Validar

• Garanta que cada marcador mapeie de volta para uma mudança real no intervalo.
• Verifique duplicatas e linguagem excessivamente técnica.
• Peça esclarecimentos se alguma mudança for ambígua ou possivelmente apenas interna.

Exemplos de Commit-para-Marcador

O seguinte mostra como mensagens de commit brutas são traduzidas em marcadores para a App Store:

Commits apenas internos que são descartados (sem impacto no usuário):

• chore: upgrade fastlane to 2.219
• refactor(network): extract URLSession wrapper into module
• ci: add nightly build job

Exemplo de Saída

What's New in Version 3.4

• Search your library hands-free with the new voice input option.
• Scrolling through your timeline is now smoother and faster.
• Fixed a login issue that could leave some users unexpectedly signed out.
• Added dark-mode support to the settings screen.
• Improved load times when opening large photo albums.

Formato da Saída

• Título (opcional): "Novidades" ou nome do produto + versão.
• Apenas lista de marcadores; uma frase por marcador.
• Mantenha os limites da loja se o usuário fornecer um.

Recursos

• scripts/collect_release_changes.sh: Coleta commits e arquivos tocados desde a última tag.
• references/release-notes-guidelines.md: Regras de linguagem, filtragem e QA para notas da App Store.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se as entradas necessárias, permissões, limites de segurança ou critérios de sucesso estiverem faltando.