kairyou/agent-tooling

Habilidades reutilizables para agentes, hooks, herramientas de barra de estado y asistentes de instalación para Codex, Claude Code y opencode.

¿Qué es agent-tooling?

Este skill define un generador de mensajes de commit (Commit Message Generator) para agentes de IA como Claude Code, opencode y Codex. Su propósito principal es analizar los cambios preparados (`git diff --staged`) y generar un mensaje de commit único, en una sola línea, que sigue el estándar Conventional Commits. La descripción debe estar en chino, y el mensaje se centra en exponer tanto el QUÉ (WHAT) como el PORQUÉ (WHY) de los cambios, evitando frases vacías y basándose exclusivamente en el código confirmado. El skill incluye reglas estrictas de contenido, como no inferir intenciones a partir de documentación o contexto conversacional que no coincida con el diff, y sugiere estrategias para resumir múltiples cambios o detectar cambios no relacionados. Es especialmente útil para equipos que buscan estandarizar sus mensajes de commit y mejorar la revisión del código.

Compatible con✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add kairyou/agent-tooling

Installed? Explore more Productividad y colaboración skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Generador de Mensajes de Commit

Este archivo es la única fuente de verdad; cada agente (Claude / opencode / codex) lo referencia a través de su propio shim delgado.

Flujo

  1. Ejecuta git diff --staged para ver los cambios preparados; si no hay cambios, muestra el mensaje «Primero haz git add» y detente.
  2. Según las reglas a continuación, genera un mensaje, muéstralo al usuario para confirmación; no lo confirmes directamente. Si el usuario necesita elegir, ofrécele directamente opciones de mensajes, no solo preguntes.
  3. Solo cuando el usuario confirme (por ejemplo, respondiendo «confirmar» u «ok») ejecuta git commit -m. A menos que el usuario lo solicite explícitamente, no hagas git push.

Reglas

Lee git diff --staged y genera un mensaje siguiendo Conventional Commits, explicando claramente el QUÉ y el PORQUÉ.

  • Título: type(scope): descripción, longitud total ≤ 74 caracteres, sin punto final, sin prefijos, comillas o bloques de código.
  • type: Elige el más acertado:
    • feat Nueva funcionalidad · fix Corrección de errores
    • refactor Refactorización que no cambia el comportamiento externo (ni nueva funcionalidad ni corrección) · perf Optimización de rendimiento
    • docs Solo documentación · style Ajustes de formato que no afectan la semántica (espacios en blanco/formato/punto y coma, etc.)
    • test Añadir o corregir pruebas · build Cambios en el sistema de construcción o dependencias externas · ci Configuración y scripts de CI
    • chore Otros cambios misceláneos que no tocan src/test · revert Revertir un commit anterior
  • scope (opcional): Nombre del módulo afectado, según las convenciones de este repositorio. Para monorepos, usa el nombre del directorio de la app/package; si abarca varios o no estás seguro, omítelo.
  • La descripción debe estar en chino: Una frase verbo-objeto que explique claramente «qué se hizo». No escribas frases vacías como «se modificaron varios archivos», «este commit», «esta modificación». Los identificadores (nombres de funciones/archivos/paquetes) deben mantenerse en inglés.
  • Solo una línea: En cualquier caso, el mensaje de commit tendrá solo una línea de título; no escribas cuerpo ni footer. Si es necesario, incluye el PORQUÉ en esa misma línea.
  • Breaking change: Usa type(scope)!: descripción con !, manteniendo una sola línea, no uses el footer BREAKING CHANGE.
  • Puntuación: Usa puntuación en inglés de ancho medio, no en ancho completo como ,。:().

Estrategia de Generación

Antes de escribir, piensa bien «¿qué problema resuelve este conjunto de cambios? / ¿cuál es la línea principal?» y luego escribe según el formato anterior:

  • Céntrate en la línea principal: Escribe solo la información necesaria para entender este commit; no enumeres nombres de archivo/función/configuración (a menos que sea clave).
  • Escanea cambios significativos: ¿Hay cambios en lógica, contratos, construcción, puertas de calidad o comportamiento visible para el usuario? Según esto, elige el tipo correcto y decide si usar ! para marcar un breaking change.

Disciplina de Contenido (De dónde viene el QUÉ)

Lo anterior es sobre formato; lo siguiente trata sobre veracidad del contenido: El mensaje solo debe contener hechos de código confirmados, no adivinar intenciones ni basarse en documentación para suponer:

  • Basarse principalmente en cambios de comportamiento en src/test: Los docs solo sirven como contexto auxiliar; no uses los docs para inferir el QUÉ (la documentación suele estar por delante o por detrás del código).
  • El contexto conversacional es mejor que los documentos: Los objetivos declarados explícitamente en el prompt reciente del usuario pueden usarse para determinar el PORQUÉ y elegir una redacción más precisa (por ejemplo, «corregir la verificación completa/typecheck»); pero el QUÉ y el scope todavía se basan en el diff preparado. Lo que el contexto menciona pero el diff no refleja no debe escribirse en el mensaje; si hay conflicto, el diff es la autoridad y se debe pedir confirmación.
  • Diffs de eliminación/renombrado: Si no se puede confirmar el propósito a partir de las relaciones de llamada del código, solo declara objetivamente (Eliminar X / Renombrar X a Y), no uses relaciones causales fuertes como «reemplazar / migrar a / cambiar a».
  • Múltiples cambios con un mismo objetivo (por ejemplo, una corrección de calidad/construcción del código): Da directamente un mensaje resumido. La división solo se ofrece como sugerencia opcional adjunta si mejora significativamente la revisión/reversión; no es un bloqueo por defecto.
  • Múltiples objetivos independientes claramente mezclados (funcionalidades/correcciones separadas): Ofrece todo de una vez: los mensajes divididos por unidad + un mensaje resumido conservador, para que el usuario elija entre dividir o resumir. No dejes el resumen para la siguiente ronda. Solo si no se puede resumir objetivamente el QUÉ global, enumera solo las unidades.
  • Cambios de origen dudoso o intención no clara (mezcla paralela, no se sabe por qué se modificaron): Emite «Estos archivos necesitan confirmación de origen/intención» en lugar de forzar un mensaje. Cuando no estés seguro, evita palabras vagas como «ordenar / ajustar» y prioriza pedir confirmación al usuario o dividir.

Skills relacionados