)
使用 awesome-copilot 的 breakdown-epic-pm 技能編寫 Epic 級產品需求文檔PRD【免費下載鏈接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.項目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot在大型 SaaS 平臺的規劃流程中Epic 級 PRD 是從高層想法走向技術實現的第一個關鍵產物它把模糊的業務愿景翻譯成工程團隊可以依賴的唯一事實來源并作為生成技術架構規格的輸入。本指南基于當前開源倉庫 awesome-copilot 中的 breakdown-epic-pm 技能 展開講解如何讓 GitHub Copilot 扮演資深產品經理把一次性的 Epic 想法轉化為結構完整、可直接驅動架構設計的 Markdown PRD。讀完本文你將掌握該技能的目標設定、八段式 PRD 結構、上下文模板的用法以及它與倉庫中架構拆解、功能級 PRD、項目計劃和測試規劃等配套技能的銜接方式。技能定位從 Epic 想法到 PRD 的翻譯器breakdown-epic-pm是 awesome-copilot 倉庫skills/目錄下的一個 Agent Skill。其SKILL.md的 frontmatter 中name為breakdown-epic-pmdescription明確了職責邊界Prompt for creating an Epic Product Requirements Document (PRD) for a new epic. This PRD will be used as input for generating a technical architecture specification.——也就是說該技能的輸出不是終點而是起點它生成的 PRD 會被進一步消費用于產出 Epics 級技術架構規格。該技能與同倉庫的 breakdown-epic-arch把 PRD 翻譯成高層技術架構、breakdown-feature-prd把 Epic 中的 Feature/Enabler 細化成功能級 PRD共同構成先產品、后架構、再功能的逐層拆解流水線并被 project-planning 插件 打包為可一鍵安裝的/project-planning:breakdown-epic-pm斜杠命令。技能目標以專家產品經理身份工作SKILL.md的 Goal 部分要求 Agent 扮演大型 SaaS 平臺的專家產品經理核心職責是把高層想法翻譯為詳細的 Epic 級 PRD并確立該 PRD 的地位作為工程團隊的唯一事實來源single source of truth作為生成 Epic 級**技術架構規格technical architecture specification**的輸入。技能同時給出兩條工作準則信息不足時主動提問如果用戶請求中的信息不足以覆蓋 Epic 的各個方面Agent 應提出澄清問題而不是臆測填充。這與倉庫中 first-ask、what-context-needed 等技能先弄清范圍再動手的理念一脈相承。完整輸出產出應是完整的、Markdown 格式的 Epic PRD。輸出格式與保存路徑約定該技能規定了標準化的落盤路徑/docs/ways-of-work/plan/{epic-name}/epic.md其中{epic-name}是 Epic 的短名。這一路徑約定并非孤例——倉庫中的配套技能使用同一目錄族breakdown-epic-arch輸出到/docs/ways-of-work/plan/{epic-name}/arch.mdbreakdown-feature-prd輸出到/docs/ways-of-work/plan/{epic-name}/{feature-name}/prd.mdbreakdown-plan則產出project-plan.md與issues-checklist.md。統一的目錄結構讓Epic 命名空間下的產品文檔、架構文檔、功能文檔與計劃文檔可以互相鏈接、層層追蹤這與 breakdown-plan 強調的從 Epic 級規劃到單個實現任務的完整可追蹤性目標完全一致。Epic PRD 的八段式標準結構SKILL.md定義了 8 個必需章節逐一說明如下。1. Epic NameEpic 名稱為 Epic 給出一個清晰、簡潔且具描述性的名稱。名稱是后續所有文檔架構規格、功能 PRD、GitHub Issue引用的錨點應當一眼就能傳達業務意圖例如多租戶計費重構而不是計費 2.0。2. Goal目標目標章節必須拆成三個子項Problem問題用 35 句話描述該 Epic 要解決的用戶問題或業務需求。要寫到為什么現在必須做的程度。Solution解決方案從高層解釋 Epic 如何解決上述問題。此處不涉及具體技術選型——技術細節留給 breakdown-epic-arch 生成的架構規格。Impact影響說明預期改善的成果或指標例如用戶參與度、轉化率、收入等。為后續 Success Metrics 提供可度量的方向。3. User Personas用戶畫像描述該 Epic 的目標用戶。畫像應具體到可以支撐后面的用戶旅程與驗收判斷身份、使用場景、核心訴求與痛點。目標用戶也可以在后續的 Context Template 中由用戶預填初稿再經 Agent 完善。4. High-Level User Journeys高層用戶旅程描述該 Epic 啟用的關鍵用戶旅程與工作流。旅程是高層的端到端敘事用戶如何發現、使用、完成目標不必細化到界面控件——那是功能級 PRD見 breakdown-feature-prd 的 User Stories 章節的職責。5. Business Requirements業務需求Functional Requirements功能需求從業務視角出發的詳細清單說明 Epic 必須交付什么。每條應明確、無歧義可作為后續驗收的依據。Non-Functional Requirements非功能需求約束與質量屬性清單例如性能、安全、可訪問性、數據隱私。質量屬性在后續測試階段會進一步對應到 breakdown-test 中引用的 ISO 25010 質量模型功能適合性、性能效率、安全性、可維護性等八大特性因此此處寫得越具體后續測試策略越有據可依。6. Success Metrics成功指標列出用于衡量 Epic 成敗的關鍵績效指標KPIs。這些指標應與第 2 章的 Impact 呼應并最終在 breakdown-plan 的項目計劃中以 Success Criteria 的形式落為可測的目標值。7. Out of Scope不在范圍內明確列出本 Epic不包含的內容以避免范圍蔓延scope creep。顯式的邊界聲明是大型規劃文檔專業性的體現它既保護工程團隊不被隱性需求突襲也為后續功能拆解哪些 Feature 放本 Epic、哪些放后續 Epic提供了判斷依據。8. Business Value業務價值給出業務價值的量級估計例如 High / Medium / Low并附簡短理由。該估值會在 breakdown-plan 的Priority and Value Matrix中與優先級一起被翻譯成 GitHub 標簽如value-high、value-medium、value-low成為 Issue 自動化的輸入。Context Template 上下文模板SKILL.md末尾提供了一段最小上下文模板用于啟動對話- **Epic Idea:** [A high-level description of the epic from the user] - **Target Users:** [Optional: Any initial thoughts on who this is for]Epic Idea是必填的用戶輸入即 Epic 的高層描述——哪怕只有一兩句話Agent 也會據此展開并在信息不足時提出澄清問題。Target Users是可選輸入用于預填用戶畫像的初步想法。實際使用時直接把這段模板粘貼到對話中并替換方括號內容即可例如- **Epic Idea:** 為 B2B 客戶提供自助式用量分析與賬單導出能力替代當前的郵件賬單。 - **Target Users:** 企業客戶的財務管理員與采購負責人。在拆解流水線中的位置PRD 之后會發生什么為了把breakdown-epic-pm的輸出用到位需要理解它在倉庫Epic Feature Story/Enabler Test規劃層級中的上游與下游關系該層級結構在 breakdown-plan 中有完整定義輸入用戶的一次性 Epic 想法 可選的目標用戶初稿。本技能產出 Epic PRDepic.md。下游——架構breakdown-epic-arch 以 Epic PRD 為輸入扮演資深軟件架構師產出高層架構規格arch.md內容包括 Mermaid 系統架構圖用戶層、應用層、服務層、數據層、基礎設施層、技術棧、技術價值與 T 恤尺碼估算。其 Context Template 第一項就是 Epic PRD:[The content of the Epic PRD markdown file]——可見 PRD 是架構的硬性輸入。下游——功能breakdown-feature-prd 從 Epic 中選取 Feature/Enabler細化成功能級 PRD其章節Goal、User Personas、User Stories、Requirements、Acceptance Criteria、Out of Scope與 Epic PRD 一脈相承并增加了 Given/When/Then 形式的驗收標準。下游——計劃與測試breakdown-plan 匯總各產物生成 GitHub 項目計劃與 Issue 清單breakdown-test 基于 PRD、技術拆解與實現計劃制定測試策略。可以這樣概括完整鏈路Epic 想法 →breakdown-epic-pm→ Epic PRD →breakdown-epic-arch→ 架構規格 →breakdown-feature-prd→ 功能 PRD →breakdown-plan / breakdown-test→ 項目計劃與測試策略。安裝與使用方式該技能在倉庫中的安裝與啟用有以下幾種途徑方式一通過插件安裝推薦breakdown-epic-pm已被打包進 project-planning 插件插件清單中extensions[com.github.awesome-copilot].skills數組明確列出了./skills/breakdown-epic-pm/。使用 Copilot CLI 安裝插件copilot plugin install project-planningawesome-copilot安裝后即可通過斜杠命令/project-planning:breakdown-epic-pm觸發插件的命令說明見 plugins/project-planning/README.md。方式二作為獨立 Skill 安裝根據 docs/README.skills.md 的說明技能是包含SKILL.md指令文件的獨立文件夾可隨需加載。安裝方式使用 GitHub CLIgh skills install github/awesome-copilot breakdown-epic-pm需要 GitHub CLI v2.90.0或者將技能文件夾手動復制到本地 skills 目錄。使用方式在對話中粘貼 Context Template 并填充 Epic 想法Agent 會以產品經理身份展開 PRD信息不足時先提問澄清最終將完整 PRD 保存到約定的/docs/ways-of-work/plan/{epic-name}/epic.md路徑供后續架構拆解直接引用。小結breakdown-epic-pm解決的是大型 SaaS 規劃中從想法到可執行需求的第一個落地問題通過為 Agent 設定產品經理角色、強制八段式 PRD 結構、約定統一落盤路徑與最小上下文模板它保證了每個 Epic 都有內容完整、邊界清晰、可直接驅動技術架構的 PRD 產出。配合 breakdown-epic-arch、breakdown-feature-prd、breakdown-plan 與 breakdown-test團隊即可在 GitHub Copilot 的支持下跑通從業務想法到架構、功能、計劃與測試的完整規劃流水線。【免費下載鏈接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.項目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考