實作指南 / 12 分鐘
像工程師一樣執行第一次 terminal session
Working directory 與完成定義比 prompt 花招更能決定結果。
第一次有效 session 要在正確 repository、明確 permission mode 下開始，prompt 說明 goal、context、constraints 與 done condition。Codex 可以探索、修改與執行檢查，但任務邊界必須可觀察。
CLI
已驗證 Terminal Sequence
- $
codex - $
codex -C path/to/repo - $
codex --sandbox workspace-write --ask-for-approval on-request
A
工作原則
Directory 就是 context
在目標 repo 啟動或用 -C 指定；guidance 與 project config 從這個 root discovery。
Prompt 是契約
說明目標、相關檔案或錯誤、邊界與可觀察 completion criteria。
要求證據
有自信的 summary 不是 verification；要求 checks、結果與 remaining uncertainty。
B
實地程序
- 01
選可逆任務
先用預期結果容易檢查的 docs、test 或 focused bug。
- 02
從正確 root 啟動
在 repo 執行 codex，或用 codex -C。
- 03
寫 task contract
清楚列出 goal、context、constraints、done。
- 04
先探索後編輯
要求找出真正 execution path 並先說明 validation。
- 05
檢查 evidence
接受前讀 changed files、tests 與 unresolved risks。
PASS / FAIL
驗收清單
- Workspace 是預期 repo。
- Prompt 說明不可變更範圍。
- Done 是可觀察 check。
- 你親自讀過 diff。
WATCH / REJECT
失敗模式
- 在多個不相關 repo 的上層啟動。
- 列滿微步驟卻沒說 outcome。
- 沒跑 check 就接受完成宣告。