用途
ralph-tui-prd 是一个面向 ralph-tui 任务编排的 PRD(产品需求文档)生成技能。它的目标是为 AI 智能体执行准备详细、结构化的需求文档:用户提供功能描述后,该技能通过多轮澄清提问收集足够上下文,再生成一份可被 ralph-tui 解析并转换为 beads issues 或 JSON 任务的 PRD。
主要能力
- 接收用户的功能描述,并围绕问题/目标、核心功能、范围边界、成功标准、集成方式、质量门禁等维度提出澄清问题。
- 提问采用带字母选项的形式(如“1A, 2C”),便于用户快速作答;每次只问一组,并根据回答自适应地追问或转向新方面。
- 始终询问质量门禁(每个用户故事必须通过的命令),并针对 UI 故事询问是否包含浏览器验证。
- 在上下文足够时生成结构化 PRD,并用 [PRD]...[/PRD] 标记包裹,供 TUI 解析。
- 生成的 PRD 包含:概述、目标、质量门禁、用户故事、功能需求、非目标(范围外)、技术考量(可选)、成功指标、待解决问题。
- 用户故事格式为“US-001: 标题 + 描述(As a… I want… so that…)+ 验收标准清单”,每个故事设计为可在一次聚焦的 AI 智能体会话内完成。
- 质量门禁章节会被转换工具(ralph-tui-create-json、ralph-tui-create-beads)提取并附加到每个故事的验收标准中,因此单个故事内不重复写入质量门禁命令。
使用方式
- 用户提出功能需求(例如“为 TUI 添加深色模式”)。
- 技能提出第一组带字母选项的澄清问题。
- 用户以字母组合作答(如“1A, 2A”)。
- 技能根据回答继续追问或进入下一方面,通常需要 2-4 轮。
- 上下文足够后,技能输出包裹在 [PRD]...[/PRD] 中的完整 PRD。
- TUI 将 PRD 保存到 ./tasks/prd-[feature-name].md。
注意:该技能只负责创建 PRD,不开始实现。
适用场景
- 需要为 AI 编码智能体准备可执行、可验证的需求文档时。
- 使用 ralph-tui 进行任务编排,并希望将 PRD 转换为 beads issues 或 JSON 任务时。
- 功能需求需要拆分为多个小型、可独立完成的用户故事时。
限制
- 资料未提供该技能的安装命令、收费方式、支持平台等具体信息。
- 质量门禁命令为项目特定内容,需由用户提供,技能本身不预设具体命令。
- 用户故事不包含质量门禁命令,这些命令统一在质量门禁章节定义并在转换时自动应用。
- 验收标准要求可验证、不模糊(例如“按钮在删除前显示确认对话框”优于“工作正常”)。