實作指南 / 13 分鐘
控制長時間 CLI session
規劃、steer、queue、compact、inspect、resume,不丟失任務邊界。
Codex CLI 同時提供 live work 的 keyboard-first controls,以及 persisted session 的 top-level lifecycle commands。Plan/status/diff/compact/review 控制當前工作;resume、fork、archive、unarchive 與永久 delete 則讓保存的工作狀態清楚可管。
已驗證 Terminal Sequence
- ›
/plan Map the change, risks, and verification before editing - ›
/status - ›
/diff - ›
/compact - ›
/review - $
codex resume --last - $
codex fork --last - $
codex archive <SESSION_ID> - $
codex unarchive <SESSION_ID> - $
codex delete <SESSION_ID>
工作原則
需要時才 plan
Ambiguity、migration、risk 才用 /plan,不把它變成一行修改前的儀式。
State 保持可見
/status 和 /diff 在 context drift 前揭露設定與 working-tree effects。
分清 steer/queue
新資訊改變方向才 steer;獨立 follow-up 才 queue。
保存的 session 也要治理
Resume 延續、fork 分支、archive 隱藏閒置工作;delete 是永久操作,執行前確認 session 與 checkout。
實地程序
- 01
進入 plan mode
不編輯,先 map files、risks、choices、verification。
- 02
確認 permission/context
實作前用 /status,尤其是切換 directory/permission 後。
- 03
用 evidence steer
發現 constraint 推翻路徑時立即修正 active turn。
- 04
檢查並 compact
頻繁 /diff;長而吵雜後用 /compact 保留 decision 與 remaining tasks。
- 05
Review 或 resume
接受前 /review;resume 前確認 repo state 仍相容。
- 06
刻意管理保存的工作
需要不同方向時 fork;可逆整理用 archive/unarchive;只有辨識 exact session 後才 delete。
PASS / FAIL
驗收清單
- Plan 包含 verification。
- /status 符合預期。
- 完成前讀過 /diff。
- Queued request 不暗中擴張 scope。
- 考慮永久刪除前先 archive session。
WATCH / REJECT
失敗模式
- 用 compact 掩蓋失敗。
- 缺 context 就 queue destructive follow-up。
- Checkout 大幅變更後直接 resume。
- Archive 已足夠卻永久 delete session。