SuperAPI AI 工具集

ralph-json-create-issues

编程与开发

查看项目

更新于 10-16 02:08

技能介绍

用途

该技能用于把产品需求文档(PRD)或计划 Markdown 文件转换为 Ralph 可执行的 prd.json 格式,供 ralph-json-start-loop 自主运行。

主要能力

  • 按顺序在 .claude/plans/、plans/、prds/ 目录中查找输入文件;若多个位置存在文件则列出并询问转换哪一个,若仅一个则直接使用,若均无则询问用户路径。
  • 将需求拆分为合适粒度的用户故事,每个故事必须能在一次 Ralph 迭代(一个上下文窗口)内完成。
  • 按依赖顺序排列故事优先级:数据库/模式变更、后端逻辑、API 端点、UI 组件。
  • 检测跨 PRD 依赖:扫描已有 prds/*.json,识别 Markdown 中的显式、隐式或技术性依赖引用,并填充 dependsOn 数组。
  • 为每个故事生成明确、可验证的验收标准,要求包含“Typecheck passes”和“Lint passes”,UI 故事还需包含“Verify at localhost:3000/[path]”。
  • 输出 prds/[feature-name].json,包含 projectName、branchName、description、dependsOn、status、completedAt、userStories 等字段。

使用方式

  1. 准备 PRD 或计划 Markdown 文件,放入 .claude/plans/、plans/ 或 prds/ 目录。
  2. 调用该技能,技能会扫描已有 PRD、读取 Markdown、从文件名推导功能名、检测依赖、拆分故事、排序并添加验收标准。
  3. 保存前按检查清单核对:每个故事可单次迭代完成、按依赖排序、所有标准含 Typecheck/Lint、UI 故事含本地验证路径、无模糊标准、故事 ID 连续、dependsOn 已填充且引用现有 PRD 名。
  4. 转换完成后输出创建的文件路径、故事数量、依赖列表和分支名,并提示运行 /ralph-json-start-loop。

适用场景

适用于需要将 PRD 或计划文档自动转换为结构化 JSON 以驱动 Ralph 自主执行循环的开发工作流。

限制

资料未提供关于收费、价格、平台支持范围或具体效果保证的信息。