mcpField
R
ralph-loop

ralph-loop

github.com/zenobi-usAgent 工作流6854 次安装今天更新
代码仓库

关于 ralph-loop

Ralph Wiggum 支持带节奏控制的长期迭代开发循环，面向需要多轮处理和阶段性反思的复杂任务。它可按清单推进工作，并可将独立任务委派给子 Agent。

主要功能

  1. 01以迭代循环推进任务
  2. 02保存任务内容并更新进度
  3. 03按设定间隔进行反思
  4. 04将清单任务委派给子 Agent
  5. 05支持暂停、恢复、归档和清理

适用场景

  1. 01分阶段完成复杂开发任务
  2. 02按清单推进多个相互依赖的步骤
  3. 03将独立任务拆分给不同子 Agent

安装

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

$npx skills add https://github.com/zenobi-us/dotfiles --skill ralph-loop

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

详细介绍

Ralph Wiggum - 长时间运行的开发循环

带有节奏控制的长时间迭代开发循环。

适用场景

  • 需要多次迭代的复杂任务
  • 包含许多相互依赖的独立步骤的任务
  • 适合定期反思的工作

请勿用于简单的一次性任务或快速修复。

Agent 工具

调用 ralph_start 开始一个循环：

ralph_start({
  name: "loop-name",
  taskContent: "# Task\n\n## Goals\n- Goal 1\n\n## Checklist\n- [ ] Item 1\n- [ ] Item 2",
  maxIterations: 50,        // Default: 50
  itemsPerIteration: 3,     // Optional: suggest N items per turn
  reflectEvery: 10,         // Optional: reflect every N iterations
  useSubagents: true,       // Optional: delegate each task to subagent
  subagentAgent: "default"  // Optional: subagent name (default: 'default')
})

循环行为

  1. 任务内容保存到 .ralph/<name>.md
  2. 每次迭代：处理任务并更新文件
  3. 调用 ralph_done 工具进入下一次迭代
  4. 完成后：输出 <promise>COMPLETE</promise>
  5. 循环在任务完成或达到最大迭代次数时结束（默认值为 50）

用户命令

  • /ralph start <name|path> - 开始新循环
  • /ralph resume <name> - 恢复循环
  • /ralph stop - 暂停循环（Agent 空闲时）
  • /ralph-stop - 停止活动循环（仅限空闲时）
  • /ralph status - 显示循环
  • /ralph list --archived - 显示已归档的循环
  • /ralph archive <name> - 将循环移至归档
  • /ralph clean [--all] - 清理已完成的循环
  • /ralph cancel <name> - 删除循环
  • /ralph nuke [--yes] - 删除所有 .ralph 数据

流式输出期间：按 ESC 中断，发送普通消息以恢复，然后在空闲时运行 /ralph-stop 结束循环。

任务文件格式

# Task Title

Brief description.

## Goals
- Goal 1
- Goal 2

## Checklist
- [ ] Item 1
- [ ] Item 2
- [x] Completed item

## Notes
(Update with progress, decisions, blockers)

子 Agent 模式

将清单中的每项任务委派给单独的子 Agent 线程：

/ralph start my-tasks --use-subagents --subagent-agent default

工作原理：

  • 提取尚未完成的清单项（- [ ] Task）
  • 每项任务都委派给一个全新的子 Agent 线程（1 项任务 = 1 个子 Agent）
  • 子 Agent 完成任务并将其标记为已完成（- [x] Task）
  • 主循环负责协调并跟踪进度
  • 失败时自动重试（最多 2 次）

优点：

  • 每项任务都使用全新的上下文（不会相互干扰）
  • 执行相互隔离（失败不会连锁影响）
  • 任务跟踪和进度报告清晰
  • 适合独立、明确的任务

适用场景：

  • 任务彼此独立（没有共享状态）
  • 每项任务都足够重要，值得单独执行
  • 希望清晰地分隔各项任务
  • 任务列表预先定义明确

最佳实践

  1. 清晰的清单：将工作拆分为明确的事项
  2. 随做随更新：标记已完成的事项并添加备注
  3. 遇到阻碍时反思：借助反思重新评估方案（普通模式）
  4. 妥善完成：仅在确实完成时输出完成标记
  5. 子 Agent 模式：用于边界清晰的独立任务

评论

支持 Markdown