ChenJinCloud/codex-closeout-archive

Codex Closeout Archive (Archivo de Cierre de Codex)

Usa este skill cuando el usuario solicite explícitamente cerrar, archivar, finalizar, cosechar o preservar una conversación de Codex. Convierte la conversación en un activo de proceso ligero y luego archiva la conversación.

La solicitud explícita de cierre del usuario es la decisión de activación. No reabras el debate sobre si el hilo merece preservación una vez que este skill ha sido invocado; cada cierre crea un activo de proceso conciso.

Por Qué Existe Este Skill

Los hilos de Codex a menudo contienen el trabajo real: cambios de intención, correcciones del usuario, rutas de evidencia, cambios en archivos, verificaciones de fuentes externas y decisiones finales. Si el hilo solo se archiva en la aplicación, la siguiente conversación puede perder el motivo por el cual las decisiones cambiaron.

Este skill preserva la pista reutilizable sin copiar la transcripción completa. Protege:

• Trazabilidad: trabajos futuros pueden encontrar la sesión original, archivos y evidencia.
• Continuidad de decisiones: giros clave y correcciones sobreviven a través de hilos.
• Cierre de baja fricción: cada final produce un artefacto útil, no un sistema de archivo grande.

No uses este skill simplemente porque una conversación se haya vuelto silenciosa o porque un agente quiera un cierre ordenado. Úsalo cuando cerrar, archivar, cosechar o preservar sea el siguiente estado solicitado por el usuario.

No Negociables

• Crea un activo de proceso cada vez que se use este skill.
• Usa la carpeta del proyecto relacionada por defecto.
• Mantén la línea de tiempo concisa: normalmente de 5 a 12 giros clave.
• Preserva los giros clave, correcciones del usuario, decisiones, archivos de salida y rutas de evidencia.
• No pegues una transcripción completa, contenido completo de Slack o DM, credenciales o exportaciones sensibles en el activo.
• No elimines, muevas ni reescribas los archivos de sesión originales de Codex.
• Después de escribir y verificar el activo, archiva la conversación actual a menos que el usuario solicite preparar el activo sin finalizar el hilo.

Flujo de trabajo

1. Resolver el destino

Elige la carpeta existente más pequeña que represente el proyecto actual.

Preferir, en orden:

1. Una carpeta de proyecto nombrada explícitamente por el usuario.
2. La raíz del repositorio o espacio de trabajo si el hilo es específico del repositorio.
3. Una carpeta duradera de proyecto, área u operaciones requerida por AGENTS.md local, instrucciones del espacio de trabajo o el sistema operativo del usuario.
4. El directorio de trabajo actual cuando no sea obvia una carpeta de proyecto más específica.

Haz una sola pregunta concisa solo si hay varias carpetas de proyecto plausibles y escribir en la incorrecta crearía trabajo de limpieza.

Si el entorno del usuario tiene un sistema de registro duradero, sigue las instrucciones de su AGENTS.md más cercano o equivalente antes de escribir.

Usa un nombre de archivo como:

<slug-del-tema>__codex-process-asset__YYYY-MM-DD.md

Si no hay un slug de tema obvio, usa:

codex-closeout__YYYY-MM-DD.md

2. Localizar evidencia

Registra las rutas de evidencia antes de escribir el activo.

Busca:

• Ruta actual del espacio de trabajo.
• Ruta del archivo JSONL de sesión de Codex actual o archivado.
• ID del hilo desde el payload session_meta del JSONL cuando esté disponible.
• Archivos creados, editados, movidos o verificados durante la conversación.
• Sistemas externos leídos o escritos, con enlaces o nombres de consulta cuando sea seguro preservarlos.

El archivo de sesión comúnmente se encuentra en:

~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
~/.codex/archived_sessions/rollout-*.jsonl

En Windows, ~ normalmente se resuelve en el directorio de perfil del usuario.

Si la sesión activa actual aún no es visible en disco, escríbelo explícitamente:

Evidencia de sesión Codex: hilo activo actual; JSONL no localizado al momento del cierre.

Ayudante opcional:

python scripts/extract_session_events.py --latest
python scripts/extract_session_events.py --session "/ruta/al/rollout.jsonl"

Usa el ayudante solo para obtener un inventario de eventos sin procesar. Selecciona tú mismo la línea de tiempo final.

3. Escribir el activo de proceso

Usa esta estructura:

# <Título> Activo de Proceso Codex

Fecha de archivo: YYYY-MM-DD
Hora de archivo: YYYY-MM-DD HH:mm+TZ
Espacio de trabajo: `<ruta absoluta>`
Proyecto local: `<ruta absoluta>`
Evidencia de sesión Codex: `<ruta absoluta o nota de hilo activo>`
ID del hilo: `<id o desconocido>`

## 1. Tipo de activo

Este archivo es un activo de proceso. Preserva la evolución clave de la conversación de Codex, no la transcripción completa sin procesar.

## 2. Por qué se preservó esto

- <por qué importa el cierre>
- <qué debería recuperar el lector futuro de este activo>

## 3. Línea de tiempo concisa

| Hora | Evento | Significado |
| --- | --- | --- |
| <hora> | <giro clave> | <por qué importó> |

## 4. Salidas y evidencia

| Tipo | Ruta / Enlace | Notas |
| --- | --- | --- |

## 5. Decisiones y correcciones

- <decisión final>
- <corrección importante del usuario>
- <límite aclarado>

## 6. Seguimientos abiertos

- <elemento o "Ninguno registrado">

## 7. Límites

- Los mensajes privados sin procesar, credenciales y contenido completo del JSONL de Codex no se copiaron.
- Los archivos de sesión originales se dejaron en su lugar.

## 8. Etiquetas de recuperación

- <etiqueta>

Mantén la prosa compacta. El activo debería ser útil de leer en uno o dos minutos.

4. Actualizar índices cercanos

Actualiza la superficie de descubrimiento más pequeña más cercana cuando exista:

• README.md o index.md en la carpeta del proyecto, si tiene una tabla de artefactos o mapa de fuentes.
• CHANGELOG.md en la carpeta del proyecto, si existe.
• Cualquier libro de registro o índice de proyecto requerido por AGENTS.md o política de espacio de trabajo equivalente.

No crees una nueva carpeta solo para cierres a menos que no exista una carpeta de proyecto razonable.

5. Verificar

Antes de finalizar:

• Confirma que el activo de proceso existe en la ruta prevista.
• Busca en el activo la ruta de evidencia de la sesión o la nota del hilo activo.
• Confirma que cualquier actualización de índice o changelog menciona el nuevo activo.
• Lista los archivos modificados.

6. Respuesta final y archivo

Responde brevemente con:

• Ruta del activo de proceso.
• Cualquier archivo de índice o changelog actualizado.
• Estado de la ruta de evidencia.
• Cualquier seguimiento que permanezca abierto.

Luego archiva la conversación actual. En Codex Desktop, emite la directiva de archivo como la última línea:

::archive{reason="Activo de proceso de cierre creado y conversación archivada"}

Solo omite la directiva de archivo si el usuario solicita preparar un cierre sin finalizar el hilo.

Ejemplos

Usa este skill para indicaciones como:

• "Finaliza este hilo de Codex y crea un activo de proceso trazable."
• "Archiva esta conversación, preservando las decisiones clave y las rutas de evidencia."
• "Cierra este hilo con un activo de proceso conciso."
• "Ejecuta el cierre y deja la ruta de salida y la evidencia de la sesión en la carpeta del proyecto."