opencode-workflow/skills/write-a-prd/README.zh-TW.md

產品需求文檔 (Write-a-PRD) 技能指南

概述

write-a-prd 技能將抽象的功能需求轉化為結構化的產品需求文檔 (PRD)。它結合了用戶訪談、代碼分析和模組設計，最終產出一份開發者可直接執行的技術準則。

🚀 運作流程

1. 需求挖掘：要求用戶提供詳細的問題描述與初步解決方案想法。
2. 現況核實：探索現有代碼庫，驗證用戶的假設並理解技術現狀。
3. 壓力訪談：調用類似 grill-me 的邏輯，對方案的每個細節進行深度追問，直到達成共識。
4. 模組設計：
   • 規劃需要建立或修改的模組。
   • 追求深層模組 (Deep Modules)：將複雜功能封裝在簡單、穩定且可獨立測試的接口中。
   • 與用戶確認模組劃分及測試優先級。
5. 正式撰寫：根據標準模板撰寫 PRD。
6. 提交發佈：將 PRD 保存為文件並提交為 GitHub Issue。

📥 輸入與輸出

輸入 (Input)

• 用戶對問題的詳細描述。
• 潛在的解決方案想法。
• 現有代碼庫的上下文。

輸出 (Output)

• 路徑：docs/prd/{date}-{feature}.md
• 格式 (PRD 模板)：
  • 問題陳述 (Problem Statement)：從用戶視角描述目前面臨的痛點。
  • 解決方案 (Solution)：從用戶視角描述解決後的狀態。
  • 用戶故事 (User Stories)：格式為 作為 <角色>, 我想要 <功能>, 以便於 <獲益>。
  • 實作決策 (Implementation Decisions)：模組變更、接口定義、架構決定、Schema 變更等（不含具體文件路徑）。
  • 測試決策 (Testing Decisions)：定義測試標準、確定測試模組及參考案例。
  • 超出範圍 (Out of Scope)：明確定義本次開發不包含的功能。
  • 補充筆記 (Further Notes)：其他相關資訊。

🔒 注意事項

• 工作環境：建議在獨立的 worktree 中運行。
• 同步性：最終 PRD 必須同步至 GitHub Issue 以便團隊追蹤。