Fix y feature acotada con la skill task de Claude Code: el trabajo diario, sin spec

Hola, bienvenido. En esta lección vamos a añadir al plugin team la skill task, la que el equipo va a usar para el trabajo de cada día: un fix, un campo nuevo o un ajuste en una pantalla. La vamos a probar con 2 tareas sobre el listado de tickets de la lección anterior, un fix y una feature acotada, y la publicaremos en la versión 1.7.0 del plugin.

El día a día del equipo de Marta no son features grandes. Son tareas pequeñas, y cada persona las resuelve con Claude Code a su manera. Jorge pide siempre un plan antes de tocar nada. Aitor describe el cambio y deja que Claude lo haga de una vez. Uno pasa composer qa antes del commit y otro solo el test del archivo que ha cambiado. Y los mensajes de commit salen distintos según quién los escriba. Cada forma funciona para quien la usa, pero en las revisiones se nota: cada pull request llega con un nivel de comprobación distinto y el historial no se puede leer de corrido.

La skill task deja escrito el ciclo que el equipo ha acordado para ese trabajo. Recibe una descripción libre y, antes de tocar nada, decide si la tarea es trabajo diario o si necesita una spec.

El ciclo tiene 4 pasos, siempre en el mismo orden:

1. Plan: Claude lee el código que toca la tarea y propone en la conversación qué archivos crea o cambia, qué test reproduce el fallo o cubre lo nuevo y qué mensaje de commit va a usar. No edita nada hasta que confirmas.
2. Código: implementa el plan con las convenciones que carga CLAUDE.md. En un fix, escribe primero el test y comprueba que falla.
3. QA: usa la skill /team:qa si el plugin la tiene y, si no, ejecuta composer qa.
4. Commit: con la QA en verde, hace el commit con /team:conventional-commits.

El diagrama tiene una rama que en esta lección todavía no existe: la de la spec. En la siguiente lección escribiremos la spec de una feature con su plan y la partiremos en tareas. Cada tarea entrará en este mismo ciclo por el código, sin el paso del plan, porque el plan ya estará hecho. Así, el equipo usará una sola skill para el trabajo diario y para las tareas de una feature grande.

En el paso del plan hay un límite. Una skill no puede activar plan mode por su cuenta, porque su frontmatter no tiene ningún campo para el modo de permisos. Lo que sí puede hacer es pedirle a Claude que proponga el plan en la conversación y espere tu confirmación, y eso es lo que hace task. La diferencia con plan mode es que ahí Claude Code bloquea las ediciones hasta que apruebas el plan, y aquí la pausa depende de que Claude siga la instrucción de la skill.

En el paso de la QA, si te saltaste el bloque de QA, guardia y subagentes, tu plugin no tiene /team:qa y task ejecuta composer qa, que tienen todos los repos del equipo desde el contrato de scripts de la lección 4.