opção
LarLar Skill Revisão de código commit-standards

Formate as mensagens de commit de acordo com o padrão convencional de commits. Use quando: escrever mensagens de commit, executar o comando `git commit`, revisar o histórico de commits. Palavras-chave: commit, git, mensagem, convencional, 提交, 訊息, feat, fix, refactor.

...Expandir tudo
49
Tempo atualizado 29 de Junho de 2026

Sobre o commit-standards

A habilidade “commit-standards” garante a formatação consistente das mensagens de commit, seguindo o padrão de commits convencionais. Isso assegura que as mensagens de commit sejam claras, concisas e informativas. Ela resolve o problema de mensagens de commit inconsistentes ou vagas, oferecendo uma abordagem estruturada para a redação de mensagens, promovendo um histórico de commits mais organizado e compreensível. Esse padrão é particularmente útil para a colaboração em projetos de desenvolvimento de software, nos quais um controle de versão claro e a documentação das alterações são essenciais tanto para as equipes quanto para os sistemas automatizados.

A habilidade foi projetada para oferecer uma maneira simples e intuitiva de formatar mensagens de commit. Ela utiliza um conjunto de tipos de commit predefinidos, como “feat”, “fix”, “refactor” e outros, para categorizar as alterações de maneira eficaz. Os usuários podem seguir um formato rígido que inclui assunto, corpo e rodapé, com regras específicas para o comprimento da linha de assunto, uso de maiúsculas e pontuação. A habilidade também oferece suporte a formatos multilíngues de mensagens de commit, incluindo inglês, chinês tradicional e opções bilíngues, para atender a diversos ambientes de desenvolvimento.

Essa skill é ideal para desenvolvedores, equipes e colaboradores de código aberto que desejam manter uma abordagem consistente e profissional nas mensagens de commit. É particularmente benéfica para revisores de código, gerentes de controle de versão e quaisquer partes interessadas que dependam do histórico de commits para compreender as alterações no código. O sistema de configuração da skill permite uma personalização flexível com base nas preferências do projeto, tornando-a adaptável a diversos fluxos de trabalho e necessidades da equipe.

Perguntas frequentes

Como configuro o idioma das mensagens de commit?

Você pode configurar o idioma da mensagem de commit no arquivo 'CONTRIBUTING.md' do seu projeto. Se nenhuma configuração for encontrada, o sistema usará o inglês como padrão. As opções disponíveis são inglês, chinês tradicional e bilíngue.

O que acontece se minha mensagem de commit não seguir o padrão?

A skill não irá sinalizar erros automaticamente, mas incentiva as melhores práticas para garantir consistência e clareza. Cabe à sua equipe garantir que as mensagens sigam o formato.

Posso usar essa ferramenta para projetos que não sejam de desenvolvimento de software?

Sim, embora tenha sido projetada principalmente para projetos de software, qualquer projeto que exija um controle de versão claro e documentação das alterações pode se beneficiar dessa habilidade.

Essa skill oferece suporte a vários idiomas nas mensagens de commit?

Sim, a skill suporta mensagens de commit em inglês, chinês tradicional e bilíngues. Você pode escolher sua configuração de idioma preferida no arquivo 'CONTRIBUTING.md'.

Quais tipos de commit são suportados por essa habilidade?

A habilidade suporta vários tipos de commit, incluindo ‘feat’, ‘fix’, ‘refactor’, ‘docs’, ‘style’, ‘test’, ‘perf’, ‘build’, ‘ci’, ‘chore’, ‘revert’ e ‘security’.

Ver no GitHub

Commit Message Standards

This skill ensures consistent, meaningful commit messages following conventional commits.

Quick Reference

Basic Format

<type>(<scope>): <subject><body><footer>

Commit Types

English中文When to Use
feat新增New feature
fix修正Bug fix
refactor重構Code refactoring (no functional change)
docs文件Documentation only
style樣式Formatting (no code logic change)
test測試Adding or updating tests
perf效能Performance improvement
build建置Build system or dependencies
ci整合CI/CD pipeline changes
chore維護Maintenance tasks
revert回退Revert previous commit
security安全Security vulnerability fix

Subject Line Rules

  1. Length: ≤72 characters (50 ideal)
  2. Tense: Imperative mood ("Add feature" not "Added feature")
  3. Capitalization: First letter capitalized
  4. No period: Don't end with a period

Detailed Guidelines

For complete standards, see:

  • Conventional Commits Guide
  • Language Options

Examples

✅ Good Examples (English)

feat(auth): Add OAuth2 Google login supportfix(api): Resolve memory leak in user session cacherefactor(database): Extract query builder to separate classdocs(readme): Update installation instructions for Node 20

✅ Good Examples (中文)

新增(認證): 實作 OAuth2 Google 登入支援修正(API): 解決使用者 session 快取記憶體洩漏重構(資料庫): 提取查詢建構器為獨立類別

✅ Good Example (Bilingual)

feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援。Implement Google OAuth2 authentication flow for user login.實作 Google OAuth2 認證流程供使用者登入。Closes #123

❌ Bad Examples

fixed bug                    # Too vague, no scopefeat(auth): added google login  # Past tenseUpdate stuff.                # Period, vagueWIP                          # Not descriptive

Body Guidelines

Use the body to explain WHY the change was made:

fix(api): Resolve race condition in concurrent user updatesWhy this occurred:- Two simultaneous PUT requests could overwrite each other- No optimistic locking implementedWhat this fix does:- Add version field to User model- Return 409 Conflict if version mismatchFixes #789

Breaking Changes

Always document breaking changes in footer:

feat(api): Change user endpoint response formatBREAKING CHANGE: User API response format changedMigration guide:1. Update API clients to remove .data wrapper2. Use created_at instead of createdAt

Issue References

Closes #123    # Automatically closes issueFixes #456     # Automatically closes issueRefs #789      # Links without closing

Configuration Detection

This skill supports project-specific language configuration.

Detection Order

  1. Check CONTRIBUTING.md for "Commit Message Language" section
  2. If found, use the specified option (English / Traditional Chinese / Bilingual)
  3. If not found, default to English for maximum tool compatibility

First-Time Setup

If no configuration found and context is unclear:

  1. Ask the user: "This project hasn't configured commit message language preference. Which option would you like to use? (English / 中文 / Bilingual)"
  2. After user selection, suggest documenting in CONTRIBUTING.md:
## Commit Message LanguageThis project uses **[chosen option]** commit types.<!-- Options: English | Traditional Chinese | Bilingual -->

Configuration Example

In project's CONTRIBUTING.md:

## Commit Message LanguageThis project uses **English** commit types.### Allowed Typesfeat, fix, refactor, docs, style, test, perf, build, ci, chore, revert, security

License: CC BY 4.0 | Source: universal-dev-standards

Todos os arquivos

3 arquivos
SKILL.md 4.3k
Ver

Instalar commit-standards

Baixe e extraia os arquivos das habilidades para o diretório .claude/skills/.

Baixar ZIP

Clone o repositório e copie os arquivos da habilidade para o seu projeto.

git clone https://github.com/AsiaOstrich/universal-dev-skills/blob/main/skills/commit-standards/SKILL.md # Copy SKILL.md to your .claude/skills/ directory

Copiar Copiar
Configuração rápida: Copie a pasta da habilidade para .claude/skills/. O Claude detectará e utilizará automaticamente a habilidade

Habilidades relacionadas

code-simplify
Tempo atualizado 2 de Julho de 2026
requesting-code-review
Tempo atualizado 29 de Junho de 2026
Git Commit Helper
Tempo atualizado 29 de Junho de 2026
fetch-pr-review-comments
Tempo atualizado 29 de Junho de 2026
OR