Codex 關閉歸檔技能
當使用者明確要求關閉、歸檔、結束、收穫或保存 Codex 對話時,請使用此技能。它會將對話轉化為輕量級的流程資產,然後歸檔對話。
使用者的明確關閉請求即為資產化決策。一旦此技能被調用,請不要再重新爭論該對話串是否值得保存;每一次關閉都會建立一個精簡的流程資產。
為何需要此技能
Codex 對話串通常包含真正的工作內容:意圖轉變、使用者修正、證據路徑、檔案變更、外部來源檢查以及最終決策。如果該對話串僅在應用程式中歸檔,下一個對話可能會失去決策為何改變的脈絡。
此技能保存了可重複使用的軌跡,而無需複製整個對話記錄。它保護了:
- 可追溯性:未來的工作可以找到原始的對話階段、檔案和證據。
- 決策連續性:關鍵的轉折點和修正可以跨對話串保留下來。
- 低摩擦的關閉:每個結尾都產生一個有用的工件,而不是一個龐大的歸檔系統。
請勿僅僅因為對話已變得安靜,或因為代理想要整齊地結束就使用此技能。僅在使用者要求的下一步狀態是關閉、歸檔、收穫或保存時,才使用它。
不可妥協的原則
- 每次使用此技能時,都必須建立一個流程資產。
- 預設使用相關的專案資料夾。
- 保持時間線簡潔:通常為 5-12 個關鍵轉折點。
- 保留關鍵轉折點、使用者修正、決策、輸出檔案和證據路徑。
- 請勿將完整的原始對話記錄、完整的 Slack 或 DM 內容、憑證或敏感匯出內容貼入資產中。
- 請勿刪除、移動或改寫原始的 Codex 階段檔案。
- 在資產被寫入並驗證後,歸檔目前的對話,除非使用者要求在結束對話串之前準備資產。
工作流程
1. 確定目標位置
選擇代表目前專案的最小現有資料夾。
依序優先選擇:
- 使用者明確命名的專案資料夾。
- 如果對話串是特定於某個儲存庫,則選擇該儲存庫或工作區的根目錄。
- 由本地
AGENTS.md、工作區指示或使用者的作業系統所要求的一個持續性專案、領域或操作資料夾。 - 當沒有更明確的專案資料夾時,使用當前工作目錄。
僅當存在多個看似合理的專案資料夾,且寫入錯誤的資料夾會造成清理工作時,才提出一個簡潔的問題。
如果使用者的環境有持續性記錄系統,請在寫入之前遵循其最近的 AGENTS.md 或等效的專案指示。
使用類似如下的檔案名稱:
<主題-代號>__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. 撰寫流程資產
使用此結構:
# <標題> Codex 流程資產
歸檔日期:YYYY-MM-DD
歸檔時間:YYYY-MM-DD HH:mm+TZ
工作區:`<絕對路徑>`
本機專案:`<絕對路徑>`
Codex 階段證據:`<絕對路徑或即時對話串備註>`
執行緒 ID:`<ID 或 unknown>`
## 1. 資產類型
此檔案是一個流程資產。它保存了 Codex 對話的關鍵演變,而非完整的原始對話記錄。
## 2. 保存原因
- <此次關閉為何重要>
- <未來的讀者應從此資產中恢復什麼>
## 3. 簡要時間線
| 時間 | 事件 | 意義 |
| --- | --- | --- |
| <時間> | <關鍵轉折點> | <為何重要> |
## 4. 輸出與證據
| 類型 | 路徑 / 連結 | 備註 |
| --- | --- | --- |
## 5. 決策與修正
- <最終決策>
- <重要的使用者修正>
- <釐清的邊界>
## 6. 待辦後續事項
- <事項或「無記錄」>
## 7. 邊界
- 原始私人訊息、憑證和完整的 Codex JSONL 內容未被複製。
- 原始階段檔案被保留在原處。
## 8. 檢索標籤
- <標籤>
保持文字精簡。此資產應能在 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 執行緒並建立一個可追蹤的流程資產。"
- "歸檔此對話,保留關鍵決策和證據路徑。"
- "用一個簡潔的流程資產關閉此執行緒。"
- "執行關閉流程,並將輸出路徑和階段證據留在專案資料夾中。"