AI PRD:撰寫可實際約束模型系統的需求規格 是做什麼的?
針對AI系統的PRD是一份不同的文件。你的需求不是給工程師的指示,而是對一個會即興發揮的系統所設下的約束。這項技能圍繞這個事實重新建構文件。
此技能驅動的檔案
- ../../templates/definition/prd.md,基礎PRD範本
templates/ai/中的AI覆蓋層:eval-spec.md、guardrails.md、hallucination-controls.md、human-approval-gates.md、prompt-structure.md、context-management.md、red-team-review.md,以及針對代理型系統的 agent-architecture.md 與 multi-agent-workflow.md- 受監管情境:../../modules/regulated/templates/regulated-ai-prd-template.md,由 ../../modules/regulated/SKILL.md 驅動
使用時機
- 規範任何由LLM、代理或模型做出或草擬決策的功能
- 審查一份隨處寫著「AI應該……」的現有PRD
- 將示範轉變為工程團隊可以承擔責任的產品
此技能強制的五個章節
1. 驗收標準是評估集,而非句子
「代理應該提取商戶名稱」是一個願望。需求應該是:
- 一個帶標籤的範例集(首次發布至少30至50個案例)
- 以數字表示的通過門檻(準確率、召回率@k,或評分者分數)
- 低於門檻時的處理規則(封鎖發布,而非「審查」)
對於草稿中的每個「應該」,問:範例集在哪裡、數字是多少、誰負責將失敗案例加回集合中。將答案記錄在 ../../templates/ai/eval-spec.md。
2. 邊界案例是規格本身,而非附錄
快樂路徑是模型免費提供的行為。文件的價值體現在邊界處。要求明確的表格:
- 必須拒絕:系統拒絕回應的輸入(超出範圍、不安全、無法修復的模糊)
- 必須升級:路由到人類的條件,並指名路由目標;在 ../../templates/ai/human-approval-gates.md 中記錄觸發條件與超時行為
- 絕不捏造:虛構比缺失更糟的欄位(數字、姓名、法律或法規陳述、貨幣金額);棄權政策位於 ../../templates/ai/hallucination-controls.md
3. 非確定性需白紙黑字寫明
相同的輸入可能在明天產生不同的輸出。PRD必須說明:
- 哪些輸出變異是可接受的(措辭?排序?格式?)
- 哪些是缺陷(不同的決策、不同的數字、不同的拒絕行為)
- 可重現性姿態:溫度與種子政策,以及日誌是否足以捕捉每次決策以進行重播
如果PRD未說明這點,QA稍後會在錯誤追蹤器中憤怒地決定它。
4. 護欄是具有負責人的功能
每個護欄在 ../../templates/ai/guardrails.md 中佔有一行:名稱、觸發條件、行為、負責人、測試。任何代理型功能所需的最低考量集:
- 無法驗證的輸出即失敗關閉(無法檢查 = 不要出貨給使用者)
- 任何不可逆操作(發送、付款、刪除、發文)前需經人類核准
- 支出與速率上限,附帶明確上限與達到上限時的行為
- 輸入隔離:系統讀取的內容是資料,絕非指令
- 稽核軌跡:誰或什麼做了決策、基於哪些輸入、使用哪個模型版本
5. 操作頁面
- 每次呼叫的成本目標與警示門檻
- 每一步的延遲預算
- 模型版本固定與升級決策流程
- 遙測:每次決策記錄了哪些資料、評估在哪裡執行(CI、預發布、正式環境抽樣),以及回滾觸發條件
受監管路徑
通用PRD工具會撰寫上述五個章節並止步。當產品位於金融或資料監管機構之下時,不要憑記憶執行此技能自身的覆蓋層。請改從 ../../modules/regulated/templates/regulated-ai-prd-template.md 的位元精確範本開始,遵循 ../../modules/regulated/SKILL.md,並在撰寫任何需求之前完成其第0章節(許可證前提條件、方案規則、資料駐留與供應商條款、金融犯罪接觸點、行為準則、審計證明指標)。空白的覆蓋層欄位就是一個遞延決策,留給未來發現它空白的人決定。監管機構名稱、章節編號與引述文字僅來自該模組或使用者提供的主要文本;切勿憑空捏造。
工作流程
- 分類情境。受監管:先遵循上述受監管路徑,再回頭處理模組未涵蓋的章節。非受監管:從 ../../templates/definition/prd.md 開始。
- 閱讀PRD草稿,或若從零開始則訪談產品經理。
- 將每個「應該」陳述改寫成第1章節的形式。列出那些無法轉化為評估集的項目;這些還不是需求,請標記它們。
- 建立三個邊界案例表格。每個表格至少推至5行;空白表格表示探索尚未完成。
- 撰寫非確定性條款與護欄表格。
- 產生一頁GAPS清單:原始文件中假設存在確定性執行者的每個地方,按影響範圍排序。
輸出格式
回傳重構後的PRD,包含五個章節,接著是GAPS表格:
| # | 差距 | 原始位置 | 照原樣出貨的影響範圍 | 最小修正方案 |
|---|
出口閘門
此技能的輸出會饋入 ../../os/STAGE-GATES.md 中的閘門2。當任何需求缺乏數值通過條件、任何護欄缺乏負責人與測試,或任何GAPS行缺乏負責人與日期時,請勿報告PRD已完成。