handoff-skill

Handoff es una habilidad de agente dirigida a repositorios donde el mismo trabajo se retoma en varias sesiones de agentes de IA. Su planteamiento del problema es que una tarea sin marcar en una lista no está necesariamente sin terminar, ya que otro agente puede haberla implementado, un cambio de código puede haberla satisfecho, el requisito puede haber cambiado o alguien más aún posee los archivos afectados. La habilidad utiliza un archivo de registro compartido, HANDOFF.md, junto con evidencia del repositorio como el historial de Git, código actual, pruebas y propiedad, para decidir qué está pendiente. El flujo de trabajo registrado tiene seis etapas. El preámbulo reclama un nombre de sesión y devuelve, a partir de una instantánea versionada, cada entrada abierta del registro con sus pasos, un resumen de entradas recientes terminadas, errores de estructura y el estado de Git. La admisión convierte cada solicitud en una entrada de tarea fechada con casillas separadas de En curso y Completadas, pasos, verificación y una línea de estado. Una auditoría progresiva sopesa entradas posteriores del registro, confirmaciones, código fuente actual, propiedad en vivo y las casillas de la entrada anterior, clasificando luego el alcance efectivo como Completo, Parcialmente completo, Superado, Inacabado o Desconocido, anotando en lugar de eliminar para preservar el historial. La resolución de propiedad pregunta si el trabajo elegible debe terminarse primero o dejarse con su propietario actual antes de que comience una nueva tarea, a menos que el usuario ya haya dado un orden explícito. Las escrituras seguras enrutan las actualizaciones mediante una comparación e intercambio bloqueados cuando los pares pueden escribir en el mismo árbol. Finalmente, el agente prepara rutas explícitas, registra la verificación y los identificadores de confirmación, y deja un estado desde el cual el siguiente agente puede continuar. Las entradas del registro registran una etiqueta de propietario, un campo de arnés opcional (autodetectado para Claude Code, Codex, Cursor y VS Code, anulable mediante una variable de entorno), casillas de estado, pasos marcados y desmarcados, una línea de estado y una siguiente acción. Las tareas completadas mantienen ambas casillas marcadas para que el registro se lea como historial. Las sesiones reclaman nombres de una lista de cien figuras mitológicas, entregados por orden de llegada y sin duplicar nunca a un propietario ya presente en el registro. El proyecto incluye una CLI de Python de biblioteca estándar con un panel curses en vivo para agentes y tareas, que muestra las tareas completadas frente al total, recuentos en curso y pendientes, el progreso de los pasos y, cuando se registra, el arnés que usó cada propietario. También puede ejecutarse en un modo de instantánea de texto plano, un modo de solo lectura o detrás de un lanzador PATH que resuelve la instalación fija por versión. El panel admite cortar una tarea y pegarla en otro propietario, lo que reescribe la etiqueta de propietario y registra el movimiento bajo el mismo bloqueo. Un script de barra de estado imprime una fila de progreso de una sola línea y está documentado para funcionar con las líneas de estado de Claude Code, Grok CLI y Kimi Code, con un contenedor tmux para Codex y otras CLI. Un canal de agente local almacena mensajes y reconocimientos en un archivo SQLite ignorado por Git y limitado a una sola extracción, sin daemon ni socket. Los agentes pueden enviar preguntas, responder, informar disponibilidad, liberar su grupo inacabado, declarar un plazo de renovación en un arrendamiento y utilizar intercambios de nonces de desafío/atestación para demostrar que otro agente responde. La instalación se ofrece como un complemento de Claude Code desde un mercado, una importación del mercado de Cursor o mediante npx skills add para otros hosts; el README establece que se requieren Git, un agente con acceso de lectura/escritura al repositorio y Python 3.9+, sin clave de API, servicio alojado ni paquete de Python de terceros. La única función que abandona la máquina es un paso de publicación ssh opcional que permanece inactivo hasta que existe un archivo de configuración. Cinco comandos de barra diagonal cubren la inicialización, visualización, estado, continuación y purga del registro, y el README señala los límites de Windows para el panel curses y la ruta rápida de la barra de estado.