Community寫作與編輯github.com

ChenJinCloud/codex-closeout-archive

Codex 技能,用於將對話關閉並轉化為可追蹤的流程資產。

codex-closeout-archive 是什麼?

此技能專為 Codex (或其他 AI Agent) 設計,當使用者明確要求關閉、歸檔、結束或保存對話時,將對話收尾成一個輕量級的「流程資產 (Process Asset)」,然後歸檔對話。它的核心價值在於解決 AI Agent 對話中「決策軌跡丟失」的問題:對話的來回轉折、使用者修正、決策路徑和產出的檔案,如果僅留在 App 的歷史記錄中,下一個對話就無法繼承。此技能強制每次關閉都產生一個結構化的 .md 檔案,包含時間線、決策、證據路徑和後續事項,且檔案預設存放在專案資料夾內。最後,它還會自動發出歸檔指令,讓對話存檔。開發者或進階使用者可藉此獲得輕量、可檢索、跨對話的決策連續性,適用於需要高度責任追蹤和知識資產管理的 Codex 工作流程。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add ChenJinCloud/codex-closeout-archive

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Codex 關閉歸檔技能

當使用者明確要求關閉、歸檔、結束、收穫或保存 Codex 對話時,請使用此技能。它會將對話轉化為輕量級的流程資產,然後歸檔對話。

使用者的明確關閉請求即為資產化決策。一旦此技能被調用,請不要再重新爭論該對話串是否值得保存;每一次關閉都會建立一個精簡的流程資產。

為何需要此技能

Codex 對話串通常包含真正的工作內容:意圖轉變、使用者修正、證據路徑、檔案變更、外部來源檢查以及最終決策。如果該對話串僅在應用程式中歸檔,下一個對話可能會失去決策為何改變的脈絡。

此技能保存了可重複使用的軌跡,而無需複製整個對話記錄。它保護了:

  • 可追溯性:未來的工作可以找到原始的對話階段、檔案和證據。
  • 決策連續性:關鍵的轉折點和修正可以跨對話串保留下來。
  • 低摩擦的關閉:每個結尾都產生一個有用的工件,而不是一個龐大的歸檔系統。

請勿僅僅因為對話已變得安靜,或因為代理想要整齊地結束就使用此技能。僅在使用者要求的下一步狀態是關閉、歸檔、收穫或保存時,才使用它。

不可妥協的原則

  • 每次使用此技能時,都必須建立一個流程資產。
  • 預設使用相關的專案資料夾。
  • 保持時間線簡潔:通常為 5-12 個關鍵轉折點。
  • 保留關鍵轉折點、使用者修正、決策、輸出檔案和證據路徑。
  • 請勿將完整的原始對話記錄、完整的 Slack 或 DM 內容、憑證或敏感匯出內容貼入資產中。
  • 請勿刪除、移動或改寫原始的 Codex 階段檔案。
  • 在資產被寫入並驗證後,歸檔目前的對話,除非使用者要求在結束對話串之前準備資產。

工作流程

1. 確定目標位置

選擇代表目前專案的最小現有資料夾。

依序優先選擇:

  1. 使用者明確命名的專案資料夾。
  2. 如果對話串是特定於某個儲存庫,則選擇該儲存庫或工作區的根目錄。
  3. 由本地 AGENTS.md、工作區指示或使用者的作業系統所要求的一個持續性專案、領域或操作資料夾。
  4. 當沒有更明確的專案資料夾時,使用當前工作目錄。

僅當存在多個看似合理的專案資料夾,且寫入錯誤的資料夾會造成清理工作時,才提出一個簡潔的問題。

如果使用者的環境有持續性記錄系統,請在寫入之前遵循其最近的 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 執行緒並建立一個可追蹤的流程資產。"
  • "歸檔此對話,保留關鍵決策和證據路徑。"
  • "用一個簡潔的流程資產關閉此執行緒。"
  • "執行關閉流程,並將輸出路徑和階段證據留在專案資料夾中。"

相關技能