SuperAPI AI 工具集

ralph-tui-create-json

编程与开发

查看项目

更新于 10-16 09:59

技能介绍

用途:把 PRD(markdown 文件或文本)转换为 ralph-tui 自主执行所需的 prd.json 任务文件,作为 ralph-tui JSON tracker 插件自带的技能,供 ralph-tui run 读取使用。

主要能力与流程:先从 PRD 的 Quality Gates 小节提取通用质量门禁与仅适用于 UI 故事的 UI 门禁;再解析用户故事,把质量门禁追加到每个故事的验收标准末尾;随后设定故事之间的 dependsOn 依赖,并输出可直接用于执行的 JSON。若 PRD 中没有 Quality Gates 小节,应询问用户需要哪些命令通过,或采用如 npm run typecheck 的默认值。

关键格式要求:输出必须是根级扁平 JSON 对象,name 与 userStories 位于根层,不能包裹在 prd 对象里,也不能用 tasks 数组代替 userStories;故事状态用 passes: false/true,不能使用 status;即使 PRD 描述了阶段、里程碑或迭代,也必须扁平化为单一 userStories 数组。每个故事需包含 id(如 US-001 顺序编号)、title、description、acceptanceCriteria、priority、passes、notes、dependsOn;branchName 由功能名派生为 kebab-case 并加 ralph/ 前缀。

故事粒度与依赖:每个故事必须能在一次 ralph-tui 迭代(约一个代理上下文窗口)内完成,因为每次迭代都会启动无记忆的新代理实例;过大的需求应拆分,例如按 schema、后端、UI、集成顺序排列,dependsOn 用于声明前置故事,未完成的前置会让后者显示 blocked 且不会被选中执行。

使用方式:默认输出到 ./tasks/prd.json,也可指定路径,之后运行 ralph-tui run --prd ./tasks/prd.json;执行时 ralph-tui 加载故事、选择优先级最高且 passes: false 且无阻塞依赖者、生成含故事详情与验收标准的提示、完成后标记 passes: true 并重复直至全部通过。

限制:技能本身只负责转换,不编造功能;验收标准应可验证,避免宽泛表述;需检查无循环依赖;PRD 缺少质量门禁时需要用户补充或采用默认值。