任務設計

任務設計決定 Codex 的工作品質。一個好任務會同時說明目標、上下文、範圍、約束、驗證方式和最終交付。

任務六要素

要素	寫法	示例
目標	一句話說明結果	修復登入頁重新整理後狀態丟失的問題
背景	給出現象和上下文	使用者重新整理頁面後需要重新登入
範圍	限定檔案或模組	只修改 auth 模組和相關測試
約束	寫明禁止事項	不改資料庫 schema，不引入新依賴
驗證	給出命令或檢查方式	pnpm test auth
交付	要求覆盤格式	總結根因、改動、測試和風險

從模糊到清晰

模糊寫法：

幫我最佳化登入邏輯。

清晰寫法：

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

背景：
- 使用者登入後重新整理頁面，會回到未登入狀態。
- 期望重新整理後仍能恢復已登入狀態。

範圍：
- 優先檢查 `src/auth` 和相關測試。
- 不改資料庫和後端介面。

驗證：
- 執行 `pnpm test auth`。
- 如果需要新增測試，請覆蓋重新整理恢復狀態的場景。

交付：
- 說明根因、改動檔案、驗證結果和剩餘風險。

大任務拆分

大任務建議拆成三步：

1. 只讀分析：讓 Codex 找影響面。
2. 方案確認：讓 Codex 給出切分和驗證方式。
3. 分步實施：每次只做一個可驗證改動。

模板：

請先不要修改程式碼。閱讀 [模組/目錄]，分析 [目標] 會影響哪些檔案、介面和測試。請輸出：
1. 影響面
2. 推薦實施步驟
3. 每一步的驗證方式
4. 第一階段最小改動建議

讓 Codex 主動暴露不確定性

可以加上：

如果你需要推測，請明確標註“推測”。如果官方文件、程式碼和測試之間有衝突，請先停下來說明衝突。

這句話適合文件更新、版本升級、依賴遷移和跨模組改動。