Ralph TUI - Create Beads 是一个把 PRD 转换为 beads(epic + 子任务)以便 ralph-tui 自主执行的技能。
用途
接收 PRD(Markdown 文件或文本),在 .beads/beads.jsonl 中创建 beads:从 PRD 的 Quality Gates 部分提取质量门禁;为功能创建一个 epic bead;为每个用户故事创建子 bead(并附加质量门禁);设置 bead 之间的依赖关系(schema → 后端 → UI);输出可供 ralph-tui run --tracker beads 使用。
注意:此技能随 ralph-tui 的 Beads 跟踪器插件捆绑提供。未来的跟踪器插件(Linear、GitHub Issues 等)会捆绑各自的任务创建技能。
主要能力
- 提取质量门禁:查找 PRD 中的 Quality Gates 部分,区分适用于所有故事的通用门禁与仅适用于 UI 故事的 UI 门禁。若没有 Quality Gates 部分,则询问用户哪些命令应通过,或使用类似 npm run typecheck 的合理默认值。
- 创建 epic 与子 bead:使用 bd create 命令,epic 标签为 ralph,feature,任务标签为 ralph,task。
- 依赖管理:使用 bd dep add 指定先后顺序,ralph-tui 会把被阻塞的 bead 显示为 blocked,在依赖未完成前不会选中执行,并在提示中附带依赖上下文。
使用方式
每个故事必须能在一次 ralph-tui 迭代(约一个代理上下文窗口)内完成,因为 ralph-tui 每次迭代都会启动新的代理实例,不记得之前的工作。合适粒度的示例:添加数据库列与迁移、在现有页面添加 UI 组件、更新服务端操作逻辑、为列表添加筛选下拉框。过大的应拆分。故事按依赖顺序执行,较早的故事不能依赖较晚的:schema/数据库变更 → 服务端操作/后端逻辑 → 使用后端的 UI 组件 → 汇总视图。
创建 bead 使用 bd create,依赖使用 bd dep add <issue> <depends-on>(issue 依赖于 depends-on)。每个 bead 的描述需包含故事本身的验收标准与附加的质量门禁;UI 故事还需附加浏览器验证等 UI 门禁。验收标准应可验证,避免“工作正常”“良好的 UX”等模糊表述。
转换规则
先提取 Quality Gates;每个用户故事 → 一个 bead;第一个故事无依赖;后续故事依赖其前驱;优先级依据依赖顺序与文档顺序(0=critical,2=medium,4=backlog);epic 标签 ralph,feature,任务标签 ralph,task;所有故事状态为 open;验收标准为故事标准加质量门禁;UI 故事再附加浏览器验证门禁。
输出与执行
Beads 写入 .beads/beads.jsonl。创建后可运行:ralph-tui run --tracker beads --epic <id>(处理特定 epic)或 ralph-tui run --tracker beads(自动选择最佳任务)。ralph-tui 会在 epic 内工作、完成时关闭每个 bead、所有子任务完成后关闭 epic,并在 epic 完成时输出 <promise>COMPLETE</promise>。
创建前检查清单
已从 PRD 提取 Quality Gates(缺失则询问用户);每个故事可在一个迭代内完成;故事按依赖排序(schema → 后端 → UI);质量门禁已附加到每个 bead 的验收标准;UI 故事含浏览器验证(若 Quality Gates 指定);验收标准可验证;没有故事依赖后面的故事;创建 bead 后用 bd dep add 添加依赖。
限制
关于该技能的收费、价格、具体平台支持范围等资料暂未提供。