SuperAPI AI 工具集

ralph-convert-prd

智能体与模型

查看项目

更新于 10-15 20:11

技能介绍

用途:把 PRD 或功能需求转换为 Ralph 自主智能体系统可执行的 tasks/prd.json,将需求拆解为原子用户故事,便于 Ralph 逐次迭代执行。

主要能力:读取 PRD 与可选的 SPEC.md;将需求拆分为每个可在一个 Ralph 迭代(一个上下文窗口)内完成的故事;为每个故事指定 storyType(backend、frontend、database、api、infra、test);生成含真实运行时检查的 verificationCommands;设置 blockedBy 依赖并按依赖排序(schema → backend → UI → dashboard);输出符合规定字段的 prd.json。

使用方式:先读取用户 PRD 或功能需求,若有 SPEC.md 则读取以获取验证环境信息;拆解为原子故事并分类;为每个故事编写验收标准与验证命令;设置依赖与优先级;最后输出 tasks/prd.json。输出字段包括 project、branchName、description、testCommands、userStories 等;每个故事含 id、title、description、storyType、acceptanceCriteria、verificationCommands、status、priority、attempts、maxAttempts、notes、blockedBy、docsToUpdate、completedAt、lastAttemptLog。

验证命令支持 expect 匹配器:exit_code:0、exit_code:N、contains:STRING、not_empty、matches:REGEX。所有故事须包含“Typecheck passes”,UI 故事须包含 Playwright 端到端验证。

适用场景:为 Ralph 准备可执行 PRD、拆分大型功能、定义依赖顺序与运行时验证。

限制:每个故事必须能在一个上下文窗口内完成,过大的需求(如整个仪表盘、认证系统、API 重构)需拆分;不得引用尚不存在的对象;验收标准须具体可验证,避免“工作正常”“良好体验”等模糊表述;保存前需通过预保存检查清单。具体收费、平台与效果资料暂未提供。