Saltar al contenido principal

PARA TODOS — un tutorial. Síguelo de principio a fin y entregarás un cambio real.

Tu primer issue → PR

Esto es un tutorial: una primera corrida guiada. Al terminar habrás creado un issue rastreado, hecho un cambio pequeño en su propia rama, abierto un pull request y fusionado — el ciclo completo sobre el que está construido el kit. Toma unos diez minutos y no asume nada más allá de una instalación funcionando.

Si aún no has instalado el kit, haz Instalación primero y luego regresa.

:::note Qué necesitas

  • El kit instalado y /kit-init ya ejecutado en un proyecto git (ver Instalación).
  • El CLI de GitHub autenticado (gh auth status muestra un check verde). /kit-doctor lo verifica.
  • Un working tree limpio (git status no muestra nada por commitear) en tu rama de integración. :::

El ciclo que vas a aprender​

/kit-task-new    →  un issue de GitHub rastreado (#N)
/kit-task-start  →  una rama + worktree para #N
   …haz un cambio…
/kit-task-pr     →  un pull request que cierra #N
/kit-task-pr-merge  →  fusionado; de vuelta en tu rama de integración

Cada paso es un comando en el chat. Nunca sales de la conversación.

Paso 1 — Crea el issue​

Dile al kit qué quieres hacer. Mantenlo diminuto en esta primera corrida — corregir una errata o editar una línea del README es perfecto.

/kit-task-new

Describe el cambio cuando te lo pida (por ejemplo: "Corrige la errata en la introducción del README"). El kit crea un issue de GitHub, aplica etiquetas y lo agrega a tu tablero. Anota el número que devuelve — llámalo #N.

:::tip Elige algo trivial La meta aquí es aprender el ciclo, no escribir código. Mientras más pequeño el cambio, más rápido llegas a tu primer PR fusionado. :::

Paso 2 — Arranca el trabajo​

/kit-task-start N

Esto crea una rama desde tu rama de integración, un worktree aislado para la tarea, y marca el issue como In Progress en el tablero. Ahora estás en task/N-… — tu cambio queda en una caja de arena y no puede afectar el trabajo de nadie más.

Paso 3 — Haz el cambio​

Haz tu pequeña edición — pídeselo al kit en lenguaje natural, o edita el archivo tú mismo. Para el ejemplo del README:

Corrige la errata en el primer párrafo de README.md.

Limita el cambio a una sola edición obvia. Guarda el archivo.

Paso 4 — Abre el pull request​

/kit-task-pr N

El kit commitea tu cambio, empuja la rama y abre un pull request cuyo cuerpo dice Closes #N. El PR hereda el título, las etiquetas y el milestone del issue — no llenas ningún formulario. Imprime la URL del PR; ábrela si quieres ver el diff.

Paso 5 — Fusiona​

Cuando estés conforme con el diff:

/kit-task-pr-merge

Esto hace squash-merge del PR, te regresa a tu rama de integración y baja el resultado fusionado. El issue se cierra automáticamente (decía Closes #N). Tu cambio está en vivo y tu working tree quedó limpio de nuevo.

:::info Acabas de hacer el ciclo completo Issue → rama → cambio → PR → merge. Esa es la misma forma que toma cada cambio, desde una errata hasta una funcionalidad. :::

A dónde seguir​

  • Trabajo más grande. Cuando un cambio es demasiado grande para un PR diminuto, se convierte en un effort — un issue padre, sub-issues, una rama, un PR. Lee el Modelo de effort.
  • Ajusta el kit. Agrega o modifica agentes, skills y reglas con /kit-customize.
  • Mira todo lo que puedes ejecutar. Recorre el overview para la superficie completa de comandos.

Ya conoces el ciclo central. Todo lo demás en el kit es una versión más rica de estos cinco pasos.