| name | prd |
| description | 撰寫本專案的 PRD (產品需求文件)，位置為 /docs/specs/{type}/{ID-PREFIX}_{desc}/PRD_spec.md。當使用者提到「PRD、產品需求、需求文件、寫規格、新功能規劃、acceptance criteria」時觸發。分級 SDD 之 T2（完整流程）的 Phase 1，產出物提供給 sa skill 銜接；T1 輕量案件不需獨立 PRD。 |
Product Requirement Document (PRD) Skill
本技能旨在協助撰寫結構完整、邏輯清晰的產品需求文件 (PRD)。PRD 是產品的核心藍圖，它告訴我們「為什麼要建構這個產品」以及「它應該具備什麼功能」。
適用層級：本 skill 屬於分級 SDD 的 T2（完整流程）Phase 1。
T1 輕量案件直接用 sdd skill 的單檔 SPEC.md 即可，不需獨立 PRD；
分級判準見 .agent/skills/sdd/SKILL.md（單一事實來源）。
為何需要 PRD？
- 對齊目標: 確保開發者、設計師和利害關係人對產品有共同的理解。
- 減少歧義: 透過清晰的文字與圖表，將模糊的想法轉化為具體的需求。
- 作為測試基準: PRD 中的驗收標準 (Acceptance Criteria) 是 QA 測試的依據。
PRD 核心組成
一份完整的 PRD 通常包含以下章節：
- 背景與目標 (Background & Goals): 為什麼要做？解決什麼問題？成功指標是什麼？
- 使用者故事 (User Stories): 誰是使用者？他們想要做什麼？為了達到什麼目的？
- 功能需求 (Functional Requirements): 具體的系統行為描述。
- 非功能需求 (Non-Functional Requirements): 性能、安全性、可靠性等限制。
- UI/UX 流程 (User Interaction): 頁面流程圖、Wireframe 或 Mockup 連結。
- 數據埋點 (Analytics): 需要追蹤哪些使用者行為數據。
- 未包含範圍 (Out of Scope): 明確定義什麼 不做，以避免範圍蔓延 (Scope Creep)。
如何使用此 Skill
當 User 提出一個模糊的想法 (e.g., "我想做一個讓使用者可以分享書籤的功能")，請依循以下步驟：
- Initial Interview: 詢問 User 關鍵問題 (Who, Why, What)。
- Drafting: 使用
template_comprehensive.md (完整版) 或 template_simple.md (簡易版) 起草 PRD。
- Review: 請 User 審閱草稿，確認是否符合預期。
- Finalize: 定稿後，這份 PRD 將成為後續 SA (系統分析) 和 SDD (開發規格) 的輸入。
技巧與最佳實踐
- 使用清晰的語言: 避免 "可能"、"應該" 等模糊詞彙，使用 "必須" (Shall/Must)、"可以" (Can) 等明確用語。
- 圖文並茂: 盡量使用流程圖 (Mermaid) 來輔助文字說明。
- 保持更新: PRD 是活的文件 (Living Document)，若需求變更，務必更新 PRD。
本專案 PRD 慣例（呼應 sdd skill）
- 檔案位置：
/docs/specs/{type}/{ID-PREFIX}_{desc}/PRD_spec.md
type：feature / fix / refactor / choreID_PREFIX：ISSUE-{n}（一般功能／bug，對應 GitHub Issue）／PR-{n}（外部貢獻無 Issue）／BASE-{n}（歷史補規格）
- Functional Requirements：建議使用 EARS syntax（Event-driven / Unwanted / State / Optional / Complex）。
- Acceptance Criteria：必須使用 Given-When-Then 三段式，每條 AC 都要可驗證。
- Out of Scope：明確列出「這次不做」的項目，避免 scope creep；後續若補做，另立 PRD 版本。
- Living Document：Frozen 後變更須 bump 版本（v1.0 → v1.1），在 Revision History 記原因。
Chrome Extension 專案的 PRD 重點
- 使用者介面類型：明確標註是 sidepanel / popup / content script / new tab override / context menu。
- 權限申請：列出新功能要 manifest.json 加哪些
permissions / host_permissions，並說明最小化策略。
- 跨裝置同步：若涉及
chrome.storage.sync，要評估 quota（每項 8KB，總計 100KB）。
- 多語系影響：若新增 UI 文案，要在 PRD 提醒「同步觸發 update-multilingual-docs」。
