實作指南 / 10 分鐘
Resume、fork、archive 與 restore Codex sessions
把保存的 context 當成有 lineage 的狀態,而不是神奇的 continue 按鈕。
Codex 會保存 interactive 與 exec sessions。resume 延續 lineage;fork 建立分支;archive/unarchive 提供可逆整理;delete 則永久移除指定 session。安全的 continuation unit 是「精確 session + 相容 repository state」,而不是模糊的最近一次。
CLI
已驗證 Terminal Sequence
- $
codex resume --last - $
codex fork --last - $
codex archive SESSION_ID - $
codex unarchive SESSION_ID - $
codex delete SESSION_ID
A
工作原則
歷史不會凍結 Git
Transcript 存在時 branch、files、dependencies 與 instructions 仍會改變;延續前先對齊 checkout。
Fork 保存原始 lineage
探索另一種解法或保留原始 audit trail 時使用 fork。
先 archive 再 delete
Archive 可復原,delete 永久;例行整理不應永久刪除。
B
實地程序
- 01
辨識目標
使用 picker 或精確 session ID;--last 適合人在單一 checkout 操作,不適合含糊 automation。
- 02
對齊 repository state
比對 branch、HEAD、working tree、instructions 與 dependencies。
- 03
選擇繼續或分支
Goal/lineage 不變才 resume;要測不同方向就 fork。
- 04
可逆整理
Archive inactive sessions,並確認能找到與還原,再考慮 delete。
- 05
只刪精確 target
永久操作前確認 identifier、retention requirement 與是否含唯一 evidence。
PASS / FAIL
驗收清單
- Session ID 與 repository 相符。
- Resume/fork 是刻意選擇。
- 預設 cleanup 是 archive。
- 不從 fuzzy query 執行永久刪除。
- Transcript 遵守 retention policy。
WATCH / REJECT
失敗模式
- 在錯誤 repo resume --last。
- 把 fork 當成修改原 lineage。
- 其實只想隱藏卻執行 delete。