用途:根据用户提供的功能或产品信息,生成结构化的产品需求文档(PRD),并可选发布到团队 Wiki。触发方式为用户表达“generate PRD”“write PRD”“product requirements”“spec doc”等,命令为 /generate-prd。
主要能力:
- 执行前读取 00-inbox/MY-INTEGRATIONS.md 判断可用的发布平台(Confluence、Notion、HackMD),读取 00-inbox/MY-PROFILE.md 获取活跃项目与作者信息,并通过 Bash 运行 date '+%Y-%m-%d %H:%M' 生成 created 时间戳。
- 需求收集:必填为功能名称、问题陈述、目标用户、高层方案;可选为成功指标、约束、依赖、相关文档、时间线,未提供时可生成合理默认值。
- 上下文收集:若 agent_mode 为 team,用并行后台代理(existing-prd-scanner、issue-context-gatherer)扫描现有 PRD 与相关议题;若为 solo,则顺序执行。Linear 或 GitHub 活跃时按配置检索相关 issue。
- 按内置模板生成含问题陈述、目标与指标、用户故事、方案、技术考量、设计 UX、发布策略、待决问题、参考与变更日志的 PRD。
- 审核门:展示草稿并等待用户选择查看、保存、修改或发布,绝不自动发布。
- 保存到 04-projects/[project]/PRDs/prd-[feature-slug]-YYYY-MM-DD.md,必要时用 mkdir -p 创建目录。
- 经用户明确批准后,可通过 Confluence REST API(POST /wiki/rest/api/content)、Notion 工具或 HackMD API 发布,并回写 published_url 与 published_at。
限制:发布必须获得明确批准;无发布平台时仅存本地;API 失败时先保存本地并提供可手动发布的内容;上下文过大时摘要处理;PRD 超过 Wiki 页面限制时建议拆分。需自行填写空间键、父页面等 CUSTOMIZE 占位符。