La habilidad /handoff

Fuente: The /handoff Skill — traducción comunitaria no oficial al español.

Qué hace

handoff compacta la conversación actual en un documento de relevo: un único archivo markdown, escrito en el directorio temporal de tu sistema operativo en lugar de dentro del espacio de trabajo, que un agente nuevo puede leer para retomar el trabajo.

Lo que aporta es portabilidad, no compresión. Eso hace que la habilidad sea más específica de lo que parece. Solo necesitas un archivo cuando el trabajo tiene que viajar: a un entorno nuevo, a otro directorio, a un colega o a una subtarea que quieres bifurcar. Si nada va a viajar, no necesitas un relevo: seguir en la sesión, /clear, un subagente y /compact cubren el caso normal de fin de fase, y /compact lo cubre más a menudo que esta habilidad.

Cuándo recurrir a ella

La invocas escribiendo /handoff; el agente no la usará por su cuenta. Pasa una nota sobre para qué es la próxima sesión y el documento se escribirá para ese propósito.

Todo se reduce a cuatro situaciones:

Situación	Por qué un archivo
Cambiar de entorno (Claude → Codex)	El nuevo entorno no puede ver el contexto anterior
Moverse a otro directorio o repositorio	Un directorio de prototipo es el caso común
Enviar el trabajo a un colega	Necesita algo que pueda leer
Bifurcar una subtarea encontrada a mitad de fase	Tú sigues trabajando; un segundo agente toma la bifurcación

Para cualquier otra cosa (mismo entorno, mismo directorio, terminaste el interrogatorio y pasas a la implementación), /compact es la opción. ask-matt incluye el árbol ordenado con las cinco opciones en un límite de fase.

La bifurcación es el uso que la gente se salta

La descripción de la habilidad suena a reanudación de sesión: escribe un resumen, termina aquí, continúa allí. Leída así parece un /compact peor, por eso se pasa por alto. El caso de la bifurcación es el que vale la pena conocer. Tú te quedas en tu sesión y entregas una copia del contexto acumulado a un segundo agente que trabaja en paralelo.

Para eso sirve el rodeo por prototype. Estás en plena conversación de diseño, llegas a una pregunta que solo el código en ejecución puede resolver y no quieres gastar el hilo que construiste en averiguarlo. Pasas el relevo a una sesión de prototipo, obtienes la respuesta, la devuelves y la referencias desde el hilo original. Dos cruces, una conversación viva, nada reexplicado.

Tres de las cinco opciones en un límite de fase preservan cosas distintas: /compact preserva tu intención, /clear no preserva nada, /handoff preserva la capacidad del trabajo de moverse.

Qué viaja y qué no

El documento lleva el hilo vivo (qué está en curso, por qué y qué sigue) más una sección de habilidades sugeridas que indica a qué debería recurrir el siguiente agente. Los secretos se eliminan antes de escribirlo.

Lo que deliberadamente no lleva es nada que ya esté escrito. Especificaciones, planes, ADR, incidencias, commits y diffs se referencian por ruta o URL, nunca se copian. Eso mantiene el archivo pequeño y mantiene el detalle ya acordado en un solo lugar en vez de en dos que divergen.

Preguntas comunes

¿Relevo o compactado? /compact salvo que algo vaya a viajar. Seguir en la misma tarea es un compactado, no un relevo: mismo entorno, mismo directorio y necesitas seguir en el bucle es donde cae el árbol de límite de fase la mayoría de los días. La ventaja de /handoff no es que resuma mejor; es que el resultado es un archivo que puedes llevar a donde /compact no llega.

Entonces, ¿cuál es la diferencia real entre compact, clear y handoff? Se preservan tres cosas distintas. /compact comprime este contexto y te permite seguir en una ventana nueva: la intención sobrevive. /clear vacía la ventana y empieza de cero: correcto cuando todo lo anterior es desechable, e irreversible si no lo es. /handoff escribe un archivo portable: el trabajo sobrevive al traslado a otro lugar. Ten en cuenta que las tres convierten una fuente primaria (la conversación tal como ocurrió) en una fuente secundaria (un resumen de ella). Continuar es la única opción que no lo hace, por eso es la primera que hay que descartar.

¿Dónde quedó mi archivo de relevo? En el directorio temporal, que es la fricción más reportada con la habilidad: las rutas son largas, difieren por sistema operativo y en Windows los agentes a veces necesitan varios intentos para encontrar la correcta. Pide que te devuelvan la ruta y guárdala antes de seguir. Lo temporal es deliberado: un relevo es un documento de tránsito, no un artefacto que mantienes. Tampoco es duradero; ver la siguiente pregunta.

Mi relevo desapareció entre sesiones. Algunos entornos limpian lo temporal entre sesiones (Codex es el caso reportado), y /private/tmp se borra al reiniciar. Si la siguiente sesión no va a empezar en la próxima hora, o va a empezar en otro entorno, copia el archivo a un lugar duradero tú mismo en cuanto se escriba. Lo mismo aplica a todo lo que el documento señala: un pase que referencia otros archivos en lo temporal es un pase que el siguiente agente no puede seguir.

¿Cómo se lo entrego realmente al siguiente agente? Abre la sesión nueva y apúntala a la ruta: lee este archivo y continúa. Apunta al archivo en vez de pegar el resumen en un comando de shell: un resumen con comillas invertidas o $(...) se corrompe al interpolarse en claude "<resumen>", y el fallo habitual es un truncado silencioso en vez de un error, así que el nuevo agente empieza con un informe silenciosamente incompleto.

¿Es lo mismo que /branch, --fork-session o el /handoff integrado? Análogo, no idéntico, y /branch no es una habilidad distribuida aquí; /handoff es el nombre canónico. Una bifurcación hereda una copia exacta del contexto; esta habilidad produce una compresión dirigida a la siguiente tarea indicada, en un archivo. Donde una bifurcación basta (misma máquina, mismo entorno, mismo directorio), una bifurcación es menos trabajo. El archivo gana en cuanto el destino es un lugar al que la bifurcación no puede llegar.

¿Cuándo corresponde algo a CLAUDE.md en vez de al relevo? Pregunta si seguirá siendo verdad el mes que viene. CLAUDE.md es contexto permanente sobre el proyecto, cargado en cada sesión sea relevante o no. Un relevo trata de una pieza de trabajo en curso y muere cuando ese trabajo aterriza. Los hechos que hay que reexplicar una y otra vez son un problema de CLAUDE.md; una tarea a medio terminar es un relevo.

Captura el qué, no el porqué. Una crítica justa y repetida. Dos cosas ayudan. Pasa el argumento (dile para qué es la siguiente sesión) para que se conserve el razonamiento relevante para eso en vez de aplanarlo. Y vigila las afirmaciones seguras que la sesión nunca verificó: «X no está construido», «Y está listo». El siguiente agente trata el documento como un contrato y no lo volverá a comprobar, así que una creencia escrita como hecho se convierte en una premisa falsa para todo lo que sigue. Lee el documento antes de entregarlo y rebaja todo lo que solo asumiste.

¿Por qué es una habilidad y no un comando de barra? Ambos funcionan; sirven para situaciones distintas. Como habilidad se distribuye y se actualiza por la misma vía de instalación que todo lo demás aquí, que es lo que la hace compartible; la restricción de que el agente no la dispare por sí mismo la fija su frontmatter y no el mecanismo.

Funciona si

• El documento es una pequeña fracción de la conversación, y las especificaciones, incidencias y diffs aparecen en él como rutas y URL en vez de como texto copiado.
• Puedes leerlo en frío, sin la sesión original abierta, y saber qué hacer después.
• El agente nuevo empieza a trabajar en vez de pedirte que reexpliques la configuración.
• En el caso de bifurcación, tu sesión original sigue ahí intacta cuando vuelves a ella.
• La sección de habilidades sugeridas nombra la habilidad a la que habrías recurrido tú mismo.
• No hay en él ninguna clave, token o contraseña.

Dónde encaja

handoff es una habilidad independiente para usar en cualquier momento que vive en la costura entre sesiones más que dentro de una cadena de construcción, pero estrecha, y el mapa honesto es que la usarás menos que las otras cuatro opciones en un límite de fase. Su vecina más cercana es prototype, porque un prototipo vive en su propio directorio y el viaje de ida y vuelta es exactamente el cruce para el que existe esta habilidad. Cuando estés en un límite y dudes entre continuar, limpiar, pasar el relevo, delegar o compactar, ask-matt incluye el árbol que ordena esas cinco y te dirige al resto del conjunto.