Community寫作與編輯github.com

linyindong/platform-product-skills

適用於平台、後台、工作流程及金融科技產品團隊的AI技能:PRD撰寫、PRD審查、MVP範圍控制及跨系統協作。

platform-product-skills 是什麼?

此技能旨在幫助產品經理與AI代理將粗略的輸入轉化為結構化、可立即執行的產品需求文件(PRD)。它包含多種操作模式,能根據需求的複雜度選擇最輕量的方式,如撰寫完整PRD、特定章節、重寫潤飾、或先進行方向對齊。技能支援多種平台(如Claude Code、Cursor、Codex),並特別強調範圍紀律,要求明確區分「納入範圍」、「排除範圍」、「本階段不支援」及「未來迭代」四層,避免範圍蔓延。其核心工作流程包含階段檢測、建置挑戰閘門、雙階段交付(方向對齊草案→詳細PRD)、以及將非技術輸入正規化為工程可讀的產品決策。此外,技能內建了豐富的範本庫(如短功能PRD、API變更、遷移PRD等),以及場景與驗收標準撰寫指南,確保輸出可測試、可審查。當需求涉及3個以上系統、生命週期/狀態變更、回呼/重試/逾時等複雜情況時,會引導使用者先使用流程建模器,再將結果轉化為PRD內容。最終,技能會根據產出建議下一步的審查路徑(如範圍檢查、PRD審查、RFC跟進),確保產品開發流程的完整性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add linyindong/platform-product-skills

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

平台 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 之前先進行範圍檢查。

雙階段交付

對於模糊、從零到一或大型的跨系統需求,偏好採用兩個階段:

  1. 方向對齊草稿:問題、目標使用者/營運人員、平台能力、範圍邊界、核心流程、擁有權、假設與開放決策。
  2. 詳細 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 結構

除非使用者提供不同的範本,否則使用此結構:

  1. 背景
  2. 目標
  3. 範圍
  4. 參與者 / 系統
  5. 整體流程
  6. 流程細節
  7. 按系統劃分的需求
  8. API / 資料變更
  9. 場景與邊緣案例
  10. 上線 / 營運
  11. 開放問題
  12. 相依性 / 風險

對於較短的章節,僅保留相關的標題,但保持相同的思考順序。

何時使用平台流程建模器

在撰寫「整體流程」、「流程細節」、「場景與邊緣案例」、「狀態轉換」或「營運」章節之前,若需求涉及 3 個以上系統、生命週期/狀態變更、回呼/重試/逾時、回退/取消/重新提交、對帳、結算、遷移或人工回退,請使用 platform-flow-modeler。

讓其先塑造流程表格,然後將這些表格轉換為 PRD 散文、按系統劃分的需求、場景、驗收標準以及開放問題。

輸出合約

每個 PRD 風格的輸出都應使以下事項可測試:

  • 問題及「為什麼是現在」
  • 當前階段目標
  • 範圍邊界
  • 主要流程與關鍵例外流程
  • 仍開放的產品決策
  • 驗收標準或場景矩陣
  • 跨系統行為的擁有者/唯一真實來源
  • 相關的上線、回退或臨時人工處理方式

預設回應形狀:

  1. 關於所選成品類型的簡短備註(當有用時)
  2. 已起草的 PRD 內容或要求的章節
  3. 假設與開放決策(如有)
  4. 建議的下一步審查路線:範圍檢查、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:當需要詳細範本、特定成品合約或品質檢查清單時載入。

相關技能