CommunityProgramación y desarrollogithub.com

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.

¿Qué es codex-session-handoff-skill (交接快照)?

Este skill de Codex, llamado 'codex-session-handoff-skill', está diseñado para manejar la transferencia de sesiones de trabajo con un asistente de IA (como Codex). Su función principal es tomar tareas de larga duración que están a punto de exceder el límite de contexto del modelo y comprimirlas en 'instantáneas de transferencia' locales. Esto permite que el desarrollador continúe su trabajo en una nueva sesión sin perder el progreso ni el contexto crítico, evitando reinicios costosos. El skill genera un archivo de resumen estructurado (por ejemplo, en Markdown o formato de datos) que captura el estado actual del proyecto, las decisiones tomadas, los archivos modificados y las instrucciones pendientes. Está optimizado para plataformas como Codex de OpenAI y se puede integrar fácilmente en flujos de trabajo de desarrollo, proporcionando una solución práctica para mantener la continuidad en proyectos complejos y de larga duración.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add Liu-Bot24/codex-session-handoff-skill

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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

  1. Instala el skill siguiendo las instrucciones de configuración de tu plataforma.
  2. 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).
  3. El skill generará un archivo de instantánea en la ubicación predeterminada (por ejemplo, ./handoff-snapshots/).
  4. Cierra la sesión actual y abre una nueva sesión de Codex.
  5. 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

Licencia

MIT

Skills relacionados