SuperAPI AI 工具集

ralph

智能体与模型

查看项目

更新于 10-16 07:07

技能介绍

Ralph PRD Converter 用于把已有的 PRD 转换为 Ralph 自主智能体系统可执行的 prd.json 格式,并配置相应的项目结构。

用途 该技能面向使用 Ralph 循环系统做自主开发的流程。它的职责是将人类可读的 PRD 转成结构化 JSON,使 Ralph 能够按用户故事逐条执行。

主要能力

  1. 读取 PRD:从 tasks/prd-*.md(或指定路径)读取 PRD 内容。
  2. 解析需求:解析其中的用户故事与需求条款。
  3. 格式转换:转换为 prd.json 规定的 JSON 结构。
  4. 结构初始化:若项目缺少 Ralph 目录结构则创建,包括创建 ralph/ 目录与空的 ralph/progress.txt 进度文件。
  5. 输出落盘:将结果保存到 ralph/prd.json。

输出格式 输出的 prd.json 包含以下字段:project(项目名称)、branchName(分支名,如 ralph/[feature-name])、description(来自 PRD 概述的功能描述)、userStories(用户故事数组)。每个用户故事包含:id(如 US-001)、title、description(As a [user], I want [feature] so that [benefit] 格式)、acceptanceCriteria(数组)、priority、passes(初始 false)、notes(初始空字符串)。

关键规则 故事大小:每个故事必须能在一次迭代(一个上下文窗口)内完成,过大的故事需拆分。 故事排序:按依赖关系设置优先级,依次为:模式/数据库变更(优先级 1)、服务端操作/后端逻辑(优先级 2)、工具函数/辅助函数(优先级 3)、UI 组件(优先级 4)、仪表盘/汇总视图(优先级 5)、测试与文档(优先级 6)。 验收标准:必须可验证而非含糊。例如“在 users 表添加 status 列,默认值为 'pending'”“API 成功时返回 200 与用户对象”“邮箱无效时表单显示校验错误”“Typecheck passes”属于合格标准;而“工作正常”“用户友好”“错误处理得当”属于不合格标准。每条故事末尾须包含“Typecheck passes”,UI 故事还须包含“验证更改在浏览器中正常工作”。 初始状态:所有故事以 passes: false、notes: "" 开始。 分支命名:由功能名生成,使用小写与连字符格式,例如“User Profile Settings”转为 ralph/user-profile-settings,“Payment Integration”转为 ralph/payment-integration。

使用方式 使用前需确保项目具备 Ralph 目录结构,若不存在则执行 mkdir -p ralph,并创建空的进度文件 touch ralph/progress.txt。随后由该技能读取 PRD、解析、转换并保存到 ralph/prd.json,同时确认文件已创建并提供路径。

适用场景 适用于使用 Ralph 自主智能体系统进行迭代开发的团队,将 PRD 快速结构化为可执行的任务清单,并按依赖顺序组织开发工作。

限制 资料未提供该技能的具体安装命令、依赖环境、支持的 PRD 模板范围以及与其他工具的集成方式,这些信息暂未提供。