cf-x/project-handoff-skill

Traspaso de proyecto

Crea una instantánea actual que permita a un nuevo agente continuar el trabajo sin la conversación. No borres la conversación por tu cuenta.

1. Resolver el destino

Determina el objetivo del traspaso antes de escribir:

1. Preferir un directorio explícito proporcionado con la invocación. Normalízalo y verifica que exista.
2. En caso contrario, inferir candidatos a partir de directorios y archivos realmente discutidos, leídos, creados o editados en esta sesión.
3. Tratar el directorio de trabajo actual, la raíz del espacio de trabajo de Codex, la raíz del control de versiones y los marcadores de proyecto como README.md, AGENTS.md, package.json o pyproject.toml solo como señales. Ninguno es autoritativo por sí mismo, y un proyecto no necesita usar Git.
4. Proceder sin preguntar solo cuando un candidato esté claramente respaldado por la evidencia de la sesión.
5. Si el destino falta o es ambiguo, mostrar los candidatos probables y hacer una pregunta concisa: HANDOFF.md 要写到哪个目录？ No adivines.

Si se modificaron varios proyectos independientes, prefiere un HANDOFF.md separado para cada uno y confirma sus destinos antes de escribir.

2. Inspeccionar el estado real

Después de resolver cada directorio de destino:

• Revisa el trabajo relevante de la sesión e inspecciona la estructura, instrucciones, documentación clave, archivos de implementación y resultados del destino.
• Si existe control de versiones, inspecciona su estado y los cambios relevantes. Si no existe, continúa sin tratarlo como un error.
• Usa evidencia de pruebas o validación existente. Ejecuta solo verificaciones ligeras y seguras cuando sea útil; no instales dependencias ni hagas cambios no relacionados en el proyecto.
• Lee un HANDOFF.md existente antes de actualizarlo. Conserva la información aún válida, reemplaza el estado obsoleto y mueve el trabajo recién completado fuera de la sección de trabajo pendiente.

No te bases solo en la memoria de la conversación cuando haya evidencia en el sistema de archivos.

3. Escribir HANDOFF.md

Crea o actualiza <destino-confirmado>/HANDOFF.md como un documento conciso del estado actual con las siguientes secciones:

# Traspaso de proyecto

> Actualizado: YYYY-MM-DD
> Destino: /ruta/absoluta/confirmada

## Estado y estructura actuales

## Casos completados

## Decisiones y convenciones

## Trabajo pendiente y siguiente paso exacto

## Obstáculos y callejones sin salida

## Validación, riesgos y preguntas abiertas

Aplica estas reglas:

• Proporciona a los casos completados resultados concretos y rutas de archivo o directorio relativas al proyecto.
• Registra decisiones, elecciones técnicas, convenciones de estilo o nomenclatura, y sus razones. Incluye ubicaciones de evidencia cuando sea útil.
• Haz que el trabajo pendiente sea procesable: prioridad, archivo o comando de inicio exacto, bloqueadores y la condición para su finalización.
• Registra enfoques fallidos y por qué fallaron para que el próximo agente no los repita.
• Indica las pruebas o comprobaciones ejecutadas y sus resultados. Di explícitamente qué no se verificó.
• Distingue los hechos observados de las afirmaciones e inferencias de la sesión. Marca la incertidumbre como 待确认; nunca inventes finalizaciones, decisiones o resultados de pruebas.
• Usa fechas absolutas, prosa concisa y rutas en lugar de narración estilo transcripción.
• Nunca incluyas credenciales, tokens, información personal privada, contenidos de archivos de entorno o registros sin procesar extensos.
• Mantén el archivo como la instantánea de traspaso más reciente, no como un historial de solo adición.

Modifica solo el HANDOFF.md previsto a menos que el usuario solicite explícitamente otros cambios.

4. Verificar e informar

Vuelve a leer el archivo terminado y confirma que:

• está en el directorio confirmado;
• cada sección requerida está presente;
• la siguiente acción es lo suficientemente específica para que un nuevo agente pueda comenzar de inmediato;
• las afirmaciones, rutas, fechas y el estado de validación concuerdan con la evidencia disponible;
• no se copió información sensible en el documento.

Informa la ruta escrita, un resumen breve y cualquier incertidumbre no resuelta. Detente ahí para que el usuario pueda revisar el traspaso antes de ejecutar manualmente /clear.