Hogar
commit-standards
AsiaOstrich/universal-dev-skills
Formatea los mensajes de confirmación siguiendo el estándar convencional de confirmaciones. Úsalo cuando: redactes mensajes de confirmación, ejecutes «git commit» o revises el historial de confirmaciones. Palabras clave: confirmación, git, mensaje, convencional, 提交, 訊息, feat, fix, refactor.
...Expandir todoAcerca de «commit-standards»
La habilidad «commit-standards» garantiza un formato coherente en los mensajes de commit siguiendo el estándar convencional de commits. Esto asegura que los mensajes de commit sean claros, concisos e informativos. Resuelve el problema de los mensajes de commit incoherentes o vagos al proporcionar un enfoque estructurado para la redacción de mensajes, lo que favorece un historial de commits más organizado y comprensible. Este estándar resulta especialmente útil para la colaboración en proyectos de desarrollo de software, donde una gestión clara de las versiones y la documentación de los cambios son esenciales tanto para los equipos como para los sistemas automatizados.
La skill está diseñada para ofrecer una forma sencilla e intuitiva de dar formato a los mensajes de commit. Utiliza un conjunto de tipos de commit predefinidos, como «feat», «fix», «refactor» y otros, para clasificar los cambios de forma eficaz. Los usuarios pueden seguir un formato estricto que incluye un asunto, un cuerpo y un pie de página, con reglas específicas sobre la longitud de la línea de asunto, el uso de mayúsculas y la puntuación. La habilidad también admite formatos multilingües para los mensajes de confirmación, incluyendo inglés, chino tradicional y opciones bilingües, para adaptarse a diversos entornos de desarrollo.
Esta skill es ideal para desarrolladores, equipos y colaboradores de código abierto que deseen mantener un enfoque coherente y profesional en los mensajes de commit. Resulta especialmente útil para revisores de código, gestores de control de versiones y cualquier parte interesada que se base en el historial de commits para comprender los cambios en el código. El sistema de configuración de la habilidad permite una personalización flexible en función de las preferencias del proyecto, lo que la hace adaptable a diversos flujos de trabajo y necesidades del equipo.
Preguntas frecuentes
¿Cómo configuro el idioma de los mensajes de confirmación?
Puedes configurar el idioma de los mensajes de confirmación en el archivo «CONTRIBUTING.md» de tu proyecto. Si no se encuentra ninguna configuración, el sistema utilizará el inglés por defecto. Las opciones disponibles son inglés, chino tradicional y bilingüe.
¿Qué ocurre si mi mensaje de confirmación no sigue la norma?
La skill no detectará automáticamente ningún error, pero fomenta las mejores prácticas para garantizar la coherencia y la claridad. Depende de tu equipo asegurarse de que los mensajes se ajusten al formato.
¿Puedo utilizar esta herramienta para proyectos que no sean de desarrollo de software?
Sí, aunque está diseñada principalmente para proyectos de software, cualquier proyecto que requiera un control de versiones claro y una documentación de los cambios puede beneficiarse de esta herramienta.
¿Admite esta herramienta mensajes de confirmación en varios idiomas?
Sí, la herramienta admite mensajes de commit en inglés, chino tradicional y bilingües. Puedes elegir tu configuración de idioma preferida en el archivo «CONTRIBUTING.md».
¿Qué tipos de commit admite esta herramienta?
La herramienta admite varios tipos de commit, entre ellos «feat», «fix», «refactor», «docs», «style», «test», «perf», «build», «ci», «chore», «revert» y «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 los archivos
3 archivosInstalar commit-standards
Descarga y descomprime los archivos de las habilidades en tu directorio .claude/skills/.
Descargar ZIPClona el repositorio y copia los archivos de la habilidad a tu proyecto.
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
