官方技能 · 產品

開發前的規格審查

在開發前審查 PRD 或規格:模糊的用詞、缺少的空白/載入/錯誤/權限狀態、指標、推出計畫,並以新使用者身分走查流程。

可在 Claude、ChatGPT 和程式設計代理中使用。使用 Team 和 Business 方案時,我們改進官方技能後,你 Pod 裡的這個技能會自動更新。

適用情境

你要提供的內容

你會得到的內容

一個結論、新使用者的流程走查、附原文引用的阻礙與應修正項目、狀態表,以及指標和推出計畫的檢查。

運作方式

  1. 以第一次使用的使用者身分走一遍流程 從使用者進來的地方開始(email 連結、導覽選單項目、空白帳戶),逐步敘述:他看到什麼、必須決定什麼、點了什麼。規格沒寫接下來會出現什麼的地方,就記一個缺口。任何會讓新手困惑的標籤或問題,也記下來。
  2. 檢查每個畫面的狀態 每個畫面或元件都要找:空白(第一次使用、沒有結果)、載入中、錯誤、部分資料、無權限,以及成功。NN/g 建議空白狀態要顯示系統狀態、教使用者怎麼開始,並提供直接通往任務的路徑;資料還在載入時,絕不顯示「沒有資料」。錯誤訊息應該看得到、用白話、有建設性,並保留使用者已輸入的內容。
  3. 找出模糊的用詞 標出「快速」、「容易」、「簡單」、「直覺」、「應該」、「等等」、「和/或」、「一些」和「視需要」。每一個都需要一個數字、一份清單或一個決定。標出任何兩個讀者會測出不同結果的需求。
  4. 檢查規則和限制 誰可以做這件事?可以做幾次?到達上限時會怎樣?上線時,既有的資料和使用者怎麼處理?如果缺少的答案會改變資料模型,就是阻礙問題。
  5. 檢查指標 必須有一個與問題相關的主要指標、基準值、目標值,以及衡量方式。如果要計數的事件還不存在,那就是規格漏掉的需求。
  6. 檢查推出與回復計畫 是否用功能旗標控制?誰先看到(內部、一定比例、某個客群)?什麼指標會觸發回復?能不能不經過發布就關掉?Martin Fowler 對功能開關的說明,區分了發布開關、依比例逐步推出,以及緊急關閉開關(kill switch);緊急關閉開關必須能快速切換,不需要新的發布。
  7. 排序並寫出發現 阻礙 = 團隊無法開發或測試,或會危及資料或信任。應該修正 = 會造成重工或混淆。小問題 = 用字。每項發現都引用規格原文、說明為什麼重要,並提出修正方式或問題。

分享給你的團隊

把它加入 AI Skill Pod,團隊每個人(外包人員也包括在內)都能從自己的 AI 使用同一個版本。 看看和團隊分享 AI 技能的最佳做法

加入我團隊的 Pod

更新紀錄

參考來源

  1. Designing Empty States in Complex Applications: 3 Guidelines - NN/G (2026-11-04 查閱)
  2. Error-Message Guidelines - NN/G (2026-11-04 查閱)
  3. Feature Toggles (aka Feature Flags) (Martin Fowler) (2026-11-04 查閱)