ozali-commit
Genera un "commit summary" convencional (feat/fix/hotfix/refactor) con prefijo, scope y descripción a partir de los cambios EN STAGE y commitea tras tu aprobación. Úsala cuando el usuario quiera "commitea", "haz el commit", "genera el mensaje de commit", "cierra el hito con commit", o cuando otra skill (p. ej. cdk) cierre un hito. Acepta `--skip-ci` para que el commit no dispare el CI/deploy (agrega `[skip ci]`).
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- ozali-commit
- model
- haiku
- description
- Genera un "commit summary" convencional (feat/fix/hotfix/refactor) con prefijo, scope y descripción a partir de los cambios EN STAGE y commitea tras tu aprobación. Úsala cuando el usuario quiera "commitea", "haz el commit", "genera el mensaje de commit", "cierra el hito con commit", o cuando otra skill (p. ej. cdk) cierre un hito. Acepta `--skip-ci` para que el commit no dispare el CI/deploy (agrega `[skip ci]`).
03 SKILL.md 正文
Skill: ozali-commit
ozali-commit produce el mensaje de commit de un cambio siguiendo
Conventional Commits y lo commitea tras tu aprobación.
Es la skill de commit vigente del ecosistema ozali.
cdk la invoca en el cierre de cada hito, pero también puedes usarla suelta en cualquier repo.
Regla de oro: nunca commitea sin tu aprobación explícita (🛑 GATE de mensaje). El GATE del mensaje es independiente del GATE del plan de
cdk.
Cero dependencias: usa
gitdirecto (ya habilitado en el perfil base de permisos de ozali:Bash(git add *),Bash(git commit *),Bash(git status),Bash(git diff *),Bash(git log *)). No requiere herramientas externas.
Flujo
1. Inspecciona el stage
git status --short— qué hay staged vs sin stage.git diff --cached— el contenido EN STAGE (la fuente de verdad del mensaje).- Si no hay nada en stage: dilo y pregunta si quieres que haga
git addde archivos concretos (ogit add -A). No hagasadd -Apor tu cuenta sin confirmación. - Lee el commit anterior con
git log -1 --pretty=%spara mantener el estilo del repo.
2. Determina el tipo y el scope
A partir del diff EN STAGE, clasifica el cambio:
| Tipo | Cuándo |
|---|---|
feat |
nueva funcionalidad / capacidad |
fix |
corrección de bug |
hotfix |
corrección urgente en caliente |
refactor |
reestructura sin cambiar comportamiento |
docs |
solo documentación |
test |
solo pruebas |
chore |
mantenimiento (deps, config, build) |
- Scope = módulo/área tocada del repo (derívalo de las rutas en stage; ej.
cobranza,cli,auth). Si abarca varias áreas, usa la más representativa o un scope general. - Si la skill que invoca aporta tipo/scope (p. ej.
cdkmapea feature→feat, bugfix→fix, hotfix→hotfix, refactor→refactor), respétalos.
3. Redacta el mensaje
Formato: tipo(scope): descripción en imperativo, ≤ 72 chars. Cuerpo opcional (qué/por qué, no el
cómo). No inventes cambios que no estén en el diff. Idioma: el del repo (mira git log).
feat(cobranza): agrega validación de RFC en alta de cotización
- valida formato y dígito verificador antes de persistir
- cubre el caso de RFC genérico (XAXX010101000)
3.5 Co-authored-by (agente y modelo)
Agrega automáticamente un trailer Co-authored-by: al final del mensaje para identificar
el agente de IA y el modelo que generó el cambio. Esto mejora la trazabilidad del
equipo y facilita la telemetría posterior.
Detección del agente:
- opencode: si existe
opencode.jsonen la raíz del repo o variables de entornoOPENCODE_*/OPEN_CODE_*. - Claude Code: si existen variables
CLAUDE_*,ANTHROPIC_*, o el contexto indica Claude Code (p. ej. existe.claude/consettings.jsondel workspace). - Fallback: si no se puede determinar, omitir el trailer (no inventar).
Detección del modelo:
- opencode: leer
opencode.json→ campomodel(oagent.*.modelsi está anidado). - Claude Code: variable
ANTHROPIC_MODELoCLAUDE_MODEL; si no está, inferir del contexto (el modelo que responde actualmente — sin inventar). - Fallback:
unknown(si el modelo no se detecta, omitir el trailer).
Formato del trailer:
Co-authored-by: {agente} <{modelo}@{dominio}>
| Agente | Dominio | Ejemplo |
|---|---|---|
| Claude Code | anthropic.com |
Co-authored-by: Claude Code <claude-opus-4@anthropic.com> |
| opencode | opencode.ai |
Co-authored-by: opencode <kimi-k2.6@opencode.ai> |
Reglas:
- El trailer se coloca al final del mensaje, separado del cuerpo por una línea en blanco (formato Git trailers).
- Opt-out: si
.ozali/config.jsoncontiene"coAuthor": false, omitir este paso completamente. - Si no se detecta tanto agente como modelo con confianza, omitir el trailer.
- No inventar agentes ni modelos: mejor sin trailer que con datos falsos.
Ejemplo completo del mensaje:
feat(cobranza): agrega validación de RFC en alta de cotización
- valida formato y dígito verificador antes de persistir
- cubre el caso de RFC genérico (XAXX010101000)
Co-authored-by: Claude Code <claude-opus-4@anthropic.com>
3.6 Flag --skip-ci (opcional)
Si la skill se invoca con --skip-ci (p. ej. /ozali-commit --skip-ci, o cdk lo pasa al cerrar
un hito), el commit no debe disparar el CI/deploy: agrega la marca [skip ci] al final de la
primera línea del mensaje.
ci(deploy): omite deploy en cambios solo de IA/ozali [skip ci]
Reglas:
- Escríbela exactamente
[skip ci](con espacio). GitHub no reconoce[skip-ci]con guion: el commit se vería omitido pero el workflow correría igual. (También valen[ci skip],[no ci],[skip actions]y[actions skip]; usa siempre[skip ci]por consistencia.) - La primera línea sigue en ≤ 72 chars incluida la marca: acorta la descripción, no la marca.
- Sin el flag, no agregues la marca (nunca la pongas por iniciativa propia).
- La marca va en el mensaje de commit de la cabeza del push: si se hacen varios commits y se sube todo junto, solo cuenta el último.
- Avisa en el GATE (una línea): "
[skip ci]omite TODO el CI del push (tests y deploy), no solo el deploy. Úsalo solo en cambios sin impacto en el build." No pidas confirmación extra: el GATE de mensaje ya es la aprobación.
4. 🛑 GATE de mensaje
Presenta el mensaje completo (con [skip ci] si se pidió --skip-ci) como texto visible y espera aprobación. Si el usuario pide ajustes,
itera. No commitees hasta el "ok".
5. Commitea
Tras la aprobación:
git commit -m "tipo(scope): descripción" [-m "cuerpo…"]
- Commitea solo lo que está en stage (no añadas archivos no aprobados).
- No hagas
git push(es destructivo/saliente y está denegado por defecto): si el usuario lo quiere, recuérdaselo para que lo haga él. - Reporta el hash corto resultante (
git rev-parse --short HEAD).
Notas
- Si el repo usa una convención propia (gitmoji, prefijos de ticket), detéctala desde
git logy síguela. - Si el cambio es demasiado grande/heterogéneo para un solo mensaje coherente, sugiere dividir en varios commits (pero no lo hagas sin aprobación).
04 同仓库更多 Skills
ozali
Diagnostica, calibra y planifica la skill `cdk` de un proyecto. Úsala cuando quieras "preparar cdk", "calibrar el proyecto", "generar la estructura de agentes", "arrancar ozali desde cero" o invocar "ozali".
python-utilitario
Crea utilitarios Python autocontenidos que se ejecutan en su propio entorno virtual mediante UN SOLO script .sh, sin instalar librerías en la PC del usuario. Genera la carpeta completa - script.py, run_script.sh, requirements.txt, README.md, .gitignore - con log por corrida, --dry-run y códigos de salida estándar. También empaqueta un .py suelto ya existente. Úsala cuando el usuario quiera "hazme un utilitario", "un script de python empaquetado", "un proceso de carga masiva/importación", "que corra en su venv", "que no instale nada en mi máquina", "empaqueta este .py" o "arma la estructura de este script".
grilling
Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
grill-with-docs
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
grill-me
A relentless interview to sharpen a plan or design.
domain-modeling
Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a CONTEXT.md, or recording or editing an ADR.