用 Codex 跑完第一個工作流程
這一卷把前兩卷學的合起來真的跑一輪:拿一個小任務,從交代、看計畫、執行、驗證,一路做到把結果寫回知識庫。
把任務卡和知識庫合起來跑一輪
first flow前兩卷都是準備:一張接得住的任務卡、一個讀得懂的知識庫。這一卷拿一件真的事,從頭走到尾。
挑一個小到能收尾的任務,開一個乾淨的對話
- 範圍小:30 到 60 分鐘內能收尾,不是一個禮拜的大工程。
- 輸入清楚:你給得出它要處理的東西:一份會議筆記、一份草稿、一份報告。
- 看得到輸出:做完有一個具體成品,不是「感覺好一點」。
- 驗得了:你有辦法判斷它做對沒:對得上原始資料、念給沒看過的人聽得懂。
Cmd+N 開一個新對話,讓這件事有一張乾淨的桌子。上一件事的上下文留在它自己的對話裡,別混進來。Codex 不回頭問你,桌上有雜物它就會照著雜物猜。接下來用一個例子走完整條路:把這次客戶會議的零散筆記,整理成提案要用的三個重點。會用到你在第 03 卷建的「客戶提案」專案包;換成你自己的任何小事都行。
交代:任務卡,指到知識庫,最後加一個 /plan
/plan 幫自己留一個確認關卡。/plan,一起送出去。/plan 目標:把我這次跟客戶開會的零散筆記,整理成提案要用的三個重點,每個重點一句話加一句說明。 背景:先讀「客戶提案」專案包的 README,知道這個提案在談什麼、對方最在意什麼。原始筆記我已經拖進來了。 限制:只能用筆記裡真的講過的;不要自己加結論;維持三個重點、不要變多。 交付物:三個重點的清單,外加一句說明你為什麼挑這三個。 驗證方式:每個重點都對得上筆記裡的某一句;念給沒參加會議的同事聽,他能抓到提案方向。
最前面那句 /plan 是 Codex 版最關鍵的動作。它不會像有些工具那樣讀完先跟你確認,加了 /plan 它才會先把「打算怎麼做」攤給你看、等你點頭才動手。這一句把方向盤留在你手上。
看計畫,點頭再放行
- 它有沒有讀懂任務卡?方向對不對?
- 有沒有打算動到你沒要它動的檔案?
- 它說不確定的地方,是不是某個欄位你自己也還沒講清楚?
執行:看右邊的 diff 面板,它改了什麼一目了然
Codex 有一層自動審查(reviewer)會幫低風險的改動放行,讓你不用每一步都按核准。但放行不等於免看,它把 diff 面板留給你,就是要你做完自己判斷一眼。你真正的工作,是判斷輸出好不好,不是幫它打字。
想用終端的人:CLI 版喊停是 Ctrl+C(不是 Esc);換任務要清乾淨的話,App 直接 Cmd+N 開新對話最保險。
做完自己驗一遍,再把結果寫回知識庫
做好之後,請你自己先驗一遍再回報:逐條對照原始筆記,標出每個重點是根據哪一句。 如果有哪一條找不到出處,先告訴我、不要硬湊一個。 最後用三行內告訴我結果,以及你不太確定、想讓我確認的地方。
它願意標出「這條找不到出處」,比悄悄編一個更值得信任。你要的是一個會停下來說「這裡我不確定」的協作者,不是一個什麼都說好的。
這件事做完了,幫我把紀錄寫回「客戶提案」專案包: 在 tasks 裡把這張任務卡標成完成,附一句結果; 如果過程中定下了什麼(例如提案就走這三個重點),寫進 DECISIONS,補一句為什麼; 把 HANDOFF 更新成「做到哪、下一步是什麼」,讓下次接手的人或 Codex 不用重問。 完成後把你更新了哪些檔列給我。
它寫回你的筆記,也是在改你的檔案。核准前先看一眼 diff 面板,確認它只動了 tasks、HANDOFF、DECISIONS 這幾個檔,別閉著眼睛按過去。Windows 上尤其:永遠別開「完整存取權」,那一檔給的是整台電腦的權限,出過誤刪整台電腦檔案、救不回的事故,要更高權限請走 WSL2 或雲端。
這條回寫規矩(做完更新 tasks/HANDOFF/DECISIONS)你不會只做一次。把它寫進專案包根目錄的 AGENTS.md,Codex 每次進這個專案都會先讀它,之後你不用每次都在任務卡裡重講一遍,它自己就會收尾。
拿一個 30–60 分鐘的小事,開一個乾淨對話,用一張任務卡加 /plan 交給 Codex、先看它的計畫再放行、執行時看 diff 面板、做完讓它自己驗一遍,最後把結果寫回 tasks、HANDOFF、DECISIONS,完整走完一條 flow。
本卷練習
practice別只是讀過。挑一件這週真的要做的小事,現在就把整條 flow 跑一次。
進第 05 卷前,確認四件事
ready check下一卷先學會控制與救援:怎麼喊停、怎麼回到上一步、換任務時怎麼清乾淨,會跑之後先把剎車學起來,後面才敢放手。
第 05 卷:控制與救援,學會喊停與回到上一步
下一卷學最重要的安全感:怎麼喊停、回到上一步、換任務時清乾淨。會跑之後先學會剎車,後面才敢放手。
前往第 05 卷