mcpField
R
ralph-loop

ralph-loop

github.com/mikeyobrienAgent 工作流3.2k154 次安装2 周前更新
代码仓库

关于 ralph-loop

ralph-loop 是通过命令行操作 Ralph 循环的技能，可用于启动或恢复运行、检查状态和诊断信息，并在合并或丢弃工作前审查 worktree 变更。

主要功能

  1. 01启动或继续 Ralph 运行
  2. 02检查循环状态、日志和历史
  3. 03恢复已暂停的循环
  4. 04合并前审查差异
  5. 05合并、重试或丢弃工作
  6. 06使用诊断信息排查问题

适用场景

  1. 01检查运行中循环的状态
  2. 02恢复因钩子暂停的运行
  3. 03审查已完成的 worktree 变更
  4. 04排查循环的异常行为

安装

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

$npx skills add https://github.com/mikeyobrien/ralph-orchestrator --skill ralph-loop

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
commands.md
diagnostics.md

详细介绍

Ralph Loop

使用此技能从外部操作 Ralph 循环。

使用此技能的场景

  • 使用正确的 -c 和 -H 输入启动或继续一次 Ralph 运行
  • 检查循环状态、工作树、日志、历史记录和差异
  • 恢复因钩子而暂停的循环
  • 合并或丢弃已完成的工作树循环
  • 根据当前诊断文件调试异常的循环行为

工作流

  1. 先运行 ralph loops list 或 ralph loops list --json，了解当前状态。
  2. 如果用户希望执行任务，使用正确的核心配置和 hats 来源运行 ralph run ...。
  3. 如果循环卡住或情况可疑，先检查 logs、history 和 diff，再更改状态。
  4. 如果循环已暂停，读取 .ralph/suspend-state.json，然后使用 ralph loops resume <id>。
  5. 如果循环已排队或处于 needs-review 状态，先检查差异，再酌情使用 merge、process、retry 或 discard。
  6. 需要有关 hats、事件、工具调用、解析错误或性能的详细证据时，使用诊断功能。

安全措施

  • 优先使用 CLI，而不是直接编辑 .ralph 状态文件。
  • 将任务和记忆视为规范的运行时系统；不要将 scratchpad 作为主要状态模型。
  • 合并前检查差异。
  • 只有确认底层进程已停止后，才能移除锁或队列文件。
  • 手动编辑 .ralph/ 是最后的恢复手段；使用时应明确说明。

按需阅读以下参考资料

  • 命令示例和操作流程：references/commands.md
  • 诊断文件和暂停状态详情：references/diagnostics.md

评论

支持 Markdown