SuperAPI AI 工具集

ralph

智能体与模型

查看项目

更新于 10-15 23:45

技能介绍

用途:将现有 PRD 转换为 Ralph 自主执行系统所需的 prd.json。转换结果始终保存到全局 Ralph 项目目录,不询问用户保存位置;项目目录通过 ralph project-dir 获取,保存路径为 $(ralph project-dir)/prd.json。

主要能力:输出包含 project、branchName、description、userStories 的 JSON;每个用户故事含 id、title、description、acceptanceCriteria、priority、passes、notes。自动从 git 历史检测工单前缀(如 CI、JIRA、PROJ),有约定时所有故事使用 PREFIX-0000,无约定时使用 US-001 递增;自动从分支名检测前缀(feature/、feat/、fix/ 等),无约定时使用 ralph/。

关键规则:每个故事必须能在一次 Ralph 迭代(一个上下文窗口)内完成,过大功能需拆分;故事按依赖排序(数据库/迁移→后端逻辑→UI→汇总视图),前面的故事不得依赖后面的;验收标准必须可验证,避免“工作正常”“良好体验”等模糊表述;每个故事都加入“Typecheck passes”,有可测逻辑时加“Tests pass”,涉及 UI 时加“Verify in browser using dev-browser skill”。复杂功能可在 .specs/ 目录创建规格文件,并在故事描述中引用。写入新 prd.json 前,若已有不同 branchName 的旧文件且 progress.txt 有内容,需先归档到 archive/YYYY-MM-DD-feature-name/ 并重置 progress.txt。

限制:资料未提供安装方式、收费、价格、平台支持及实际运行效果等信息。