十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

awesome-copilot 之 breakdown-feature-prd 技能:基于 Epic 自动生成高质量 Feature PRD 的完整实战指南

awesome-copilot 之 breakdown-feature-prd 技能:基于 Epic 自动生成高质量 Feature PRD 的完整实战指南 awesome-copilot 之 breakdown-feature-prd 技能基于 Epic 自动生成高质量 Feature 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导读本文围绕 awesome-copilot 仓库中 breakdown-feature-prd 技能 展开讲解如何让 GitHub Copilot 扮演资深产品经理把 Epic 中的高层级功能想法拆解成一份可供工程团队直接落地、并可进一步生成技术规格说明的 Feature PRD。读完本文你将掌握该技能的触发方式、PRD 八大章节的标准结构、上下文输入模板以及它在前置 Epic 规划、后置实现计划与测试规划这一完整工作流中的位置还能结合仓库源码理解技能的元数据约定与校验机制。技能定位从 Epic 到 Feature 的产品需求翻译机在大型 SaaS 平台中Epic 描述的是一个横跨多个功能、需要多个迭代交付的大能力而单个 Feature 才是工程团队真正要落地的交付单元。breakdown-feature-prd技能的核心使命正是充当两者之间的翻译机输入Epic 中某一条高层级 feature 或 enabler 的粗略想法加上父级 Epic 文档输出一份结构化、无歧义的 Feature PRD保存为 Markdown 文档作为工程团队的唯一事实来源single source of truth并作为后续生成技术规格说明的输入。该技能在 SKILL.md 中明确要求 Agent 以大型 SaaS 平台资深产品经理的身份工作并在信息不足时主动提出澄清问题确保功能的所有方面在进入开发前被充分定义——这避免了常见的需求一句话、开发全靠猜问题。技能元数据与仓库校验机制每个技能都是一个自包含文件夹内含一份SKILL.md指令文件Agent 按需加载渐进式披露。breakdown-feature-prd的元数据定义如下--- name: breakdown-feature-prd description: Prompt for creating Product Requirements Documents (PRDs) for new features, based on an Epic. ---这份 frontmatter 并非摆设仓库的 validate-skills.mjs 会严格校验每个技能name必须是只含小写字母、数字和连字符的字符串且必须与技能文件夹名完全一致校验逻辑见 validate-skills.mjsdescription必须满足最小与最大长度约束见 validate-skills.mjs技能文件夹内必须存在SKILL.md且 frontmatter 必须能被解析捆绑资源assets单个文件不得超过 5MB见 validate-skills.mjs。也就是说description中Prompt for creating Product Requirements Documents (PRDs) for new features, based on an Epic这一句话既是给 Agent 的功能提示也是通过仓库校验的必需字段。输出位置约定技能规定输出为完整 Markdown 格式的 PRD保存到/docs/ways-of-work/plan/{epic-name}/{feature-name}/prd.md路径中的{epic-name}与{feature-name}为占位符分别替换为实际 Epic 名称与功能名称。这一约定与仓库中同系列的 breakdown 技能保持完全一致可对比 breakdown-epic-pm 输出的epic.md、breakdown-epic-arch 输出的arch.md、breakdown-feature-implementation 输出的implementation-plan.md保证了整个规划目录树在docs/ways-of-work/plan/下整齐可寻。PRD 八大章节结构详解技能规定了 Feature PRD 的标准结构共八个章节。每一节都有明确的填写要求下面逐一展开。1. Feature Name功能名称为功能起一个清晰、简洁、有描述性的名称。名称应能独立表达功能语义便于在后续 Issue、实现计划、测试计划中被引用。例如不要用优化体验这种含糊表述而要用支持从 URL 导入菜谱这类可检索的名称。2. Epic父级 Epic链接到父级 Epic 的 PRD 与架构文档。这是需求追溯traceability的关键Feature PRD 必须能够回溯到 Epic 层的业务目标与架构决策。在配套工作流中Epic 层文档由 breakdown-epic-pm产出 Epic PRD与 breakdown-epic-arch产出 Epic 架构规格生成Feature PRD 在此章节引用它们。3. Goal目标目标章节包含三个子项均给出了明确的篇幅要求Problem问题用 3-5 句话描述该功能要解决的用户问题或业务需求。要求聚焦、量化避免空泛Solution解决方案解释该功能如何解决上述问题说明核心机制而非实现细节Impact影响说明期望改善的业务结果或指标例如用户参与度user engagement、转化率conversion rate等为后续成功度量提供锚点。4. User Personas用户画像描述该功能的目标用户。画像是用户故事的主语来源定义得越具体后续用户故事与验收标准就越可验证。建议包含用户角色、使用场景、核心诉求、能力背景等信息。5. User Stories用户故事用户故事必须遵循标准句式As a user persona, I want to perform an action so that I can achieve a benefit.即作为某用户画像我想要执行某动作以便获得某收益。要求覆盖主路径与边界情况primary paths and edge cases确保 Happy Path 之外的异常场景也进入需求视野。6. Requirements需求需求拆分为两组Functional Requirements功能需求系统必须做什么的详细清单。技能特别强调具体且无歧义specific and unambiguous这是 PRD 作为工程唯一事实来源的底线Non-Functional Requirements非功能需求约束与质量属性清单包括性能、安全、可访问性、数据隐私等。非功能需求决定了系统做得多好常被遗漏却在后期返工成本极高。7. Acceptance Criteria验收标准为每条用户故事或主要需求提供一组验收标准。技能推荐两种清晰格式Checklist勾选清单可逐项勾选验证的测试性要求列表Given/When/Then给定/当/那么行为驱动开发BDD句式例如给定用户已登录当用户从 URL 导入菜谱时那么系统应成功解析并展示预览。验收标准将用于验证功能是否完整且正确因此必须是可测试的不能是系统应表现良好这类主观表述。8. Out of Scope范围外明确列出本功能不包含的内容防止范围蔓延scope creep。这一章节看似简单却是在多 Feature 并行时保持边界清晰、避免隐性承诺的有效工具。Context Template 上下文模板技能末尾给出了驱动 Agent 工作的上下文模板用户只需填充三项即可启动- **Epic:** [Link to the parent Epic documents] - **Feature Idea:** [A high-level description of the feature request from the user] - **Target Users:** [Optional: Any initial thoughts on who this is for]其中Target Users是可选项。若Feature Idea提供的信息不足以完成 PRD 各章节技能要求 Agent 先提出澄清问题而不是自行臆造需求。在完整工作流中的位置Epoch 式需求分解链breakdown-feature-prd不是孤立存在的它处于仓库中一套完整的需求分解链中间环节。从仓库中同系列的技能可以清晰看到这条链路环节技能输入输出文档1. Epic 产品定义breakdown-epic-pm高层级想法{epic-name}/epic.md2. Epic 技术架构breakdown-epic-archEpic PRD{epic-name}/arch.md3.Feature 产品定义breakdown-feature-prdEpic Feature 想法{epic-name}/{feature-name}/prd.md4. Feature 实现计划breakdown-feature-implementationFeature PRD{epic-name}/{feature-name}/implementation-plan.md5. 项目计划与 Issue 自动化breakdown-planPRD/实现计划等产物project-plan.md、issues-checklist.md6. 测试规划与质量保障breakdown-testPRD/实现计划/项目计划test-strategy.md、qa-plan.md等从代码结构看breakdown-plan 明确把 Feature PRD 列为输入之一并定义 Epic → Feature → Story/Enabler → Test 的工作项层级breakdown-test 也把 Feature PRD 列为测试规划的输入文档。因此可以推断Feature PRD 的质量直接决定了下游实现计划、Issue 拆解与测试策略的质量这正是该技能强调具体且无歧义的原因。使用方式与安装breakdown-feature-prd属于 Agent Skills自包含指令文件夹。参考 docs/README.skills.md 中的通用说明安装与使用方式如下安装技能需要 GitHub CLI v2.90.0gh skills install github/awesome-copilot breakdown-feature-prd或手动拷贝将 skills/breakdown-feature-prd 文件夹整体复制到本地 skills 目录触发使用在提示中引用该技能或让 Agent 自动发现它。之后按 Context Template 提供 Epic 链接、Feature 想法与目标用户信息Agent 即会以产品经理身份产出完整的 Feature PRD 并写入约定路径。实战要点小结信息不足先澄清技能明确要求 Agent 在信息不足时提问这是产出高质量 PRD 的前提验收标准可测试每条用户故事都要配套可勾选或 Given/When/Then 形式的验收标准作为开发完成度的判定依据范围边界要显式Out of Scope 与 Goal 同等重要显式排除才能防范围蔓延衔接上下游文档第 2 章节引用 Epic 文档产出文档又会被实现计划与测试规划引用形成完整追溯链遵守路径与命名约定输出固定到docs/ways-of-work/plan/{epic-name}/{feature-name}/prd.mdname字段与文件夹名一致才能通过仓库的 validate-skills.mjs 校验。【免费下载链接】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),仅供参考
返回列表