用途:把已有 PRD(Markdown 文件或文本)转换成 prd.json,并为 Ralph 自主智能体系统创建隔离的 git worktree,以便在其中执行任务。
主要能力:解析 PRD 并生成符合 Ralph 格式的 JSON;按依赖顺序拆分为可在单次迭代内完成的小故事;生成可验证的验收标准;创建 worktree、安装依赖并初始化进度记录。
输出结构:prd.json 包含 project、branchName(形如 ralph/feature-name 的 kebab-case)、description 及 userStories 数组。每个故事含 id(US-001 递增)、title、description、acceptanceCriteria、priority、passes(false)、notes(空)。
关键规则:每个故事必须能在一个上下文窗口内完成,否则需继续拆分;故事按依赖排序(先数据库/迁移,再服务端逻辑,后使用后端的 UI,最后聚合视图);验收标准必须可检查,避免“工作正常”“体验好”等模糊表述;每个故事必须包含“Typecheck passes”,涉及可测试逻辑加“Tests pass (use vitest-testing skill)”,涉及 UI 加“Verify in browser using dev-browser skill”。
必要用法:生成后创建 worktree,命令为 git worktree add .claude/worktrees/ralph/<feature-name> -b ralph/<feature-name> main;随后执行 bun install 与 bun run env:pull;将 prd.json 存入 worktree 的 scripts/ralph/prd.json,并初始化 scripts/ralph/progress.txt。运行命令:scripts/ralph/ralph-tree.sh ralph/<feature-name>,可加选项 --tool claude 15。保存前需核对故事粒度、依赖顺序、验收标准与 worktree 是否就绪。
限制:资料未说明适用平台、收费方式、支持的具体模型或效果保证;仅给出转换与 worktree 设置流程。