AGENT SKILL

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 git directo (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 add de archivos concretos (o git add -A). No hagas add -A por tu cuenta sin confirmación.
  • Lee el commit anterior con git log -1 --pretty=%s para 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. cdk mapea 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:

  1. opencode: si existe opencode.json en la raíz del repo o variables de entorno OPENCODE_* / OPEN_CODE_*.
  2. Claude Code: si existen variables CLAUDE_*, ANTHROPIC_*, o el contexto indica Claude Code (p. ej. existe .claude/ con settings.json del workspace).
  3. Fallback: si no se puede determinar, omitir el trailer (no inventar).

Detección del modelo:

  • opencode: leer opencode.json → campo model (o agent.*.model si está anidado).
  • Claude Code: variable ANTHROPIC_MODEL o CLAUDE_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.json contiene "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 log y 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

jimmybathrooms
jimmybathrooms/ozali

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".

★ 0
jimmybathrooms
jimmybathrooms/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".

★ 0
jimmybathrooms
jimmybathrooms/ozali

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.

★ 0
jimmybathrooms
jimmybathrooms/ozali

grill-with-docs

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

★ 0
jimmybathrooms
jimmybathrooms/ozali

grill-me

A relentless interview to sharpen a plan or design.

★ 0
jimmybathrooms
jimmybathrooms/ozali

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.

★ 0