生活分享
工作階段、接續與分岔
辨識新任務、接續與分岔的差異,從歷史中找到正確工作並核對路徑和剩餘事項。
閱讀時間約 12 分鐘 · 操作 20 分鐘

返回 Codex 教學總目錄Codex 學習中心:完整教學目錄從安裝、第一個任務到 MD 規則與進階整合,規劃 60 篇 Codex 教學、十個單元。依程度、平台、需求或指令搜尋下一篇;尚未公開的教學會標示狀態,方便安排學習路線。閱讀全文
目標與準備
resume 接續的是先前工作階段的對話與狀態,不是把整個磁碟還原到當時。你在編輯器改了檔案,或其他任務做了修改,重新接續時都要確認。也不要把接續與 fork桌面版任務與專案管理把同一件事的追問留在同一任務,把獨立成果分成不同任務,能減少上下文混亂。專案負責定位相關檔案,任務負責一次具體工作;建立很多任務不會自動讓檔案彼此隔離,隔離需要 worktree 等機制。閱讀全文、跨主機 Handoff跨裝置交接:核對檔案與環境追蹤對話、主機、工作目錄與分支,用交接紀錄確認接續的是同一份工作。閱讀全文混成一件事:一個是回到既有任務,一個建立另一條工作線,另一個移動執行位置。
步驟一:建立容易辨認的兩個練習
在同一個練習父資料夾建立 codex-session-a 與 codex-session-b,各自新增 note.txt。A 放第一段,B 放第二段,不要把兩段放進同一個檔案。兩個檔名都叫 note.txt,但內容標記不同;這讓你不能只靠檔名猜測目前工作位置。記下父資料夾在哪裡,後續每次啟動前都先核對目錄。
SESSION-A
Revision: 1
SESSION-B
Revision: 100
用編輯器開 A 資料夾,再開整合終端機。PowerShell 用 Get-Location,macOS/Linux 用 pwd,確認末端是 codex-session-a;從該處執行下列命令。進入 CLI 後送出再下一段要求。預期回覆 A 的實際路徑、SESSION-A、Revision: 1,且檔案沒有修改。記錄這次任務在清單中顯示的標題與時間。
codex --cd . --sandbox read-only
Read note.txt from the current directory without changing files. Report the exact directory and both lines. This is a session-resume exercise. Do not search other folders or infer content from the filename.
用 /exit 退出 A,看到系統終端機提示符號後,改從 B 資料夾開相同的唯讀工作階段並送出相同要求。這次應是 SESSION-B 與 Revision: 100。退出後你有兩個可辨識的工作階段;B 較新,但接下來要找回的是 A。這比只有一個任務時按「最近」更能測出選擇是否正確。
步驟二:用清單找回 A
回到 A 資料夾的系統終端機執行 codex resume。用畫面清單確認專案路徑、時間與可看到的內容,再選 A。若目前清單不含想找的目錄,可以用 --all 列出其他目錄的工作階段,但必須重新核對選擇,不把全域最新項目直接當目標。清單操作鍵以當前畫面提示為準,按 Enter 確認前先看清楚目錄。
codex resume
codex resume --all
若啟動目錄和任務儲存的目錄不同,CLI 可能詢問要用哪個位置;不要為了快點進去隨便選。這次要繼續 A 就選 A 所在位置,接著用 /status 與新的讀檔要求確認。已設定 tui.resume_cwd 或明確 --cd 時,行為可能不同;需要理解它們時看設定排錯設定優先順序與故障排除從設定來源追查無效或衝突的選項,一次修改一項,驗證結果後保留可還原的紀錄。閱讀全文,不要把沒有跳詢問框當作一定選對。
| 方式 | 用途 | 使用前的確認 |
|---|---|---|
| codex resume | 開啟選擇清單 | 路徑、時間、任務內容 |
| codex resume --last | 接續目前目錄最近任務 | 已在正確目錄 |
| codex resume --all | 顯示跨目錄任務 | 不把最新項目誤當目標 |
| codex resume SESSION_ID | 用已知 ID 指定任務 | ID 來自真正任務,不是範例字樣 |
| /resume | 在互動 CLI 開選擇清單 | 指令輸入於 Codex,而非系統 shell |
步驟三:證明接續會讀到新磁碟內容
再次退出 A,使用文字編輯器只將 A/note.txt 第二行改為 Revision: 2,B 的檔案完全不動。回 A 的系統終端機執行下面命令,這裡 --last 依官方規則限定目前目錄的最近工作階段;不要加 --all,因為它會改變搜尋範圍。如果該目錄還有其他任務,改用清單或已知 ID,不要盲猜最近一筆就是練習。
codex resume --last --sandbox read-only
進入後送出下列要求。預期指出舊對話是 Revision: 1,但目前磁碟是 Revision: 2,且 SESSION-A 沒變。這個差異是題目,不是要修復的錯誤;不要叫它把檔案改回聊天記憶中的數字。對正式工作而言,相同方法可用來確認測試紀錄、未提交修改與交接筆記是否仍符合現在版本。
Resume by reading note.txt from disk again now. Compare the current revision with the earlier conversation. Report the current directory, the file marker, and any difference. Do not restore an older value or edit any file.
延伸:分岔對話後,檔案仍須核對
若要比較另一條思路,先退出目前 CLI,回 A 目錄執行下方 fork。從選擇清單核對原 A 任務與目錄,記錄分岔後的新任務 ID;這會建立另一段對話,不等於備份或隔離檔案。這次沒有 Git,也不使用 worktree,兩段對話可能操作相同資料夾,因此都只做唯讀。看不到 fork 時先查 codex fork --help 與本機版本,不把其他產品的功能名稱當命令。
codex fork --sandbox read-only
This is a read-only alternative branch of the session exercise. Read note.txt from disk now and report its actual path, marker and revision. Describe one different way to verify the file without changing it. Do not assume that forking created a separate file copy or restored Revision: 1. Do not edit files.
分岔後仍應讀到目前 A 的 Revision: 2;原 A 對話保留,磁碟不應倒退。若新任務與 A 指向同一完整路徑,就記「對話分開、檔案共用」。完成後退出分岔,再從清單接續原 A,重新讀同一檔案確認;退出或刪除對話都不能當作檔案還原。WorktreeWorktree 與多任務隔離Worktree 讓同一個 Git 程式庫有不同的工作目錄,各自承接不同分支。它適合讓兩項工作分開改檔,但資料庫、連接埠與外部服務仍可能共用,不能把檔案隔離當成所有資源隔離。閱讀全文篇才處理 Git 工作目錄隔離。
常見錯誤、停止與還原
找不到工作階段時,先查是否換了 OS、使用者、CODEX_HOME 或主機,再用 --all 核對其他目錄;桌面與 CLI 的工作階段不應只靠標題相同就推定可互換。選錯 B 時,先停止送出後續要求,/exit 回終端機重選 A;如果已經有寫入,就到被修改的真正目錄檢查差異,退出對話不會撤銷檔案。回覆仍是 1 時則要求新讀取並確認路徑,而不是重複同一句「繼續」。
如果規則檔剛更新,也應先完成目前小步驟並開新的工作階段驗證,不把 resume 當成清空所有舊指示的方法;規則層級篇AGENTS.md 層級與覆寫驗證用根目錄與子目錄案例追蹤規則來源、衝突與 override,確認實際選入的文件。閱讀全文有專門對照。長對話需要整理時看上下文交接上下文與工作交接長工作需要把決策與證據留下,不能只依靠對話長度。README 說明怎麼使用專案,設計文件記錄為何這樣做,交接文件整理目前做到哪裡;AGENTS.md 則放持續有效的工作規則,避免把所有進度塞成規則。閱讀全文,保留關鍵決策、真實檔案與未完成事項,而不是把摘要當作檔案備份。
完成時應保存 A/B 的辨識紀錄、A 接續後的新讀取,以及為何 --last 和 --all 不能隨便互換的說明。還原練習時只把 A 的 Revision 改回 1,再確認 B 仍是 100;不需要刪除工作階段或登入資料。本篇命令依官方文件與本機 help 查證,沒有替讀者執行互動工作階段或保證舊任務跨平台自動同步。下一次正式接續也先確認「哪個任務、哪個目錄、哪個版本」,再開始修改。
圖中 1 是先辨認 A 與 B,2 是選擇正確的工作階段,3 是重新讀取磁碟並核對版本。每次續接都保留這三個檢查點。
返回 Codex 教學總目錄Codex 學習中心:完整教學目錄從安裝、第一個任務到 MD 規則與進階整合,規劃 60 篇 Codex 教學、十個單元。依程度、平台、需求或指令搜尋下一篇;尚未公開的教學會標示狀態,方便安排學習路線。閱讀全文
閱讀完整文字說明
Three numbered stages: identify the starting point, perform the exercise, and verify the result. Original illustration, not a product screenshot.
覺得這篇整理實用嗎?分享給需要的朋友
同主題延伸閱讀
生活分享
Codex 學習中心:完整教學目錄
從安裝、第一個任務到 MD 規則與進階整合,規劃 60 篇 Codex 教學、十個單元。依程度、平台、需求或指令搜尋下一篇;尚未公開的教學會標示狀態,方便安排學習路線。
生活分享
Worktree 與多任務隔離
Worktree 讓同一個 Git 程式庫有不同的工作目錄,各自承接不同分支。它適合讓兩項工作分開改檔,但資料庫、連接埠與外部服務仍可能共用,不能把檔案隔離當成所有資源隔離。
生活分享
實戰:製作小網站
從 brief.md 規劃並製作 Small Steps 待辦網站,完成新增、完成、刪除、篩選與本機資料保存。將 HTML、CSS、資料函式、畫面事件與測試分開,以 Node 測試和瀏覽器操作驗收,並留下可重新啟動與還原的交接紀錄。
引用本文的文章
資料來源
本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。