05 - 實戰提示詞與上手流程
← 04-權限與安全設定 | 00-Index | 下一篇 → 06-進階功能-Skills-Automations-多代理
初學者最需要的不是華麗 prompt
官方在 Working with Codex 很明確地說：你不需要完美 prompt，也不需要很技術化的指令。
真正有用的是把這 3 件事講清楚：
- 你要做什麼
- 可以用哪些檔案 / 範圍
- done 長什麼樣
一個通用 prompt 模板
你可以直接套這個：
請先檢查 [資料夾 / 專案 / 檔案]，告訴我你看到的重點。
接著提出一個安全、範圍小、可在這次完成的方案。
如果需要修改檔案，請先告訴我你預計會改哪些檔案，以及完成後我會得到什麼。如果你已經準備好要讓它直接做，可以改成：
請在這個 project 內完成以下任務：
1. ...
2. ...
3. 完成後回報你改了哪些檔案、做了哪些驗證、還有哪些風險或待確認事項。5 種很適合新手的任務
1. 看懂資料夾
請先閱讀這個資料夾的結構與主要檔案，告訴我它大概是做什麼的。
接著列出 3 個我可以安全開始的小任務。2. 整理文件
請把這些 Markdown 筆記整理成一份條理更清楚的索引頁。
不要刪原文，只新增整理檔。3. 找 bug
請根據這段錯誤訊息找出可能原因。
如果你認為可以安全修正，請實作並說明改了什麼。4. 補測試
請先閱讀這個模組與現有測試。
找出一個合理但缺漏的測試情境並補上。5. 做固定格式輸出
請閱讀這個資料夾中的內容，整理成一份一頁式摘要。
格式要包含：背景、現況、問題、下一步。prompt 的實用原則
說輸出格式
比起只說「整理一下」，更好的是說：
- 產出一份 Markdown
- 用條列式
- 控制在 1 頁
- 最後列出引用來源
- 回答用繁體中文，專有名詞保留英文
說限制條件
例如：
- 不要改原始檔
- 只新增新檔
- 不要碰 production 設定
- 修改前先告知
- 若不確定先停下來問
說驗證方式
例如：
- 做完後告訴我你怎麼檢查
- 若有測試請跑測試
- 若沒法驗證請直接說
一個穩定的上手流程
可以照這個節奏：
- 先讓 Codex inspect
- 讓它提小方案
- 你確認
- 它執行
- 它回報修改與驗證
- 你 review
- 再逐步放大任務
這比一開始就丟一個超大需求，成功率高很多。
重點整理
- 好 prompt 的重點不是 fancy，而是清楚。
- 目標、範圍、done、限制、驗證，這 5 個元素最實用。
- 新手最穩的流程是 inspect → propose → approve → execute → review。
- 你越清楚交代輸出格式，Codex 越容易穩定交付。
參考資料
← 04-權限與安全設定 | 00-Index | 下一篇 → 06-進階功能-Skills-Automations-多代理