前言¶
產品側常見情況是：discovery 已經做完，材料散落在筆記、Slack 線程和會議記錄裏，工程要開工時卻缺一份能把問題、用戶、方案和成功標準串起來的文檔。直接讓 Agent「寫一份 PRD」，往往得到泛泛的模板，既難對齊干係人，也難作爲工程交接的單一事實來源。
下面介紹的是 Product Manager Skills 庫中的 prd-development workflow：用固定章節與分階段引導，把零散輸入填進結構化 PRD，並標出假設與未決問題，面向 major initiative 的工程就緒文檔，而不是瀑布式一次性規格。
這是什麼¶
prd-development 是類型爲 workflow、主題 pm-artifacts 的 Agent Skill，維護方與源碼位於 deanpeters/Product-Manager-Skills 倉庫的 skills/prd-development 目錄。
官方描述：將 problem framing、用戶研究歸納、方案定義與 success criteria 編排進一份 cohesive 的 PRD；適用於把 discovery notes 轉成 engineering-ready document。單次引導對話的預估時長在 Skill 元數據中爲 60–120 分鐘；完整 workflow 在資料中寫明爲 8 個階段、約 2–4 天，並會調用多個 component / interactive skills。
它強調 PRD 是 living document：保留戰略上下文、客戶問題、方案與成功標準，隨交付學習而演進；不是逐像素 UI spec，也不替代協作對話。
核心功能¶
PRD 要回答的問題¶
Skill 將 PRD 定義爲結構化回答以下七點：
- 解決什麼問題（Problem statement）
- 爲誰解決（Target users / personas）
- 爲什麼現在做（Strategic context）
- 做什麼（Solution overview）
- 如何衡量成功（Metrics / success criteria）
- 具體需求是什麼（User stories、acceptance criteria、constraints）
- 明確不做什麼（Out of scope）
標準文檔骨架（10 節）¶
輸出對齊官方模板，章節包括：Executive Summary、Problem Statement、Target Users & Personas、Strategic Context、Solution Overview、Success Metrics、User Stories & Requirements、Out of Scope、Dependencies & Risks、Open Questions。各節在 Skill 內附有可複製的 Markdown 大綱，便於直接填充。
template.md 與缺口標記¶
實際填寫以同目錄下的 template.md 爲載檔。資料中說明該模板包含：
- 每節的 Instructions、Steps、Contributing Skills、Activities，便於脫離主 workflow 自學填寫
- 行內缺口標記：Assumption（合理但未驗證）與 Open Question（待發現），標在缺口出現處
- 每節結束前的「Before moving on」一致性檢查
- 第 10 節後的自評：最強/最弱章節、待驗證假設、分享前的建議下一步
- 與約 15 個相關 Skill 的交叉引用表（例如
problem-framing-canvas對應第 2 節，epic-breakdown-advisor對應第 7 節）
分階段編排（8 phases）¶
Workflow 按 facilitation 順序推進；資料完整給出的前兩階段示例如下：
Phase 1：Executive Summary（約 30 分鐘）
目標是一段給「掃讀者」看的概述。推薦句式：We're building [solution] for [persona] to solve [problem], which will result in [impact]. 建議先寫 forcing clarity，全部章節完成後再回頭潤色。
Phase 2：Problem Statement（約 60 分鐘）
目標是把問題框定清楚（後續階段在截斷資料中延續）。
以對話方式運行時，交互協議引用同倉庫的 workshop-facilitation Skill：單次一問、進度標籤、中斷與暫停恢復、決策點的編號建議等；若與本文 workflow 衝突，以 prd-development 的 workflow 邏輯爲準。
輸入與調用方式¶
- 最適合攜帶：本次 PRD 所覆蓋的 feature 或 initiative（
argument-hint爲[feature or initiative]）。 - 可同時粘貼：discovery notes、problem statements、用戶研究、成功指標、約束；已有內容會落入對應階段，已回答項不再重複追問。
- Skill 名後的文本、
ARGUMENTS:行或整段 context dump 均視爲已給答案。 - 空手調用也可以：從 problem definition 起逐步搭建。
官方示例 invocation：
Build a PRD for self-serve workspace provisioning — here are my discovery notes and the OKR it ladders to.
明確不做什麼（Anti-Patterns）¶
- 不是詳細 spec，不替代設計稿級 UI 說明
- 不是凍結合同的瀑布文檔
- 不替代面對面協作
不適合：小 bug 修、 trivial feature；問題與方案已對齊時可直接寫 user stories；持續 discovery 實驗宜用 Lean UX Canvas 等路徑（Skill 原文如此建議）。
安裝與啓用¶
Skill 本體是倉庫內的 SKILL.md 及配套 template.md 等文本，屬通用 Agent Skills 形態。父倉庫 Product-Manager-Skills 標明可用於 Claude Code、Cursor、Codex 等；並出現在 Claude Code Plugin Marketplace 文檔鏈路中。社區索引 awesome-agent-skills 給出的通用做法如下（針對整個 skill 集合或 GitHub 路徑，而非單獨安裝腳本）：
Claude Code：
/skills add <github-url>
可將本 Skill 的目錄或倉庫 URL 交給平臺文檔中的 add 流程（具體以 Claude Code 當前 skills 文檔爲準）。
Claude.ai： 在新對話中粘貼 SKILL.md 的 raw URL。
Codex / GitHub Copilot 等： 按各平臺「Agent Skills」文檔將 skill 目錄納入 agent 可見範圍。
Vercel skills CLI（社區推薦）：
npx skills find prd-development
npx skills add deanpeters/Product-Manager-Skills
npx skills list
安裝後通過自然語言要求 Agent 使用 prd-development，並帶上 initiative 名稱與已有材料即可。本 Skill 資料未單獨列出 Cursor 專有配置文件名；在 Cursor 中通常與同類 Skill 一樣，將 skill 納入項目或用戶 skills 目錄後由 Agent 按需加載 SKILL.md。
典型用法¶
- 確定 major feature 或 initiative 名稱。
- 整理已有的 discovery、OKR、約束，準備一次性粘貼。
- 調用 Skill，例如：
prd-development
Build a PRD for [your feature] — [paste discovery notes, metrics, constraints]
- 按階段回答引導問題；模板中無法確認處讓 Agent 標 Assumption / Open Question。
- 完成第 10 節後做自評，再對外分享或交給工程做 handoff。
父倉庫 README 中的場景示例與 Skill 元數據一致，例如：電商 AI 推薦功能需要 PRD；discovery sprint 結束後要把結論轉成工程師可執行的文檔。
適用場景與注意¶
更適合：
- 從零寫完整 PRD（
best_for原文） - 重大新功能開發前的需求結構化
- 跨職能對齊範圍與需求，並留存決策記錄
時間與預期：
- 元數據
estimated_time：60–120 min（偏單次 facilitated 會話） - Application 一節：8 phases / 2–4 days（含多 Skill 編排的完整產出）
注意：
- 工程側需要的是 problem → personas → solution → metrics → stories 的閉環；缺證據的段落應保留 Open Question，避免 Scope creep 與「按 PM 腦內版本開發」。
- 與庫內
user-story、problem-framing-canvas、epic-breakdown-advisor等 Skill 可組合；PRD 第 7 節用戶故事質量可再單獨用 user-story Skill 收緊。 - 許可證以父倉庫爲準（資料載明 CC BY-NC-SA 4.0，版本標籤以倉庫 release 爲準）。
結尾¶
prd-development 把 PM 交付物寫作從「一次性生成文檔」拉回到可覈對的分階段 workflow：標準十節結構、模板內教練塊與假設標記，並指向工程可執行的 user stories 與 acceptance criteria。若你手頭已是 discovery 碎片，可以用它收斂成單一 PRD 事實來源。
官方路徑：https://github.com/deanpeters/Product-Manager-Skills/tree/main/skills/prd-development
