orientation/Codex/Tape 04

用 Codex 跑完第一個工作流程

這一卷把前兩卷學的合起來真的跑一輪:拿一個小任務,從交代、看計畫、執行、驗證,一路做到把結果寫回知識庫。

5步走完一條 flow:交代、/plan、執行、驗證、回寫
1個 diff 面板,做完先看它改了哪裡
0次回頭問你,所以任務卡要一次講清楚

把任務卡和知識庫合起來跑一輪

first flow

前兩卷都是準備:一張接得住的任務卡、一個讀得懂的知識庫。這一卷拿一件真的事,從頭走到尾。

前兩卷你準備好兩樣東西:一張講得清楚的任務卡(02),和一個 Codex 讀得懂的知識庫(03)。這一卷把它們合起來,真的跑一輪。
一條 flow 就是一件事從頭走完五步:交代、看計畫、執行、驗證、回寫。在 Codex 上這件事有個脾氣要先認清:它拿到任務不會回頭問你,直接開幹。所以這條 flow 的訣竅不是把話講得漂亮,而是一次講清楚、主動留一個確認關卡、做完自己看它到底改了什麼。
01

挑一個小到能收尾的任務,開一個乾淨的對話

第一條 flow 不要挑大事。挑一件範圍小、做完就有結果的小事,先把整條路走順。Codex 本來就適合這種一次交辦、放它跑完的小活。
  • 範圍小:30 到 60 分鐘內能收尾,不是一個禮拜的大工程。
  • 輸入清楚:你給得出它要處理的東西:一份會議筆記、一份草稿、一份報告。
  • 看得到輸出:做完有一個具體成品,不是「感覺好一點」。
  • 驗得了:你有辦法判斷它做對沒:對得上原始資料、念給沒看過的人聽得懂。
在 App 裡按 Cmd+N 開一個新對話,讓這件事有一張乾淨的桌子。上一件事的上下文留在它自己的對話裡,別混進來。Codex 不回頭問你,桌上有雜物它就會照著雜物猜。

接下來用一個例子走完整條路:把這次客戶會議的零散筆記,整理成提案要用的三個重點。會用到你在第 03 卷建的「客戶提案」專案包;換成你自己的任何小事都行。

02

交代:任務卡,指到知識庫,最後加一個 /plan

因為 Codex 不會停下來問你,交辦時你要一次補齊三件事:把任務卡寫清楚、叫它先讀你的知識庫(省得重講背景)、最後加一個 /plan 幫自己留一個確認關卡。
原始筆記那個檔,直接拖進輸入框就行,不用複製貼上一大段。任務卡在輸入框打好,前面補一句 /plan,一起送出去。
貼進 Codex 輸入框:交代任務卡,並要它先給計畫

/plan 目標:把我這次跟客戶開會的零散筆記,整理成提案要用的三個重點,每個重點一句話加一句說明。 背景:先讀「客戶提案」專案包的 README,知道這個提案在談什麼、對方最在意什麼。原始筆記我已經拖進來了。 限制:只能用筆記裡真的講過的;不要自己加結論;維持三個重點、不要變多。 交付物:三個重點的清單,外加一句說明你為什麼挑這三個。 驗證方式:每個重點都對得上筆記裡的某一句;念給沒參加會議的同事聽,他能抓到提案方向。

最前面那句 /plan 是 Codex 版最關鍵的動作。它不會像有些工具那樣讀完先跟你確認,加了 /plan 它才會先把「打算怎麼做」攤給你看、等你點頭才動手。這一句把方向盤留在你手上。

03

看計畫,點頭再放行

Codex 會先回一份計畫:它打算怎麼挑、會參考哪些東西、哪裡不確定。這是你檢查的點,不是橡皮圖章,尤其它一放行就跑得快,這一眼很值得。
  • 它有沒有讀懂任務卡?方向對不對?
  • 有沒有打算動到你沒要它動的檔案?
  • 它說不確定的地方,是不是某個欄位你自己也還沒講清楚?
計畫對了,回一句「可以,照這個做」放它執行;有誤解,補一句把欄位講明白、讓它改計畫,別急著讓它動手。計畫對了再走,比讓它做錯再回頭省得多,因為它不會做到一半回頭問你,錯了通常是整條做完你才看到。
04

執行:看右邊的 diff 面板,它改了什麼一目了然

放行後 Codex 就動手做,你不用盯著它一個字一個字看。App 右邊有個 diff 面板,它每動一個檔、改一段內容,這裡都會列出來,這是 Codex 幫你把「它到底做了什麼」攤開的地方。做完先掃這個面板,比逐字讀它的回話快。
如果它跑歪了、方向不對,別等它做完。輸入框的送出鍵在它執行時會變成停止鍵,點下去就停,重講一次即可。
它動你的檔案前會問你要不要核准,這個由右下角的核准下拉控制(要求核准/代我核准/完整存取權)。日常保持「要求核准」或「代我核准」,讓它在你能看到的範圍內做事。

Codex 有一層自動審查(reviewer)會幫低風險的改動放行,讓你不用每一步都按核准。但放行不等於免看,它把 diff 面板留給你,就是要你做完自己判斷一眼。你真正的工作,是判斷輸出好不好,不是幫它打字。

想用終端的人:CLI 版喊停是 Ctrl+C(不是 Esc);換任務要清乾淨的話,App 直接 Cmd+N 開新對話最保險。

05

做完自己驗一遍,再把結果寫回知識庫

diff 面板讓你看到它改了什麼,但改得對不對還是要驗。好習慣是叫它自己先驗一遍、把沒把握的地方標出來,你只要抽驗一兩條。
貼進輸入框:自己驗一遍再回報

做好之後,請你自己先驗一遍再回報:逐條對照原始筆記,標出每個重點是根據哪一句。 如果有哪一條找不到出處,先告訴我、不要硬湊一個。 最後用三行內告訴我結果,以及你不太確定、想讓我確認的地方。

它願意標出「這條找不到出處」,比悄悄編一個更值得信任。你要的是一個會停下來說「這裡我不確定」的協作者,不是一個什麼都說好的。

驗過之後做最後一步,也是最常被跳過的一步:把這次的結果寫回專案包。下次接手,不管是你、隔週的你、還是換一台 Codex 的身體,都不用從零重問。一樣交給它做,別自己開檔慢慢打。
貼進輸入框:把這次的結果寫回專案包

這件事做完了,幫我把紀錄寫回「客戶提案」專案包: 在 tasks 裡把這張任務卡標成完成,附一句結果; 如果過程中定下了什麼(例如提案就走這三個重點),寫進 DECISIONS,補一句為什麼; 把 HANDOFF 更新成「做到哪、下一步是什麼」,讓下次接手的人或 Codex 不用重問。 完成後把你更新了哪些檔列給我。

它寫回你的筆記,也是在改你的檔案。核准前先看一眼 diff 面板,確認它只動了 tasksHANDOFFDECISIONS 這幾個檔,別閉著眼睛按過去。Windows 上尤其:永遠別開「完整存取權」,那一檔給的是整台電腦的權限,出過誤刪整台電腦檔案、救不回的事故,要更高權限請走 WSL2 或雲端。

Shane 筆記

這條回寫規矩(做完更新 tasksHANDOFFDECISIONS)你不會只做一次。把它寫進專案包根目錄的 AGENTS.md,Codex 每次進這個專案都會先讀它,之後你不用每次都在任務卡裡重講一遍,它自己就會收尾。

這一卷你要會的

拿一個 30–60 分鐘的小事,開一個乾淨對話,用一張任務卡加 /plan 交給 Codex、先看它的計畫再放行、執行時看 diff 面板、做完讓它自己驗一遍,最後把結果寫回 tasksHANDOFFDECISIONS,完整走完一條 flow。

本卷練習

practice

別只是讀過。挑一件這週真的要做的小事,現在就把整條 flow 跑一次。

  • 挑一件你這週真的要做、30–60 分鐘能收尾的小事(整理會議筆記、改一段提案、濃縮一份投影片都行)。
  • 用第 02 卷的任務卡寫清楚,在裡面叫 agent 先讀你第 03 卷建的專案包,最後要它先給計畫
  • 看過計畫、點頭後再放它執行;做完要它自己驗一遍、把不確定的地方標出來,你再抽驗一條。
  • 把結果寫回知識庫:tasks 標完成、HANDOFF 更新下一步、有拍板才記進 DECISIONS

第一次跑會覺得「我自己做還比較快」,對,這次是慢的。但你建立的是一條之後每次都能重複的路,知識庫也開始替你記住做過什麼。

進第 05 卷前,確認四件事

ready check

下一卷先學會控制與救援:怎麼喊停、怎麼回到上一步、換任務時怎麼清乾淨,會跑之後先把剎車學起來,後面才敢放手。

01
我跑完一條完整 flow
交代、看計畫、執行、驗證、回寫,五步都走過一次,不是只讀過。
required
02
我把結果寫回了知識庫
tasks 標完成、HANDOFF 更新下一步;下次接手不用從零重問。
required
03
我習慣先看計畫、再放 agent 動手
計畫對了才放行;有誤解先補欄位,不急著讓它做。
required
04
我準備好學「跑歪了怎麼救」
下一卷專門教控制與救援:喊停、回到上一步、換任務時清乾淨,出錯不慌。
next
next tape

第 05 卷:控制與救援,學會喊停與回到上一步

下一卷學最重要的安全感:怎麼喊停、回到上一步、換任務時清乾淨。會跑之後先學會剎車,後面才敢放手。

前往第 05 卷