用途:编排完整的 Ralph 自主智能体流水线,从需求采集到执行。适用于构建新功能、平台或复杂任务。
主要能力:流程为 spec-interview(引导式需求发现)→ generate-prd(生成可执行 PRD)→ ralph-convert-prd(把 PRD 转成原子用户故事 prd.json)→ 通过 Task 工具派发 ralph-coder/ralph-tester 子智能体执行。编排者在决策点保持用户控制。
核心原则:所有代码实现必须由子智能体完成,编排者不写代码、不改文件;出错时清晰呈现给用户并等待指示,不自行修复或重试。每个智能体有独立上下文;编排者为任意智能体包裹 Ralph 上下文(故事规格、返回格式、约束)。故事需大小合适(如加数据库列、建 UI 组件),过大(如整个仪表盘、认证系统)会失败。验证要求运行时校验(API 用 curl、UI 用 Playwright、数据库跑迁移、基础设施做健康检查),静态检查仅为基线;每个故事后运行全部测试防回归,故事用 attempts/maxAttempts 限制重试。
使用方式:提供四种工作流——full-pipeline(从零开始)、from-prd(已有 PRD)、execute-only(已有 prd.json)、check-status(查看进度)。关键文件包括 SPEC.md、tasks/prd-*.md、tasks/prd.json、tasks/progress.txt、tasks/test-log.md、tasks/review-notes.md、tasks/common_knowledge.md 和 docs/。prd.json 含 project、branchName、description、testCommands 与 userStories(含 id、title、storyType、acceptanceCriteria、verificationCommands、status、priority、attempts、maxAttempts、blockedBy、docsToUpdate 等)。verificationCommands 支持 exit_code:0、exit_code:N、contains:STRING、not_empty、matches:REGEX 匹配器。执行按批次并行编码、并行测试、顺序合并到 main。
适用场景:需要结构化需求到实现的新功能或平台开发。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;需依赖 Claude Code 工具链与子智能体环境。