Handoff (Traspaso)
Handoff imprime una instantánea: el resumen de forma fija que la siguiente sesión lee primero. No archiva nada para la instantánea en sí, porque la instantánea es re-derivable de la rama predeterminada, los PRs fusionados y las notas de release, y un issue permanente que solo repite eso es ruido. Solo abre un issue para el trabajo que alguien hará: cada elemento del próximo ciclo se convierte en uno, verificado primero contra issues abiertos. Cualquier cosa aplazada por decisión se registra con su motivo donde la decisión ya reside, porque ese motivo es lo único que la siguiente sesión no puede reconstruir.
El arnés ya reanuda el historial completo de una sesión con --continue o --resume y mantiene la memoria automática local de la máquina, por lo que la instantánea solo lleva lo que esos no pueden: los próximos pasos y las decisiones que otra máquina o persona tiene que encontrar en el repositorio o sus issues. Los veredictos de compuertas y las tablas de conteo están deliberadamente fuera: ambos se vuelven a ejecutar en segundos contra el SHA registrado, y un número de re-ejecución no se puede falsificar como se podría hacer con uno copiado.
Este skill puede abrir y cerrar issues, por lo que nunca se activa por sí solo. Ejecútalo solo cuando se solicite, y solo en el punto en que una sesión realmente está terminando.
Ruta predeterminada
- Recopilar el estado del árbol: SHA, limpieza, árboles de trabajo, PRs abiertos.
- Listar lo que se envió desde la última etiqueta de release, o desde el inicio de la sesión si no hay etiqueta.
- Indicar un hallazgo principal, con la evidencia del mismo.
- Escribir la lista del próximo ciclo: ordenada, concreta, cada elemento con su razonamiento.
- Para cada elemento del próximo ciclo, verificar los issues abiertos en busca de uno que ya lo cubra; abrir un nuevo issue solo cuando ninguno lo haga, y registrar su número.
- Para cualquier cosa aplazada por decisión, registrar el motivo donde la decisión ya reside (el CHANGELOG, un registro de decisión, el comentario de código en el sitio); archivar un issue cerrado como no planeado solo cuando no exista tal lugar. Nunca hagas esto para algo que simplemente no se hizo; eso sigue siendo un elemento del próximo ciclo o se descarta en silencio.
- Limpieza heredada: si existe un issue abierto titulado "Session carryover", ciérralo con un comentario que apunte a los issues en los que se dividió su contenido.
- Imprimir la instantánea en la respuesta: el descargo de responsabilidad sobre caducidad, el estado del árbol, lo enviado, el hallazgo principal, la lista del próximo ciclo con números de issue, y los elementos aplazados por decisión con el lugar donde cada uno está registrado.
Recopilar el estado del árbol
Ejecuta estos comandos contra la rama predeterminada del repositorio, no contra la rama en la que la sesión se encuentre:
git rev-parse HEAD
git status --short
git worktree list
gh pr list --state open
Registra el SHA exacto, si el árbol está limpio, cuántos árboles de trabajo existen y cuántos PRs están abiertos. Un vago "las cosas están en buen estado" no es un estado del árbol; el SHA es el hecho que permite a la siguiente sesión confirmar que nada se movió debajo de él, y es contra lo que se vuelven a ejecutar todas las compuertas y conteos, razón por la cual ninguno de esos resultados se archiva en ningún lado.
Listar lo que se envió
Desde la última etiqueta de release (o, si no hay ninguna, desde el inicio de la sesión) hasta el HEAD actual, lista cada PR que se fusionó, una línea cada uno: número y qué hizo. Si no se fusionó nada, escribe "Ninguno" bajo este título. No omitas el título porque la lista esté vacía; una sección ausente se lee como "nadie verificó", no como "no se envió nada".
Indicar el hallazgo principal
Un hallazgo, expresado como una decisión con la evidencia que lo respalda, no un resumen de todo lo que sucedió. Si nada en esta sesión alcanzó ese nivel, escribe "No hay hallazgo principal en esta sesión" en lugar de inflar una observación menor para llenar el espacio.
Escribir la lista del próximo ciclo y convertir cada elemento en un issue
Una lista ordenada de acciones concretas siguientes, cada una con el razonamiento de una línea que la motiva. "Empieza aquí" significa que el primer elemento es genuinamente donde debería comenzar la siguiente sesión, no solo lo primero que viene a la mente.
Para cada elemento, busca issues abiertos antes de abrir uno nuevo:
gh issue list --search "<resumen del elemento>" --state open
Si un issue abierto ya lo cubre, usa su número. De lo contrario, abre uno:
gh issue create --title "<elemento>" --body "<el razonamiento de una línea>"
Un issue existe para el trabajo que alguien hará; un elemento del próximo ciclo que nunca se convierte en uno es una lista en prosa que la siguiente sesión tiene que creer en lugar de un rastreador sobre el que puede actuar.
Registrar aplazado por decisión donde reside la decisión
Algo que esta sesión eligió no hacer, a propósito, no es lo mismo que algo que simplemente no llegó a esta sesión. Solo el primer tipo se registra, con su motivo, en el lugar donde la decisión ya reside: la entrada del CHANGELOG que se envió a su alrededor, un registro de decisión, o el comentario de código en el sitio. Señala ese lugar en la instantánea. Solo cuando no exista tal lugar, archívalo como un issue abierto y cerrado:
gh issue create --title "<elemento>" --body "Aplazado por decisión: <el motivo>"
gh issue close <N> --reason "not planned"
El motivo es la línea que la siguiente sesión no puede reconstruir por sí sola; una cosa simplemente no hecha no necesita registro, ya que sigue siendo un elemento del próximo ciclo o nunca fue un compromiso.
Legado: retirar un issue abierto de carryover
Si un issue titulado "Session carryover" sigue abierto de antes de que cambiara esta práctica, ciérralo en lugar de dejarlo abierto para siempre:
gh issue list --search "Session carryover" --state open
gh issue close <N> --comment "Retirado: dividido en <números de issue de este traspaso>."
Omite este paso cuando no quede tal issue.
Imprimir la instantánea
Abre con el descargo de responsabilidad sobre caducidad, textual en espíritu: "Verifica cualquier cosa aquí antes de confiar en ello, esto es una instantánea y el repositorio se mueve." Luego, en orden: estado del árbol, PRs enviados, hallazgo principal, lista del próximo ciclo con el número de issue de cada elemento, elementos aplazados por decisión con el lugar donde cada uno está registrado. Imprime esto en la respuesta; nunca se archiva.
Válvulas de escape
- Sin CLI
gh, o no está autenticado. Imprime la instantánea y los elementos del próximo ciclo y aplazados por decisión de todas formas, di que no se pudo abrir ningún issue, y deja que la persona los archive manualmente. - No se envió nada, no hay hallazgo principal, no hay elementos del próximo ciclo, o no hay nada aplazado por decisión. Dilo claramente en esa sección en lugar de omitirla o rellenarla.
No hagas
- No ejecutes esto por sí solo. Puede abrir y cerrar issues y solo se activa bajo petición.
- No copies un veredicto de compuerta o una tabla de conteos en la instantánea; se vuelven a ejecutar desde el SHA registrado, y un lector confía en la re-ejecución, no en la copia.
- No abras un issue para un elemento del próximo ciclo sin verificar si ya existe uno que lo cubra.
- No abras un issue para algo simplemente no hecho; eso no es lo mismo que aplazado por decisión.
- No omitas el descargo de responsabilidad sobre caducidad porque la sesión se sienta actual; el siguiente lector no tiene forma de saberlo sin que se indique.
- No rellenes un hallazgo principal faltante o una lista de enviados vacía para que la instantánea parezca más sustancial de lo que fue la sesión.
- No dejes abierto un issue de "Session carryover" una vez que este traspaso se haya ejecutado.