Tip · 最後核對
官方資料最後核對日期為 2026-09-02。涉及上下文、指令、驗證與安全邊界時,請參考 Codex 官方文件總覽、Codex AGENTS.md 文件 與智能體審批與安全。
任務設計
任務設計決定 Codex 的工作品質。一個實用的需求應說明目標、背景、範圍、限制、驗證方式和交付格式。
任務的六個要素
| 要素 | 寫法 | 範例 |
|---|---|---|
| 目標 | 用一句話說明預期結果 | 修復登入頁重新整理後狀態遺失 |
| 背景 | 描述現象與相關上下文 | 使用者登入後重新整理會回到未登入狀態 |
| 範圍 | 限定檔案或模組 | 只修改 auth 模組與相關測試 |
| 限制 | 寫明不可改動的項目 | 不修改資料庫 schema,不新增依賴 |
| 驗證 | 指定命令或檢查方式 | 執行 pnpm test auth |
| 交付 | 定義回報格式 | 總結根因、變更、測試與剩餘風險 |
從模糊到清楚
模糊寫法:
請幫我改善登入邏輯。
清楚寫法:
請修復登入頁重新整理後狀態遺失的問題。
背景:
- 使用者登入後重新整理頁面會回到未登入狀態。
- 重新整理後應恢復登入狀態。
範圍:
- 優先檢查 `src/auth` 與相關測試。
- 不修改資料庫和後端 API。
驗證:
- 執行 `pnpm test auth`。
- 如果程式碼需要,補上重新整理恢復狀態的測試。
交付:
- 說明根因、變更檔案、驗證結果與剩餘風險。
拆分大型任務
大型需求可以分成三個階段:
- 只讀分析:找出受影響的檔案與介面。
- 計畫:說明切分、風險與驗證方式。
- 實作:每次只完成一個可驗證的小變更。
範本:
先不要編輯。閱讀 [模組或目錄],分析 [目標] 會影響哪些部分。請回報:
1. 受影響範圍
2. 建議實作步驟
3. 每一步的驗證方式
4. 第一個最小有效變更
讓不確定性可見
涉及文件、版本、依賴或遷移時,可以加入:
如果需要推測,請標示為推測。如果官方文件、程式碼與測試不一致,請先停下來說明衝突。
下一步
下一篇:任務執行與驗證閉環。
