¿Qué hace codex-session-handoff-skill (交接快照)?
Skill de Codex para transferencia de sesiones locales, que condensa tareas de larga duración con contexto casi lleno en instantáneas de transferencia locales.
Descripción
Este skill captura el estado actual de una tarea de larga duración en Codex cuando el contexto está cerca de alcanzar su límite máximo, y lo guarda como una instantánea de transferencia local. De esta manera, puedes cerrar la sesión actual y retomar el trabajo exactamente donde lo dejaste en una nueva sesión de Codex.
Características
- Generación de instantáneas: Crea un archivo Markdown o de datos estructurado que resume el progreso, archivos modificados, decisiones técnicas y próximos pasos.
- Transferencia de contexto: Permite pegar o cargar la instantánea en una nueva sesión para restaurar el contexto sin necesidad de reiniciar la tarea.
- Compatibilidad: Funciona con Codex (OpenAI) y puede adaptarse a otras plataformas similares.
- Almacenamiento local: Las instantáneas se guardan en el sistema de archivos local del usuario.
Uso
- Instala el skill siguiendo las instrucciones de configuración de tu plataforma.
- Cuando notes que el contexto de tu sesión actual se está llenando, ejecuta el comando proporcionado por el skill (por ejemplo,
session-handoff create). - El skill generará un archivo de instantánea en la ubicación predeterminada (por ejemplo,
./handoff-snapshots/). - Cierra la sesión actual y abre una nueva sesión de Codex.
- En la nueva sesión, carga la instantánea mediante el comando adecuado (por ejemplo,
session-handoff load).
Ejemplo
# Crear una instantánea
session-handoff create
# Cargar una instantánea en una nueva sesión
session-handoff load handoff-2025-03-21.json
Estructura de la instantánea
{
"timestamp": "2025-03-21T15:30:00Z",
"project": "mi-proyecto",
"branch": "main",
"archivos_modificados": ["src/main.py", "src/utils.py"],
"decisiones": [
"Se decidió usar FastAPI en lugar de Flask para mejor rendimiento"
],
"proximos_pasos": ["Implementar autenticación", "Agregar pruebas unitarias"],
"instrucciones": "Queda pendiente la configuración del router principal..."
}
Limitaciones
- La instantánea es un resumen textual; no se incluyen los datos completos de la sesión original.
- Es posible que sea necesario ajustar manualmente algunos detalles al reanudar la tarea.
Enlaces
- Repositorio: https://github.com/Liu-Bot24/codex-session-handoff-skill
- Problemas conocidos: Issues
Licencia
MIT