Skip to content

建立 2026-09-15 更新 2026-09-15

第一次任務

第一次不要急著「幫我做一個完整產品」。先走完一個小迴圈:弄懂專案 → 做一個可審查的改動 → 看 diff → 決定要不要留下。

開始前

  • 在專案根目錄啟動 Codex(CLI 打 codex,或打開 IDE 側欄)。
  • 工作樹盡量乾淨,或先自己 commit。Codex 改檔很快,沒有 Git 紀錄就很難退。
  • 權限先維持預設,不要一開始就 danger-full-access

建議的第一個 prompt

先請它讀,再請它改:

請用三到五點說明這個專案:它做什麼、目錄怎麼分、我要怎麼在本機跑起來。
先不要改任何檔案。

看完摘要,再給一個範圍很小的任務,例如:

請把首頁按鈕抽成可重用元件,視覺不要變。
改完請跑現有測試,並告訴我看了哪些檔案、為什麼這樣改。

任務寫得越具體,代理越不必猜。若你知道改動會落在哪個檔,用 @ 把路徑加進上下文。

下指令的 20% 原則

  1. 講結果,不要只講感覺。 「加 dark mode,並沿用現有 token」比「讓它好看一點」有用。
  2. 限制範圍。 寫「只改 src/components/,不要動 API」。
  3. 要求驗證。 請它跑測試、lint,或說明無法跑的原因。
  4. 複雜工作先計畫。 「先列實作步驟讓我確認,再動手」能避免一次改太多。
  5. 看 diff 再接受。 CLI 用 /diff/review;IDE 在側欄看摘要與變更列。

常用斜線指令

在 CLI 輸入 / 可叫出指令。第一次任務最常用這幾個:

指令 用途
/init 依目前 repo 草擬 AGENTS.md,當專案規則起點
/status 看模型、工作目錄、權限
/permissions 調整沙盒與核准方式
/model 切換模型與推理力度
/review 審查目前變更,不改工作樹
/diff 看尚未提交的修改

完整列表會隨版本增加,以 / 選單與 CLI 參考 為準。

做完怎麼收

  1. 自己跑一次你原本就會跑的指令(測試、預覽)。
  2. 讀 diff:有沒有多餘重構、有沒有動到不該動的檔。
  3. 用你自己的 commit message 提交;不要把「Codex 產生」當成品質保證。

若任務變大、或你想同時試幾種作法,改走 Cloud,讓本機繼續做別的事。

推薦影音

官方:GPT-5-Codex 與 CLI

簡述:示範本機 CLI 工作流,包含規劃、搜尋最新文件、部署與權限切換。對應本頁「小迴圈」之後的下一步。

實作:在 CLI 裡改一個元件

簡述:Net Ninja 帶你在本機 CLI 完成一次真實修改,並用 @ 手動補檔案上下文。可與上面的範例 prompt 對照練習。