commit-standards
AsiaOstrich/universal-dev-skills
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 tudoSobre 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’.
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
- Length: ≤72 characters (50 ideal)
- Tense: Imperative mood ("Add feature" not "Added feature")
- Capitalization: First letter capitalized
- 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 descriptiveBody 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 #789Breaking 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 createdAtIssue References
Closes #123 # Automatically closes issueFixes #456 # Automatically closes issueRefs #789 # Links without closingConfiguration Detection
This skill supports project-specific language configuration.
Detection Order
- Check
CONTRIBUTING.mdfor "Commit Message Language" section - If found, use the specified option (English / Traditional Chinese / Bilingual)
- If not found, default to English for maximum tool compatibility
First-Time Setup
If no configuration found and context is unclear:
- Ask the user: "This project hasn't configured commit message language preference. Which option would you like to use? (English / 中文 / Bilingual)"
- 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 arquivosInstalar commit-standards
Baixe e extraia os arquivos das habilidades para o diretório .claude/skills/.
Baixar ZIPClone 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





Lar
