handoff

Descripción general de handoff

Qué hace handoff

handoff convierte la conversación actual en un documento de traspaso conciso para el siguiente agente. Está pensado para esos momentos en los que necesitas continuidad rápida: resumir lo importante, lo que se decidió y qué debería hacer la siguiente sesión a continuación.

Quién debería usarlo

Usa handoff si vas a transferir trabajo entre sesiones, delegar una tarea a otro agente o preparar un briefing listo para IA para seguir ejecutando. Es especialmente útil para trabajo en repositorios, tareas de producto de varios pasos y cualquier flujo en el que perder contexto provoque rehacer trabajo.

En qué se diferencia

El valor clave de handoff no es un resumen genérico. Pide un documento accionable que evita duplicar artefactos existentes y dirige al siguiente agente al material fuente correcto mediante ruta o URL. Eso lo hace más útil que un simple prompt de “resume este chat”.

Cómo usar handoff

Instala handoff y empieza por el archivo del skill

Para una instalación típica de handoff, añade el skill desde el repo y abre primero SKILL.md:

npx skills add mattpocock/skills --skill handoff

Después, lee SKILL.md para entender la forma exacta del resultado y su comportamiento antes de aplicarlo a tu propio flujo de trabajo.

Dale al skill un objetivo real para la siguiente sesión

El patrón de handoff usage funciona mejor cuando le indicas para qué sirve la siguiente sesión. La pista de argumento del repositorio espera una frase de enfoque como:

• “Continúa depurando el fallo de compilación de TypeScript en el paquete de pagos.”
• “Retoma la revisión del texto de la landing y cierra las variantes de la CTA.”
• “Reanuda la implementación del flujo de auth después de los cambios en el esquema de la API.”

Una petición vaga como “haz un handoff” produce un documento más débil. Un objetivo claro para la siguiente sesión ayuda al skill a decidir qué debe incluirse en el handoff y qué se puede omitir.

Lee los archivos correctos antes de escribir

El skill es intencionalmente ligero, así que la fuente principal es SKILL.md. Revisa también cualquier artefacto cercano del proyecto que el skill mencione, en lugar de copiarlo dentro del handoff:

• README.md
• AGENTS.md
• metadata.json
• carpetas rules/, resources/, references/ o scripts/ si existen

Si el trabajo ya está recogido en un PRD, plan, ADR, issue, diff o commit, el handoff debería enlazar a eso en vez de repetirlo. Así el documento se mantiene corto y el siguiente agente trabaja más rápido.

Escribe para el siguiente agente, no para ti

Un documento handoff sólido suele incluir:

• el objetivo y el estado actuales
• decisiones ya tomadas
• preguntas abiertas o bloqueos
• rutas exactas de archivos, URLs o artefactos que revisar después
• cualquier skill sugerido para la sesión de seguimiento

Este es el principio principal de uso: deja obvio el siguiente paso sin volver a explicar toda la historia del proyecto.

Preguntas frecuentes sobre handoff

¿handoff es solo para conversaciones largas?

No. handoff es útil siempre que el siguiente agente deba empezar con menos tiempo de preparación, incluso después de un intercambio breve pero complejo. Es más valioso cuando hay decisiones, dependencias o artefactos fuente que conviene preservar.

¿En qué se diferencia de un prompt normal?

Un prompt normal suele pedir un resumen y quedarse ahí. El skill handoff es más opinado: está pensado para producir un documento de transferencia, evitar duplicaciones y señalar los artefactos canónicos que debe usar la siguiente sesión.

¿handoff es adecuado para principiantes?

Sí, si puedes nombrar con claridad la siguiente tarea. Las personas principiantes obtienen mejores resultados cuando dan una frase de enfoque simple y dejan que el skill organice el traspaso en un briefing útil.

¿Cuándo no debería usar handoff?

No uses handoff cuando la siguiente sesión no necesite continuidad, o cuando el contexto necesario ya esté completamente capturado en un artefacto existente que el siguiente agente vaya a leer directamente.

Cómo mejorar el skill handoff

Haz específico el objetivo de la siguiente sesión

La calidad del resultado de handoff depende de lo bien que definas la siguiente sesión. Las mejores entradas nombran la fase exacta, el subsistema o el punto de decisión, no solo el proyecto en general.

Señala artefactos fuente de referencia

Si el trabajo actual vive en un doc, issue o diff, incluye esas referencias para que el handoff se mantenga compacto. Esto importa porque el skill está diseñado para no duplicar material que ya está guardado en otro sitio.

Incluye restricciones y preguntas abiertas

Los documentos handoff más útiles recogen lo que sigue sin resolverse: bloqueos de implementación, trade-offs, observaciones de revisión o supuestos que todavía necesitan confirmación. Esos detalles ayudan al siguiente agente a no repetir callejones sin salida anteriores.

Sugiere skills de seguimiento cuando tenga sentido

El skill pide explícitamente sugerencias de skills para la siguiente sesión, así que inclúyelas cuando la siguiente tarea se beneficie de un flujo distinto. Por ejemplo, un handoff puede orientar al siguiente agente hacia skills de planificación, codificación o revisión según el trabajo que quede pendiente.