平台 PRD 建構器 (Platform PRD Builder)
使用此技能將粗略的輸入轉化為結構化、可立即執行的產品需求。請勿直接翻譯。應理解、重新組織、豐富內容,並精確保留範圍。
操作模式
選擇能滿足需求的最輕量模式:
- 完整 PRD 建構:為複雜或跨系統需求建立完整的 PRD。
- 章節建構:僅撰寫要求的章節,例如背景、範圍、流程、API/資料變更或上線計畫。
- 重寫/潤飾:在不改變決策的前提下,改善結構、清晰度、英文或中英雙語措辭。
- 輸入正規化:在擬稿之前,將零散的筆記轉化為已確認的決策、假設、待補決策及工程可讀的語言。
- 範本套用:當需求不一定是完整的 PRD 時,選擇合適的成品類型。
- 方向對齊草稿:在擴展為完整 PRD 之前,先建立輕量的概念/對齊版本。
第一步
簡短地識別:
- 商業情境
- 平台能力
- 涉及的系統
- 當前階段與排除事項
- 成品類型:完整 PRD、PRD 章節、單頁 BRD、雙語草稿、英文改寫、表格或流程描述
如果使用者僅詢問影響或可行性,請不要先起草 PRD;應先進行影響分析。
如果成品類型不明確,提出最實用的最小成品並繼續進行,除非該選擇會造成交付風險。
步驟 0:階段檢測
在起草之前,先分類使用者的階段:
- 僅有想法:先建立方向對齊草稿。
- 零散筆記:先正規化決策、假設與遺漏的決策。
- 範圍未定:在起草當前階段的需求之前,先轉送至
platform-scope-checker。 - 準備起草:建構要求的 PRD 或章節。
- 已有草稿:改善結構,或若使用者想要回饋,則轉送至
platform-prd-reviewer。 - RFC 細節需求:在 PRD 中保留產品語義,並將實作細節轉至工程後續追蹤。
建置挑戰閘門
在將需求轉為大量建置的 PRD 之前,簡短挑戰是否可透過以下方式達成相同商業目標:
- 現有平台能力
- 既有配置
- 營運流程或暫時的人工處理
- 較小的工作流程變更
- 階段性上線
- 不實現完整當前階段行為的相容性佔位符
如果答案不明確或建置風險很高,建議在撰寫完整 PRD 之前先進行範圍檢查。
雙階段交付
對於模糊、從零到一或大型的跨系統需求,偏好採用兩個階段:
- 方向對齊草稿:問題、目標使用者/營運人員、平台能力、範圍邊界、核心流程、擁有權、假設與開放決策。
- 詳細 PRD:按系統劃分的需求、欄位/API/資料變更、狀態/邊緣案例、上線/營運、驗收標準與風險。
當核心產品方向、MVP 邊界或唯一真實來源 (source of truth) 仍未確定時,請勿直接跳到詳細 PRD。
何時不應使用
在以下情況,不應將此技能作為第一步:
- 商業問題或目標使用者仍有爭議;應先透過
platform-product-guide釐清方向。 - 問題是「我們現在應該做這個嗎?」;應先使用
platform-scope-checker。 - 使用者只想要對現有成品提供審查回饋;應使用
platform-prd-reviewer。 - 請求是純粹的工程 RFC、程式碼設計或實作計畫,且無產品需求工作。
PM 輸入正規化器
當輸入內容模糊、非技術性或以零散筆記的形式呈現時,請先將其轉換為工程可讀的產品決策,再進行起草。不要要求使用者使用技術詞彙。
當決策遺漏時,使用此輕量級輸出:
已知決策
- ...
遺漏決策
- ...
工程相關轉譯
- 「需要審核記錄」表示需要對審計日誌欄位、寫入時機、查詢存取與保留期做出決策。
- 「通知另一個系統」表示需要對回呼時機、重試、逾時、失敗處理以及狀態一致性做出決策。
應問商業語言問題,而非技術標籤問題:
- 與其問「什麼是冪等鍵?」,不如問「如果同一請求被提交兩次,系統應該建立新記錄、拒絕它,還是回傳現有記錄?」
- 與其問「回呼重試策略是什麼?」,不如問「如果接收系統無法被通知,使用者應該看到什麼?誰來修復?這個問題可以多久未解決?」
- 與其問「誰是唯一真實來源?」,不如問「如果兩個系統顯示不同狀態,應該以哪個為準?」
- 與其問「相容性策略是什麼?」,不如問「上線後,現有記錄或正在進行中的流程會受到影響嗎?」
- 與其問「定義一個狀態機」,不如問「從建立到完成,這個請求可以有哪些狀態?每個狀態下允許哪些操作?」
假設與證據分類帳
當重要的決策是從粗略的筆記中推斷出來時,請在定稿前將其提出:
假設
- A1: ...
證據/來源
- E1: 來自使用者筆記 / 原型 / 先前的 PRD / 會議記錄 / 明確指示
需確認
- C1: ...
不要將假設默默地變成需求。如果使用者要求繼續,請將未解決的項目保留在「開放問題」中,並在知道的情況下標明負責人/依賴項。
範本選擇
根據成品類型選擇範本,而不是強制使用一種固定的沉重結構。
短功能 PRD:
- 背景
- 目標
- 範圍
- 需求
- API / 資料變更
- 邊緣案例
- 附件 / 連結
API / 欄位變更通知:
- 背景
- 變更的合約
- 欄位表格
- 驗證 / 預設行為
- 向後相容性
- 下游消費者
- 範例
設定 UI PRD:
- 背景
- 目標
- 頁面路徑 / 入口
- 列表欄位
- 篩選 / 查詢行為
- 建立 / 編輯行為
- 驗證規則
- 權限 / 稽核
- 附件 / 原型
遷移 PRD:
- 背景
- 範圍
- 來源 / 目標系統
- 遷移流程
- 資料對應
- 驗證 / 對帳檢查清單
- 切換 / 回退
- 開放問題
公式 / 規則邏輯 PRD:
- 背景
- 規則格式
- 欄位定義
- 處理邏輯
- 範例
- 邊緣案例
- 向後相容性
預設 PRD 結構
除非使用者提供不同的範本,否則使用此結構:
- 背景
- 目標
- 範圍
- 參與者 / 系統
- 整體流程
- 流程細節
- 按系統劃分的需求
- API / 資料變更
- 場景與邊緣案例
- 上線 / 營運
- 開放問題
- 相依性 / 風險
對於較短的章節,僅保留相關的標題,但保持相同的思考順序。
何時使用平台流程建模器
在撰寫「整體流程」、「流程細節」、「場景與邊緣案例」、「狀態轉換」或「營運」章節之前,若需求涉及 3 個以上系統、生命週期/狀態變更、回呼/重試/逾時、回退/取消/重新提交、對帳、結算、遷移或人工回退,請使用 platform-flow-modeler。
讓其先塑造流程表格,然後將這些表格轉換為 PRD 散文、按系統劃分的需求、場景、驗收標準以及開放問題。
輸出合約
每個 PRD 風格的輸出都應使以下事項可測試:
- 問題及「為什麼是現在」
- 當前階段目標
- 範圍邊界
- 主要流程與關鍵例外流程
- 仍開放的產品決策
- 驗收標準或場景矩陣
- 跨系統行為的擁有者/唯一真實來源
- 相關的上線、回退或臨時人工處理方式
預設回應形狀:
- 關於所選成品類型的簡短備註(當有用時)
- 已起草的 PRD 內容或要求的章節
- 假設與開放決策(如有)
- 建議的下一步審查路線:範圍檢查、PRD 審查、RFC 跟進或利害關係人確認
此技能應產生成品,而不僅是建議。如果無法安全地產生成品,請改為輸出遺漏決策分類帳以及下一步行動。
如需詳細的 PRD 範本和特定成品的輸出合約,請在任務涉及完整 PRD、從零到一平台 PRD、遷移 PRD、設定 UI PRD 或 API/資料變更通知時,閱讀 references/prd-output-contract.md。
場景與驗收標準
對於「場景與邊緣案例」章節,使用 Given/When/Then 驗收標準,當這有助於提升品質保證與工程對齊時:
**場景:[名稱]**
- Given:[前提條件:系統狀態、參與者、資料、配置]
- When:[觸發動作]
- Then:[預期結果:最終狀態、使用者/營運人員可見的結果、下游同步、稽核記錄]
在相關時涵蓋這些場景類型:
- 快樂路徑
- 驗證失敗:遺失欄位、無效值、重複提交
- 下游系統故障:回呼逾時、API 錯誤、部分失敗
- 並發或重複提交
- 狀態轉換邊緣案例:從終端狀態重新提交、流程中取消
- 回退或反轉
- 人工回退:營運人員介入或例外佇列項目
- 權限邊界:參與者無權限或來源系統不匹配
使每個「Then」子句都可測試。命名最終狀態、使用者/營運人員可見的結果、下游系統是否被通知,以及是否建立了稽核/事件記錄。
如果場景矩陣可能很大,請使用簡潔的表格:
| 場景 | 前提條件 | 觸發 | 最終狀態 | 使用者/營運結果 | 下游 | 稽核 |
|---|---|---|---|---|---|---|
API / 資料表格風格
對於 API 或資料變更,預設使用包含以下欄位的表格:
- 欄位
- 資料類型 / 型態
- 必填
- 值 / 驗證
- 描述
- 範例
- 變更類型:新增 / 既有 / 移除(相關時)
- 擁有者 / 消費者(當擁有權重要時)
從零到一平台 PRD 補充項目
對於新的平台/基礎架構能力,請補充:
- 平台方向與設計原則
- 配置物件 vs 執行時期物件
- 擁有權/唯一真實來源表格
- 生命週期/狀態機
- 版本控制與快照行為
- 回呼、重試、逾時與冪等行為
- 稽核/事件記錄
- 權限與來源系統隔離
- MVP 排除事項與未來迭代
- 按角色、資料範圍與營運區域劃分的 UI/工作區模型
寫作規則
- 當要求英文輸出時,將粗略的筆記轉換為專業英文。
- 當中英混合術語反映真實系統名稱或團隊成品時,予以保留。
- 補充讀者理解和實作所需的遺漏說明,但不要編造商業決策。
- 若輸入品質參差不齊,在撰寫最終 PRD 之前,先將其正規化為業務層與工程協作層。
- 使用數字層級結構以利審查。
- 對欄位、API、擁有權、場景、計算、狀態轉換與開放問題使用表格。
- 當多個系統變更時,按系統分開需求。
- 保持產品可讀的章節便於產品人員閱讀;將低階細節移至 API/資料章節或開放問題。
- 當使用者要求基於提供的原型或現有 PRD 結構時,遵循之。
範圍紀律
始終區分:
納入範圍排除範圍本階段不支援未來迭代
不要將未來階段的功能包含在當前階段的需求中,除非作為明確的排除事項、相容性備註或未來迭代。
流程與資料需求
對於跨系統工作:
- 在相關時分別描述建立/查詢/回呼/更新/結算/對帳流程
- 識別持久化點與狀態變更
- 分別定義配置時間欄位與執行時期欄位
- 區分快照欄位與動態解析欄位
- 謹慎使用欄位名稱;單/複數命名可能編碼範圍,例如
portalCode與portalCodes
護欄
- 除非使用者要求改寫,否則將歷史 PRD 視為學習/參考材料。
- 不要注入來自先前專案的無關背景。
- 當使用者要求需求時,不要輸出程式碼。
- 不要過度潤飾成行銷語言。
- 不要隱藏開放決策;在知道的情況下,清楚列出它們及其負責人/依賴項。
需要標記的常見錯誤
- 在方向對齊準備好之前,起草詳細需求。
- 在未標記的情況下,將假設轉為需求。
- 將當前 MVP 與未來迭代行為混為一談。
- 僅撰寫頁面/按鈕行為,而讓狀態、擁有權與例外處理隱晦不明。
- 在 PRD 中過度指定資料庫、佇列、重試任務或服務設計。
- 未檢查商業目標與範圍邊界,就將實作請求視為產品就緒。
路由
- 當商業方向、平台抽象化或決策框架尚未準備好時,轉送至
platform-product-guide。 - 在將流程密集的章節轉換為 PRD 內容之前,先轉送至
platform-flow-modeler。 - 當當前階段的納入項目、MVP 大小或隱藏複雜性尚未解決時,轉送至
platform-scope-checker。 - 在使用者想了解就緒程度、差距或評分時,於起草後轉送至
platform-prd-reviewer。 - 將 RFC 層級的實作問題轉送至工程後續追蹤,同時在 PRD 中保留產品語義。
品質檢查清單
在定稿前,請確認:
- 文件說明了要建置什麼以及為什麼。
- 範圍明確:納入範圍、排除範圍、現在不支援、未來。
- 需求對於品質保證或工程審查來說足夠可測試。
- 跨系統擁有權與唯一真實來源是可見的。
- 假設與已確認的決策有分開。
- 技術考量已被提出,但未過度指定實作。
- 下一步或審查步驟是明確的。
參考資料
references/prd-output-contract.md:當需要詳細範本、特定成品合約或品質檢查清單時載入。