生活分享

如何把需求說清楚

有效的需求不是把提示詞寫得很長,而是讓代理知道你要什麼、已有哪些材料、有哪些界線,以及怎樣算完成。同一個『幫我改善網頁』,可以指速度、外觀或無障礙;先把目標變成能觀察的行為。

閱讀時間約 12 分鐘 · 操作 20 分鐘

LINE 分享
實作順序示意圖,非產品介面截圖。
圖片:Mokaair (© Mokaair)
回總目錄:Codex 學習中心:完整教學目錄

入門 · Desktop / mobile / CLI / VS Code / JetBrains / cloud

本篇目錄
  1. 1. 讀完能做到什麼
  2. 2. 準備可重複的起點
  3. 3. 第一步:找出模糊要求缺了什麼
  4. 4. 第二步:寫出完整可執行需求
  5. 5. 第三步:用成果判斷,而不是看回答長度
  6. 6. 結果不符時,補充一個可重現例子
  7. 7. 三種常見問題與修正
  8. 8. 小練習、還原與來源

讀完能做到什麼

準備可重複的起點

從練習材料複製 expected 到全新的 codex-prompt-lab;不要沿用上一課已改過文字的副本。根目錄應有五個檔案,先開啟 index.html,找到 New task 標籤、Add task 按鈕與 Read the project README 提示文字。這三個可見字串就是本篇的來源;不需要貼整個專案進對話。

已完成者可使用相同預覽方式。Windows 在副本執行 py -m http.server 4173 --bind 127.0.0.1;macOS/Linux 執行 python3 -m http.server 4173 --bind 127.0.0.1,瀏覽 http://127.0.0.1:4173。這一課不需要先學 Git,但要保留原版,以便確認差異或取回自己改過的檔案。

第一步:找出模糊要求缺了什麼

「幫我把表單改得更好」沒有說給誰用、哪裡不好、能改哪些地方,或怎樣算完成。Codex 可能改色彩、欄位、按鈕、資料結構,甚至加入你沒需要的新套件;這不一定是它做錯,而是需求允許太多不同解讀。先用一句話說出讀者要做到的事,例如「新使用者能看懂怎麼新增一筆小任務」。

接著補四種資訊:目標、現況來源、限制、驗收。它們不是每次都要四個標題的格式,而是防止重要資訊漏掉的檢查方式。小幅改字只需幾行;跨多個檔案的新功能,才需要背景與分段計畫。不要為了看起來專業而塞入沒用的角色設定、工具清單或假裝精確的工時。

第二步:寫出完整可執行需求

下方是本篇完整提示詞,輸入到已選定 codex-prompt-lab 的 Codex 任務,而不是作業系統終端機。它明確指出一個 HTML 檔案與兩個字串變更,保留無障礙標籤、事件繫結與資料格式,最後要求實際檢查。New task 保持不變是為了保留表單的可見標籤,不是要把所有文字強行改成同一個詞。

自然語言提示詞:貼入練習專案的 Codex 任務 · text
Goal: make the existing todo form wording clearer for a first-time visitor.
Context: this folder is the unchanged Small Steps expected practice version.
In index.html only:
- Change the submit button text from "Add task" to "Save task".
- Change the input placeholder to "Plan one small step".
Keep the visible "New task" label, input id/name, maxlength, required attribute,
button type, JavaScript behavior, stored data and all other files unchanged.
Do not install packages or deploy anything.
Validate by adding Read, completing it, checking Completed, and refreshing.
Check that whitespace-only input does not create a task.
Run node --test core.test.mjs. If browser checks are unavailable, list them as not run.
Report the exact changed strings, files and evidence.

背景已經在檔案裡的資訊,讓 Codex 先讀檔即可;指向精確檔名比複製整份歷史紀錄更有用。如果實際畫面沒有 Add task,先停下核對是否使用原版。不要將不符合起點的要求硬套上去,或讓它在所有檔案搜尋相似文字後全部替換。可重現範例的第一個條件就是起點一致。

第三步:用成果判斷,而不是看回答長度

完成後開啟 index.html,應只看到按鈕文字與 placeholder 改動。New task 仍是與輸入框相連的標籤,type="submit"、id、name、maxlength、required 都保留。再開其他四個檔案與原版比較,確認沒有順手改架構。若 Codex 回覆很短但差異正確、驗證完整,這仍然是好交付;很長的說明不能替代缺少的檔案與結果。

在 http 預覽新增 Read,勾選完成,Completed 應只顯示已完成項目,重新整理後保留。空白輸入不能新增項目;Tab 焦點仍可到達輸入與提交按鈕。這些行為應與修改前一致。若只有文字改對、按鈕不能提交,表示驗收失敗,下一輪要指出實際現象,而不是籠統說「不好用」。

結果不符時,補充一個可重現例子

假設只看到 Save task 改對,而 placeholder 還是舊文。先確認瀏覽器重新整理及檔案已存檔,再發下方追補。這裡明列已正確的部分、目前錯誤與預期,不要求把整個頁面重做。若是你在中途改了需求,也要說明哪個條件取代前一版,避免兩組相反要求同時留在任務裡。

後續提示詞:只在按鈕正確、placeholder 仍錯誤時使用 · text
The button text is correct; preserve that change.
After saving and refreshing, the placeholder still reads "Read the project README".
Expected placeholder: "Plan one small step".
Inspect index.html and correct only the remaining placeholder mismatch.
Report the relevant diff and any verification you can actually perform.

更複雜的情況可以先用列出步驟與不確定點,但規劃不是驗證。計畫說會跑測試,不代表測試已執行;回答說會保留資料,也要檢查真實資料與程式。當需求有會改變方案的缺口,例如是否需要登入或同步,先回答這種問題,再開始相依功能,通常比做完重工更省事。

三種常見問題與修正

改太多:檢查需求是否用了「全面最佳化」「順便全部整理」等擴張範圍的字句,改為列出指定檔案與保留項目,再逐項還原無關差異。一直問問題:補足真正影響決策的條件,普通字型或檔名選擇可授權它依既有風格決定。回答看似完成卻沒證據:要求列出實際命令結果與未執行項目,不要求它換句話說「已完成」。

遇到反覆失敗,先保留最小重現資料、錯誤文字與最後已知正常狀態,再縮小到一個問題;不要每次都重貼整段無關歷史。若任務長到需要交接,可用儲存目前決策。反覆要求的專案慣例則放入 ,每次提示詞只留下這次要完成的變更。

小練習、還原與來源

延伸練習請從另一份全新的 expected 副本開始,先確認按鈕是 Add task、placeholder 是 Read the project README;不要接著使用剛才已改過的副本。自行寫提示詞:只把按鈕改為 Create task,保留這份副本的原始 placeholder。驗收要指出 index.html 唯一改動的字串,並重做新增、空值與重新整理。結束後用保留的 expected 原版恢復各練習副本的 index.html,其他檔案不需替換;Python 伺服器用 Ctrl+C 停止。關閉 Codex 對話不會自動撤銷改字。

提示詞原則依 2026-09-14 的官方 Prompting 文件核對,表單需求、輸入範例與驗收方法是本系列原創。相同英文提示詞在五語內容保持一致;模型回應不保證逐字相同,驗收看實際成果。下一步可練或,把可重現輸入與預期結果帶入更大任務。

需求部分本例的具體內容
目標讓新使用者理解表單
來源expected 的 index.html
限制只改兩個字串、保留資料與行為
驗收新增、完成、空值、重新整理

07. 如何把需求說清楚 — 實作順序示意圖,非產品介面截圖。 Goal → Constraints → Acceptance
07. 如何把需求說清楚 — 實作順序示意圖,非產品介面截圖。 Goal → Constraints → Acceptance · 圖片:Mokaair (© Mokaair)
閱讀完整文字說明

Goal to Constraints to Acceptance

提示詞練習成果:輸入框提示為 Plan one small step;Save task 按鈕有橘色焦點框。
本篇指定修改的參考成果,使用原始練習檔套用指定變更後,在 Windows / Edge 153.0.4234.32 於 2026-09-14 實際截圖。橘框是鍵盤焦點;資料皆為虛構。這是寬 390px 的響應式視窗,非實體手機,也不是 Codex 介面或模型執行紀錄。 · 圖片:Mokaair (© Mokaair)
提示詞練習成果:輸入框提示為 Plan one small step;Save task 按鈕有橘色焦點框。
本篇指定修改的參考成果,使用原始練習檔套用指定變更後,在 Windows / Edge 153.0.4234.32 於 2026-09-14 實際截圖。橘框是鍵盤焦點;資料皆為虛構。這是寬 1280px 的響應式視窗,非實體手機,也不是 Codex 介面或模型執行紀錄。 · 圖片:Mokaair (© Mokaair)

覺得這篇整理實用嗎?分享給需要的朋友

LINE 分享

回總目錄

  • 生活分享

    Codex 學習中心:完整教學目錄

    從安裝、第一個任務到 MD 規則與進階整合,規劃 60 篇 Codex 教學、十個單元。依程度、平台、需求或指令搜尋下一篇;尚未公開的教學會標示狀態,方便安排學習路線。

  • 生活分享

    Worktree 與多任務隔離

    Worktree 讓同一個 Git 程式庫有不同的工作目錄,各自承接不同分支。它適合讓兩項工作分開改檔,但資料庫、連接埠與外部服務仍可能共用,不能把檔案隔離當成所有資源隔離。

  • 生活分享

    實戰:製作小網站

    從 brief.md 規劃並製作 Small Steps 待辦網站,完成新增、完成、刪除、篩選與本機資料保存。將 HTML、CSS、資料函式、畫面事件與測試分開,以 Node 測試和瀏覽器操作驗收,並留下可重新啟動與還原的交接紀錄。

  • 生活分享

    用量與效率:減少重工

    記錄任務條件、模型選項、時間與成果,找出能減少無效重試和過多上下文的調整。

資料來源

本文依據上方所列參考來源與標示之核對日期整理;票價、時刻、功能規格或服務條款可能變動,出發、預訂或購買前請至相關官方網站確認最新資訊。

生活分享