Codex Closeout Archive（Codex クローズアーカイブ）
ユーザーが Codex の会話をクローズ、アーカイブ、終了、収穫、または保存したいと明示的に要求した場合に、このスキルを使用してください。会話を軽量なプロセス資産に変換し、その後アーカイブします。
ユーザーによる明示的なクローズアウト要求が、資産化の判断となります。このスキルが呼び出された後は、スレッドを保存する価値があるかどうかを再議論しないでください。すべてのクローズアウトは、簡潔なプロセス資産を作成します。
なぜこのスキルが存在するか
Codex のスレッドには、実際の作業（意図の変更、ユーザーの修正、証跡パス、ファイル変更、外部ソースの確認、最終決定など）が含まれていることがよくあります。アプリ内でスレッドを単にアーカイブするだけでは、次の会話でなぜ決定が変更されたのかがわからなくなる可能性があります。
このスキルは、トランスクリプト全体をコピーすることなく、再利用可能な証跡を保存します。これにより、以下のことが保護されます。
- トレーサビリティ: 将来の作業で元のセッション、ファイル、証跡を見つけることができます。
- 意思決定の継続性: 重要なターンと修正がスレッド間で保持されます。
- 低負荷のクローズアウト: すべての終了が1つの有用な成果物を生成し、大規模なアーカイブシステムは必要ありません。
会話が静かになった、またはエージェントがきちんと区切りをつけたいという理由だけで、このスキルを使用しないでください。クローズアウト、アーカイブ、収穫、または保存がユーザーが要求する次の状態である場合に使用してください。
譲れない条件
- このスキルを使用するたびにプロセス資産を作成すること。
- デフォルトで関連するプロジェクトフォルダを使用すること。
- タイムラインは簡潔に保つこと（通常5〜12の主要なターン）。
- 主要なターン、ユーザーの修正、決定、出力ファイル、証跡パスを保存すること。
- 資産に完全な未加工トランスクリプト、完全なSlackやDMの内容、認証情報、機密のエクスポートを貼り付けないこと。
- 元の Codex セッションファイルを削除、移動、または書き換えないこと。
- 資産が書き込まれ、確認された後、ユーザーがスレッドを終了せずに資産を準備するよう依頼しない限り、現在の会話をアーカイブすること。
ワークフロー
1. 保存先を決定する
現在のプロジェクトを表す、最も小さい既存のフォルダを選択します。
優先順位は以下の通りです。
- ユーザーによって明示的に指定されたプロジェクトフォルダ。
- スレッドがリポジトリ固有の場合は、リポジトリまたはワークスペースのルート。
- ローカルの
AGENTS.md、ワークスペースの指示、またはユーザーのオペレーティングシステムで必要な、永続的なプロジェクト、エリア、または運用フォルダ。 - より狭いプロジェクトフォルダが明らかでない場合は、現在の作業ディレクトリ。
複数の可能性のあるプロジェクトフォルダがあり、誤ったフォルダに書き込むとクリーンアップ作業が発生する場合にのみ、簡潔な質問を1つ行ってください。
ユーザーの環境に永続的な記録システムがある場合は、書き込む前に、最も近い AGENTS.md または同等のプロジェクト指示に従ってください。
次のようなファイル名を使用します。
<topic-slug>__codex-process-asset__YYYY-MM-DD.md
トピックスラッグが明らかでない場合は、次を使用します。
codex-closeout__YYYY-MM-DD.md
2. 証跡を特定する
資産を書き込む前に、証跡パスを記録します。
以下を確認します。
- 現在のワークスペースパス。
- 現在の、またはアーカイブされた Codex セッション JSONL パス。
- JSONL の
session_metaペイロードから取得できる場合のスレッドID。 - 会話中に作成、編集、移動、または確認されたファイル。
- 読み取りまたは書き込みが行われた外部システム。安全に保存できる場合はリンクまたはクエリ名を含める。
セッションファイルは通常、次の場所にあります。
~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl
~/.codex/archived_sessions/rollout-*.jsonl
Windows の場合、~ は通常、ユーザーのプロファイルディレクトリに解決されます。
現在のライブセッションがまだディスク上に見えない場合は、次のように明示的に書き込みます。
Codex session evidence: current live thread; JSONL not located at closeout time.
オプションのヘルパー:
python scripts/extract_session_events.py --latest
python scripts/extract_session_events.py --session "/path/to/rollout.jsonl"
ヘルパーは、未加工のイベント一覧を取得するためにのみ使用してください。最終的なタイムラインは自分でキュレーションしてください。
3. プロセス資産を書き込む
次の構造を使用します。
# <Title> Codex Process Asset
Date archived: YYYY-MM-DD
Archive time: YYYY-MM-DD HH:mm+TZ
Workspace: `<absolute path>`
Local project: `<absolute path>`
Codex session evidence: `<absolute path or live-thread note>`
Thread id: `<id or unknown>`
## 1. Asset Type
This file is a process asset. It preserves the Codex conversation's key evolution, not the full raw transcript.
## 2. Why This Was Preserved
- <why the closeout matters>
- <what future reader should recover from this asset>
## 3. Concise Timeline
| Time | Event | Meaning |
| --- | --- | --- |
| <time> | <key turn> | <why it mattered> |
## 4. Outputs And Evidence
| Type | Path / Link | Notes |
| --- | --- | --- |
## 5. Decisions And Corrections
- <final decision>
- <important user correction>
- <boundary clarified>
## 6. Open Follow-Ups
- <item or "None recorded">
## 7. Boundaries
- Raw private messages, credentials, and full Codex JSONL content were not copied.
- Original session files were left in place.
## 8. Retrieval Tags
- <tag>
散文はコンパクトに保ちます。資産は1〜2分で読み直せるようにする必要があります。
4. 近くのインデックスを更新する
存在する場合、最も近い発見可能なサーフェスを更新します。
- プロジェクトフォルダ内の
README.mdまたはindex.md（アーティファクトテーブルまたはソースマップがある場合）。 - プロジェクトフォルダ内の
CHANGELOG.md（存在する場合）。 AGENTS.mdまたは同等のワークスペースポリシーで必要な、ローカルの実行台帳またはプロジェクトインデックス。
適切なプロジェクトフォルダが存在しない場合を除き、クローズアウト専用の新しいフォルダを作成しないでください。
5. 確認する
最終決定する前に、以下を確認します。
- プロセス資産が意図したパスに存在することを確認します。
- 資産内のセッション証跡パスまたはライブスレッドメモを検索します。
- インデックスまたはチェンジログの更新で新しい資産が言及されていることを確認します。
- 変更されたファイルをリストします。
6. 最終応答とアーカイブ
簡潔に応答します。
- プロセス資産のパス。
- 更新されたインデックスまたはチェンジログファイル。
- 証跡パスのステータス。
- 未解決のフォローアップ事項。
その後、現在の会話をアーカイブします。Codex Desktop では、アーカイブディレクティブを最終行として出力します。
::archive{reason="Closeout process asset created and conversation archived"}
ユーザーがスレッドを終了せずにクローズアウトを準備するよう依頼した場合にのみ、アーカイブディレクティブをスキップします。
例
次のようなプロンプトでこのスキルを使用します。
- "この Codex スレッドを終了し、トレーサブルなプロセス資産を作成してください。"
- "この会話をアーカイブし、主要な決定と証跡パスを保存してください。"
- "このスレッドを簡潔なプロセス資産でクローズしてください。"
- "クローズアウトを実行し、出力パスとセッション証跡をプロジェクトフォルダに残してください。"