Ativar quando:
<type>(<scope>): <description>
[body opcional]
[footer opcional]| Type | Uso |
|---|---|
feat | Nova funcionalidade |
fix | Correção de bug |
docs | Documentação |
style | Formatação (não afeta código) |
refactor | Refatoração |
test | Testes |
chore | Manutenção |
perf | Performance |
ci | CI/CD |
Área afetada: auth, api, ui, db, etc.
feat(auth): add JWT refresh token endpoint
fix(api): handle null response in user service
docs(readme): update installation instructions
refactor(utils): extract date formatting to helper
test(auth): add unit tests for login flow
chore(deps): update dependencies to latestgit status
git diff --statgit diffBaseado nas alterações, sugerir mensagem seguindo conventional commits.
Commit sugerido:
feat(auth): implement password reset
Arquivos: 3 modificados, 45+, 12-
**Posso fazer o commit?** [AGUARDAR RESPOSTA]git add -A
git commit -m "mensagem"Commit feito. **Quer fazer push?** [AGUARDAR RESPOSTA]git commitgit pushgit reset --hardgit rebasegit mergeANTES de commitar, SEMPRE atualizar o CHANGELOG:
CHANGELOG.md existe na raiz do projetoskills/workflow/changelog/SKILL.md[Unreleased]Ver skills/workflow/changelog/SKILL.md para detalhes completos.
# Sempre usar feature branches
git checkout -b feature/nome-da-feature
git checkout -b fix/nome-do-bug
git checkout -b refactor/nome-do-refactormain # produção (protegida)
├── develop # desenvolvimento (opcional)
├── feature/xxx # novas features
├── fix/xxx # correções de bugs
├── refactor/xxx # refatorações
└── hotfix/xxx # correções urgentes em produçãoPrincípios:
main sempre estável e deployávelmain (correções urgentes em produção)Fluxo:
mainHotfixes (exceção):
mainfix: ou hotfix: no commitfix: corrigir erro crítico em produção## Descrição
Breve descrição do que foi feito.
## Tipo de mudança
- [ ] Bug fix
- [ ] Nova feature
- [ ] Refatoração
- [ ] Documentação
## Checklist
- [ ] Testes adicionados/atualizados
- [ ] Documentação atualizada
- [ ] Código segue padrões do projeto
- [ ] Sem breaking changes (ou documentados)
- [ ] CHANGELOG.md atualizadov<major>.<minor>.<patch>git tag -a v1.2.0 -m "Release 1.2.0: Adicionar autenticação JWT"
git push origin v1.2.0Ver: skills/workflow/changelog/SKILL.md para processo completo de releases.
Fazer commits pequenos e frequentes:
Um commit = uma responsabilidade:
# ✅ Correto - commits separados
git commit -m "feat: adicionar validação de email"
git commit -m "refactor: mover lógica para controller"
git commit -m "test: adicionar testes para validação"
# ❌ Errado - tudo em um commit
git commit -m "feat: adicionar validação e refatorar controller e testes"# Atualizar branch local
git pull origin main
# Resolver conflitos manualmente
# Editar arquivos marcados com conflito
# Adicionar arquivos resolvidos
git add .
# Continuar merge
git commit[Unreleased]f84a77a
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.