ralph-tui-create-beads

此技能作为高层产品需求文档 (PRD) 与 ralph-tui 执行任务格式之间的智能桥梁。通过将基于 Markdown 的功能规格转换为结构化的任务 beads，它能启用一个维护逻辑执行顺序与验证标准的自主代理循环。此工具专为使用 ralph-tui 的开发者与技术项目经理所设计，确保 AI 代理在开发过程中遵循严谨且以测试为导向的方法。

该工具通过解析 PRD 中的质量门控 (Quality Gates) 区块来处理输入文件，识别强制性的测试与验证步骤。它会自动生成一个父级 epic bead 与一系列代表个别用户故事的子任务。通过强制执行依赖逻辑，确保任务执行顺序正确——通常从数据库结构迁移、后端逻辑到前端 UI 组件——这使得代理程序能够以增量方式构建系统，而不会丢失内容。由于 ralph-tui 在隔离的迭代中运行，此技能对于将大型功能集分解为可管理、可验证且符合代理程序上下文窗口的单元至关重要。

• 从 PRD Markdown 文件中自动提取通用与 UI 特定的质量门控要求。

• 使用 HEREDOC 语法生成 Shell 安全的 bd create 指令，以保留复杂的任务描述。

• 使用 bd dep add 处理依赖链建立，强制执行执行顺序（先结构，再后端，最后 UI）。

• 通过合并特定用户故事需求与全局质量门控命令来定义验收标准。

• 支持细粒度的任务拆解，以防止长时间运行代理工作流时出现上下文耗尽。

• 直接集成 beads-rust 追踪器插件与原生 beads 存储格式。

• 请确保 PRD 包含明确的质量门控区块；若省略，技能将提示您输入默认值（如 npm run typecheck）。

• 遵循“一个故事、一次迭代”原则，确保 AI 代理能在内存限制内完成任务。

• 将生成的 beads.jsonl 文件作为 ralph-tui run 命令的主要任务来源。

• 输出使用单引号 HEREDOC 定界符（cat <<'EOF'），以防止 Shell 字符干扰任务描述。

• 非常适合处理如数据库结构更新、API 实现与 UI 组件集成等复杂功能。