mcpField
R
ralph-json-start-loop

ralph-json-start-loop

github.com/richtaborAgent 工作流7357 次安装29 周前更新
代码仓库

关于 ralph-json-start-loop

ralph-json-start-loop 是一个 Claude skill，可按迭代执行 JSON PRD 中的功能任务。它依据依赖关系安排项目，并在独立 Git worktree 中开展工作。

主要功能

  1. 01选择依赖已满足的项目
  2. 02运行可配置的迭代循环
  3. 03实现标记为未完成的故事
  4. 04运行质量检查并提交更改
  5. 05更新 PRD JSON 并同步更改

适用场景

  1. 01自动执行计划中的功能故事
  2. 02按依赖关系安排项目顺序
  3. 03在独立 worktree 中并行开展功能工作

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/richtabor/agent-skills --skill ralph-json-start-loop

安装后在 Claude Code 中输入/ralph-json-start-loop确认已加载。

附带文件ralph.shreferences/prompt.md

详细介绍

Ralph

运行自主循环，执行 prds/ 目录中的功能。

用法

/ralph              # Run next available project (respects dependencies)
/ralph 25           # Run with 25 iterations
/ralph auth-flow    # Run specific project

流程

以后台模式运行循环脚本：

~/.claude/skills/ralph/ralph.sh [iterations] [project-name]

使用 run_in_background: true 以避免超时。启动后，告知用户使用 tail -f <worktree>/.ralph-progress.txt 查看进度。

功能
  1. 显示依赖关系图，并查找下一个可用项目
  2. 在 ../{repo}-{feature}/ 创建 Git worktree
  3. 在每次迭代中：
    • 选取第一个 passes: false 的故事
    • 实现该故事并运行质量检查
    • 提交：feat: [id] - [title]
    • 更新 JSON，并同步回主仓库
  4. 所有故事通过后，输出 <promise>COMPLETE</promise>
依赖项

Ralph 会读取每个 PRD 中的 dependsOn 并强制按顺序执行：

{
  "projectName": "Dashboard",
  "dependsOn": ["auth-flow", "user-profile"]
}

依赖项尚未完成的项目会被阻止。Ralph 会按字母顺序选择第一个已就绪的项目。

前提条件

  1. .claude/plans/、plans/ 或 prds/ 中至少有一个 .json PRD 文件
  2. 使用计划模式创建计划，然后运行 /ralph-json-create-issues 将其转换为 issue

说明

  • 在相互独立的项目上并行运行多个 Ralph（使用不同的终端）
  • 每个 Ralph 都在自己的 worktree 中运行，不会发生冲突

评论

支持 Markdown