← 返回學習路線
章節 · 已發布

Codex 任務設計

寫清楚目標、背景、範圍、限制、驗證與交付格式,讓 Codex 更穩定地完成工作並減少返工。

來源: start/07-task-design.md快速上手 (原文)
本章閱讀進度 0%學習路線進度 0% · 0/46 已完成章節繼續學習路線 →

Tip · 最後核對

官方資料最後核對日期為 2026-09-02。涉及上下文、指令、驗證與安全邊界時,請參考 Codex 官方文件總覽、Codex AGENTS.md 文件 與智能體審批與安全。

任務設計

任務設計決定 Codex 的工作品質。一個實用的需求應說明目標、背景、範圍、限制、驗證方式和交付格式。

任務的六個要素

要素寫法範例
目標用一句話說明預期結果修復登入頁重新整理後狀態遺失
背景描述現象與相關上下文使用者登入後重新整理會回到未登入狀態
範圍限定檔案或模組只修改 auth 模組與相關測試
限制寫明不可改動的項目不修改資料庫 schema,不新增依賴
驗證指定命令或檢查方式執行 pnpm test auth
交付定義回報格式總結根因、變更、測試與剩餘風險

從模糊到清楚

模糊寫法:

請幫我改善登入邏輯。

清楚寫法:

請修復登入頁重新整理後狀態遺失的問題。

背景:
- 使用者登入後重新整理頁面會回到未登入狀態。
- 重新整理後應恢復登入狀態。

範圍:
- 優先檢查 `src/auth` 與相關測試。
- 不修改資料庫和後端 API。

驗證:
- 執行 `pnpm test auth`。
- 如果程式碼需要,補上重新整理恢復狀態的測試。

交付:
- 說明根因、變更檔案、驗證結果與剩餘風險。

拆分大型任務

大型需求可以分成三個階段:

  1. 只讀分析:找出受影響的檔案與介面。
  2. 計畫:說明切分、風險與驗證方式。
  3. 實作:每次只完成一個可驗證的小變更。

範本:

先不要編輯。閱讀 [模組或目錄],分析 [目標] 會影響哪些部分。請回報:
1. 受影響範圍
2. 建議實作步驟
3. 每一步的驗證方式
4. 第一個最小有效變更

讓不確定性可見

涉及文件、版本、依賴或遷移時,可以加入:

如果需要推測,請標示為推測。如果官方文件、程式碼與測試不一致,請先停下來說明衝突。

下一步

下一篇:任務執行與驗證閉環。

延伸閱讀

知識AI Agent:從基礎概念到實際應用知識AI 自動化工作流程設計與實踐知識結構化輸出與工具契約:讓 Agent 動作可驗證
產品中心 Demo · V0.3