Back to Details

commiter

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Generador de Commits

提交消息生成器

Cuando se te pida realizar un commit o generar un mensaje de commit, DEBES seguir estrictamente este formato.
当你被要求执行提交或生成提交消息时，必须严格遵循以下格式。

Estándar: Conventional Commits con Emojis

标准：搭配Emoji的Conventional Commits规范

Utilizamos Conventional Commits enriquecidos con Gitmoji como base. Todo el contenido debe estar en ESPAÑOL.
我们以Conventional Commits为基础，搭配Gitmoji表情符号来丰富提交消息。所有提交内容必须为西班牙语。

Formato

格式

text
<emoji> <tipo>(<alcance>): <descripción corta>

<cuerpo detallado y extenso>

<footer>
text
<emoji> <tipo>(<alcance>): <descripción corta>

<cuerpo detallado y extenso>

<footer>

Reglas Obligatorias

强制规则

  1. Emoji: El mensaje DEBE comenzar con el emoji correspondiente al tipo de cambio.
  2. Idioma: Todo el contenido del commit (descripción y cuerpo) debe estar en ESPAÑOL.
  3. Límite del Título: La primera línea (asunto) NO debe exceder los 50 caracteres (sin contar el emoji). Sé conciso.
  4. Descripción Extensa: El cuerpo del mensaje es OBLIGATORIO. Debes explicar detalladamente:
    • Qué se ha cambiado.
    • Por qué se ha hecho el cambio.
    • Detalles técnicos relevantes de la implementación.
  5. Tiempos Verbales: Usa el modo imperativo en el asunto (ej: "agrega", "corrige", "cambia"), no en pasado.
  1. 表情符号：提交消息必须以与变更类型对应的表情符号开头。
  2. 语言：提交消息的所有内容（描述和正文）必须为西班牙语。
  3. 标题长度限制：第一行（主题）不得超过50个字符（不含表情符号），请简洁表述。
  4. 详细描述：提交消息的正文为必填项，你需要详细说明：
    • 内容：变更了什么。
    • 原因：为什么进行此次变更。
    • 相关技术细节：实现过程中的技术要点。
  5. 动词时态：主题部分使用命令式语气（例如："agrega"（添加）、"corrige"（修复）、"cambia"（修改）），而非过去式。

Tipos Permitidos y Emojis

允许的类型及对应表情符号

EmojiTipoDescripción
✨
feat
Nueva característica (correlaciona con MINOR en SemVer).
🐛
fix
Corrección de un bug (correlaciona con PATCH en SemVer).
📚
docs
Cambios en la documentación.
💄
style
Cambios que no afectan el significado del código (espacios, formato, etc).
♻️
refactor
Cambio de código que no corrige bugs ni añade funcionalidades.
⚡
perf
Cambio de código que mejora el rendimiento.
✅
test
Añadir tests faltantes o corregir existentes.
📦
build
Cambios que afectan el sistema de construcción o dependencias externas.
👷
ci
Cambios en archivos de configuración y scripts de CI.
🔧
chore
Otros cambios que no modifican src o test files (ej. config de herramientas).
⏪
revert
Reversión de un commit anterior.
Emoji类型描述
✨
feat
新功能（对应SemVer中的MINOR版本）。
🐛
fix
修复Bug（对应SemVer中的PATCH版本）。
📚
docs
文档变更。
💄
style
不影响代码含义的变更（如空格、格式调整等）。
♻️
refactor
既不修复Bug也不添加新功能的代码重构。
⚡
perf
提升性能的代码变更。
✅
test
添加缺失的测试或修正现有测试。
📦
build
影响构建系统或外部依赖的变更。
👷
ci
变更CI配置文件或脚本。
🔧
chore
其他不修改源码或测试文件的变更（如工具配置）。
⏪
revert
回滚之前的提交。

Procedimiento

操作步骤

Cuando el usuario pida hacer commit:
  1. Analiza los cambios: Revisa qué archivos se modificaron y qué tipo de cambio representan.
  2. Selecciona el tipo: Elige el tipo de commit más apropiado de la tabla.
  3. Define el alcance: Identifica el módulo o componente afectado (opcional pero recomendado).
  4. Redacta el asunto: Máximo 50 caracteres, imperativo, en español.
  5. Redacta el cuerpo: Explica qué, por qué y detalles técnicos. Es obligatorio.
  6. Ejecuta el commit: Usa 
    git commit -m
    con el formato completo.
当用户要求提交时：
  1. 分析变更：查看修改的文件以及变更类型。
  2. 选择类型：从表格中选择最匹配的提交类型。
  3. 定义范围：确定受影响的模块或组件（可选但推荐）。
  4. 撰写主题：最多50个字符，命令式语气，西班牙语。
  5. 撰写正文：说明变更内容、原因及技术细节，此项为必填。
  6. 执行提交：使用
    git commit -m
    命令，按照完整格式提交。

Ejemplo Correcto

正确示例

text
✨ feat(auth): integra login social con Google

Se ha implementado la autenticación mediante OAuth2 con Google para facilitar
el acceso a nuevos usuarios.

Cambios principales:
- Agrega configuración de estrategia de Passport.js para Google.
- Crea nuevas rutas de callback en el controlador de autenticación.
- Actualiza el modelo de Usuario para almacenar el providerId.
- Ajusta la interfaz de login para incluir el botón de "Entrar con Google".

Motivación:
Reducir la fricción en el registro de usuarios y aumentar la conversión.
text
✨ feat(auth): integra login social con Google

Se ha implementado la autenticación mediante OAuth2 con Google para facilitar
el acceso a nuevos usuarios.

Cambios principales:
- Agrega configuración de estrategia de Passport.js para Google.
- Crea nuevas rutas de callback en el controlador de autenticación.
- Actualiza el modelo de Usuario para almacenar el providerId.
- Ajusta la interfaz de login para incluir el botón de "Entrar con Google".

Motivación:
Reducir la fricción en el registro de usuarios y aumentar la conversión.

Errores Comunes a Evitar

需避免的常见错误

  • fix: error login
    → Falta emoji, título vago, sin cuerpo.
  • 🐛 Fix: arregla login
    → Tipo en mayúscula, lo correcto es minúscula 
    fix
    .
  • ✨ feat(user): Update user logic
    → En inglés, debe ser en español.
  • Título que excede 50 caracteres → Acorta y mueve el detalle al cuerpo.
  • fix: error login
    → 缺少表情符号，标题模糊，无正文。
  • 🐛 Fix: arregla login
    → 类型使用大写，正确应为小写
    fix
    。
  • ✨ feat(user): Update user logic
    → 使用英语，必须为西班牙语。
  • 标题超过50个字符 → 简化标题，将细节移至正文。

Integración con el Workflow

与工作流集成

Después de ejecutar un commit exitoso, el router debe activar la skill 
changelog-updater
para registrar el cambio automáticamente en 
CHANGELOG.md
.
成功执行提交后，路由应触发
changelog-updater
Skill，自动将变更记录到
CHANGELOG.md
中。