用途:build-prd 用于创建产品需求文档(PRD),通过协作式讨论把功能请求转化为可直接实施的 GitHub issue。适用场景包括用户要求“创建 PRD”或“编写需求”、处理带有 feature-request 或 enhancement 标签的 issue、在实施前记录需求,以及把模糊想法整理为结构化规范。不适用于已有完整 PRD(标题含 [PRD] 前缀)的 issue、纯缺陷报告,或实施已开始的情况(应改为回溯编写规范)。
前置条件:需已认证 GitHub CLI(gh auth status),并处于有效仓库中(gh repo view),或提供 org/repo。
工作流:先理解请求,若是 GitHub issue 则用 gh issue view ISSUE_NUMBER --repo ORG/REPO 读取,并查看项目说明文件与 README,用一两句话概括核心请求;再对照必需章节(问题陈述、用户故事、成功指标、范围、技术约束为必需,原型图、依赖、时间线为可选)找出缺口,把所有问题一次性编号成 Q1-Qn 批量提出,等待回复;若是 GitHub issue 可加 question 标签。随后按模板起草 PRD,替换所有占位符,禁止保留方括号占位文本与技术细节编造,未知项列入 Open Questions。起草后必须获得用户明确批准(“看起来不错”或“是”可算,沉默不算)才能更新 issue,使用 gh issue edit 写入正文、标题加 [PRD] 前缀并添加 ready-to-work 标签,移除 question 标签,保留原始标签。最后用 gh issue comment 确认。
边界处理:范围不清时建议 MVP,仅保留核心价值必需项,其余移入 Out of Scope(future);范围过宽时建议拆分为多个 PRD;用户给实施细节而非需求时应引导回到要解决的问题;缺少成功指标时可按功能类型建议。关键规则是未经明确批准不得更新 issue,问题必须批量提出,不编造技术细节。
限制:目前资料未提供关于收费、平台可用性、效果指标或支持语言之外的更多事实,暂未提供。