官方技能 · 產品
開發前的規格審查
在開發前審查 PRD 或規格:模糊的用詞、缺少的空白/載入/錯誤/權限狀態、指標、推出計畫,並以新使用者身分走查流程。
可在 Claude、ChatGPT 和程式設計代理中使用。使用 Team 和 Business 方案時,我們改進官方技能後,你 Pod 裡的這個技能會自動更新。
適用情境
- PRD 或規格即將交給工程團隊估工
- 某個功能上線後出現意外,下一份規格需要更嚴格地檢查
你要提供的內容
- 規格或 PRD 的文字
- 目標使用者(選填)
- 期限和團隊(選填)
你會得到的內容
一個結論、新使用者的流程走查、附原文引用的阻礙與應修正項目、狀態表,以及指標和推出計畫的檢查。
運作方式
- 以第一次使用的使用者身分走一遍流程 從使用者進來的地方開始(email 連結、導覽選單項目、空白帳戶),逐步敘述:他看到什麼、必須決定什麼、點了什麼。規格沒寫接下來會出現什麼的地方,就記一個缺口。任何會讓新手困惑的標籤或問題,也記下來。
- 檢查每個畫面的狀態 每個畫面或元件都要找:空白(第一次使用、沒有結果)、載入中、錯誤、部分資料、無權限,以及成功。NN/g 建議空白狀態要顯示系統狀態、教使用者怎麼開始,並提供直接通往任務的路徑;資料還在載入時,絕不顯示「沒有資料」。錯誤訊息應該看得到、用白話、有建設性,並保留使用者已輸入的內容。
- 找出模糊的用詞 標出「快速」、「容易」、「簡單」、「直覺」、「應該」、「等等」、「和/或」、「一些」和「視需要」。每一個都需要一個數字、一份清單或一個決定。標出任何兩個讀者會測出不同結果的需求。
- 檢查規則和限制 誰可以做這件事?可以做幾次?到達上限時會怎樣?上線時,既有的資料和使用者怎麼處理?如果缺少的答案會改變資料模型,就是阻礙問題。
- 檢查指標 必須有一個與問題相關的主要指標、基準值、目標值,以及衡量方式。如果要計數的事件還不存在,那就是規格漏掉的需求。
- 檢查推出與回復計畫 是否用功能旗標控制?誰先看到(內部、一定比例、某個客群)?什麼指標會觸發回復?能不能不經過發布就關掉?Martin Fowler 對功能開關的說明,區分了發布開關、依比例逐步推出,以及緊急關閉開關(kill switch);緊急關閉開關必須能快速切換,不需要新的發布。
- 排序並寫出發現 阻礙 = 團隊無法開發或測試,或會危及資料或信任。應該修正 = 會造成重工或混淆。小問題 = 用字。每項發現都引用規格原文、說明為什麼重要,並提出修正方式或問題。
分享給你的團隊
把它加入 AI Skill Pod,團隊每個人(外包人員也包括在內)都能從自己的 AI 使用同一個版本。 看看和團隊分享 AI 技能的最佳做法
更新紀錄
- v1.0.1 · · Example: S1's "3 clicks or fewer" is marked [our suggestion], as the checks require for defaults the review proposes.
- v1.0.0 · · First release.
參考來源
- Designing Empty States in Complex Applications: 3 Guidelines - NN/G (2026-11-04 查閱)
- Error-Message Guidelines - NN/G (2026-11-04 查閱)
- Feature Toggles (aka Feature Flags) (Martin Fowler) (2026-11-04 查閱)