ChenJinCloud/codex-closeout-archive

Codex Closeout Archive

Utilisez cette compétence lorsque l'utilisateur demande explicitement de fermer, archiver, terminer, récolter ou préserver une conversation Codex. Elle transforme la conversation en un actif de processus léger, puis archive la conversation.

La demande explicite de clôture de l'utilisateur constitue la décision d'assetisation. Ne revenez pas sur la question de savoir si le fil mérite d'être préservé une fois cette compétence invoquée ; chaque clôture crée un actif de processus concis.

Pourquoi cette compétence existe

Les fils Codex contiennent souvent le travail réel : changements d'intention, corrections de l'utilisateur, chemins de preuve, modifications de fichiers, vérifications de sources externes et décisions finales. Si le fil n'est qu'archivé dans l'application, la conversation suivante peut perdre la raison pour laquelle les décisions ont changé.

Cette compétence préserve la piste réutilisable sans copier l'intégralité du transcript. Elle protège :

• Traçabilité : les travaux futurs peuvent retrouver la session, les fichiers et les preuves d'origine.
• Continuité des décisions : les tournants clés et les corrections survivent d'un fil à l'autre.
• Clôture à faible friction : chaque fin produit un artefact utile, et non un système d'archivage lourd.

N'utilisez pas cette compétence simplement parce qu'une conversation est devenue silencieuse ou parce qu'un agent souhaite une fermeture propre. Utilisez-la lorsque la clôture, l'archivage, la récolte ou la préservation est l'état suivant demandé par l'utilisateur.

Non-négociables

• Créez un actif de processus à chaque utilisation de cette compétence.
• Utilisez le dossier du projet associé par défaut.
• Gardez la chronologie concise : généralement 5 à 12 tournants clés.
• Préservez les tournants clés, les corrections de l'utilisateur, les décisions, les fichiers de sortie et les chemins de preuve.
• Ne collez pas un transcript brut complet, un contenu complet de Slack ou de messages privés, des identifiants ou des exports sensibles dans l'actif.
• Ne supprimez, ne déplacez et ne réécrivez pas les fichiers de session Codex d'origine.
• Après la rédaction et la vérification de l'actif, archivez la conversation en cours, sauf si l'utilisateur demande de préparer l'actif sans terminer le fil.

Workflow

1. Résoudre la destination

Choisissez le plus petit dossier existant qui représente le projet actuel.

Préférez, dans l'ordre :

1. Un dossier de projet explicitement nommé par l'utilisateur.
2. La racine du dépôt ou de l'espace de travail si le fil est spécifique au dépôt.
3. Un dossier de projet, de domaine ou d'opérations durable requis par le fichier AGENTS.md local, les instructions de l'espace de travail ou le système d'exploitation de l'utilisateur.
4. Le répertoire de travail actuel lorsqu'aucun dossier de projet plus précis n'est évident.

Posez une seule question concise uniquement s'il existe plusieurs dossiers de projet plausibles et qu'écrire dans le mauvais dossier créerait un travail de nettoyage.

Si l'environnement de l'utilisateur dispose d'un système d'enregistrement durable, suivez ses instructions de projet les plus proches (fichier AGENTS.md ou équivalent) avant d'écrire.

Utilisez un nom de fichier comme :

<slug-du-sujet>__codex-process-asset__YYYY-MM-DD.md

Si aucun slug de sujet n'est évident, utilisez :

codex-closeout__YYYY-MM-DD.md

2. Localiser les preuves

Enregistrez les chemins de preuve avant d'écrire l'actif.

Recherchez :

• Le chemin actuel de l'espace de travail.
• Le chemin du fichier JSONL de session Codex actuel ou archivé.
• L'identifiant du fil à partir de la charge utile session_meta du JSONL, lorsque disponible.
• Les fichiers créés, modifiés, déplacés ou vérifiés pendant la conversation.
• Les systèmes externes lus ou écrits, avec des liens ou des noms de requête lorsqu'il est sûr de les préserver.

Le fichier de session se trouve généralement sous :

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

Sous Windows, ~ correspond généralement au répertoire du profil utilisateur.

Si la session active actuelle n'est pas encore visible sur le disque, écrivez explicitement :

Codex session evidence: current live thread; JSONL not located at closeout time.

Aide facultative :

python scripts/extract_session_events.py --latest
python scripts/extract_session_events.py --session "/chemin/vers/rollout.jsonl"

Utilisez l'aide uniquement pour obtenir un inventaire brut des événements. C'est vous qui devez organiser la chronologie finale.

3. Rédiger l'actif de processus

Utilisez cette structure :

# <Titre> Codex Process Asset

Date archivée : YYYY-MM-DD
Heure d'archivage : YYYY-MM-DD HH:mm+TZ
Espace de travail : `<chemin absolu>`
Projet local : `<chemin absolu>`
Preuve de session Codex : `<chemin absolu ou note de fil actif>`
Identifiant du fil : `<id ou inconnu>`

## 1. Type d'actif

Ce fichier est un actif de processus. Il préserve l'évolution clé de la conversation Codex, et non l'intégralité du transcript brut.

## 2. Pourquoi ceci a été préservé

- <pourquoi la clôture est importante>
- <ce qu'un lecteur futur devrait tirer de cet actif>

## 3. Chronologie concise

| Heure | Événement | Signification |
| --- | --- | --- |
| <heure> | <tournant clé> | <pourquoi c'était important> |

## 4. Résultats et preuves

| Type | Chemin / Lien | Notes |
| --- | --- | --- |

## 5. Décisions et corrections

- <décision finale>
- <correction importante de l'utilisateur>
- <limite clarifiée>

## 6. Suites ouvertes

- <élément ou "Aucune enregistrée">

## 7. Limites

- Les messages privés bruts, les identifiants et le contenu JSONL complet de Codex n'ont pas été copiés.
- Les fichiers de session originaux ont été laissés en place.

## 8. Étiquettes de récupération

- <étiquette>

Gardez le texte concis. L'actif doit pouvoir être relu en une ou deux minutes.

4. Mettre à jour les index proches

Mettez à jour la plus petite surface de découverte proche lorsqu'elle existe :

• README.md ou index.md dans le dossier du projet, s'il contient un tableau d'artefacts ou une carte des sources.
• CHANGELOG.md dans le dossier du projet, s'il existe.
• Tout registre d'exécution local ou index de projet requis par AGENTS.md ou une politique d'espace de travail équivalente.

Ne créez pas un nouveau dossier uniquement pour les clôtures, sauf si aucun dossier de projet raisonnable n'existe.

5. Vérifier

Avant de finaliser :

• Confirmez que l'actif de processus existe au chemin prévu.
• Recherchez dans l'actif le chemin de preuve de session ou la note de fil actif.
• Confirmez que toute mise à jour d'index ou de changelog mentionne le nouvel actif.
• Listez les fichiers modifiés.

6. Réponse finale et archivage

Répondez brièvement avec :

• Le chemin de l'actif de processus.
• Les fichiers d'index ou de changelog mis à jour.
• L'état du chemin de preuve.
• Toute suite restée ouverte.

Archivez ensuite la conversation en cours. Dans Codex Desktop, émettez la directive d'archivage comme dernière ligne :

::archive{reason="Actif de processus de clôture créé et conversation archivée"}

Sautez la directive d'archivage uniquement si l'utilisateur demande de préparer une clôture sans terminer le fil.

Exemples

Utilisez cette compétence pour des invites comme :

• "Termine ce fil Codex et crée un actif de processus traçable."
• "Archive cette conversation en préservant les décisions clés et les chemins de preuve."
• "Ferme ce fil avec un actif de processus concis."
• "Exécute la clôture et laisse le chemin de sortie et les preuves de session dans le dossier du projet."