Ralph迭代开发循环

技能简介

Ralph Loops 是一种基于 Geoffrey Huntley 的 Ralph Wiggum 技术的自主 AI 代理循环框架，用于迭代式软件开发。该技能通过三阶段工作流（需求访谈→规划→构建）实现人机协作，让 AI 在保持对话响应的同时后台执行复杂任务。

能做什么

• 引导结构化需求访谈，输出规格文档
• 自动生成可执行的实现计划
• 按任务拆分迭代编码，每轮刷新上下文
• 后台异步运行，不阻塞主对话
• 提供实时监控面板查看进度

使用说明

前置安装：

1. 阅读并执行 SETUP.md 中的依赖安装步骤
2. 降级 Claude Code 至 2.1.25 版本（2.1.29 存在 CPU 占满 Bug）：
   npm install -g @anthropic-ai/claude-code@2.1.25
3. 验证版本：claude --version

启动方式：

根据用户指令选择对应阶段：

• “Interview me about system X” → 启动 Phase 1 需求访谈
• “Start planning system X” → 运行 ./loop.sh plan
• “Start building system X” → 运行 ./loop.sh build
• “Ralph loop over X” → 主动询问具体阶段

通用循环命令：

node skills/ralph-loops/scripts/ralph-loop.mjs \
  --prompt "/tmp/ralph-prompt-<task>.md" \
  --model opus \
  --max 10 \
  --done "RALPH_DONE"

监控方式：

• 后台运行后告知用户定期检查
• 使用 process poll <sessionId> 查询状态
• 访问 http://localhost:3939 打开实时面板

输入与输出

见下方输入与输出表格。

风险提示

• Claude Code 2.1.29 版本会导致子代理孤儿进程 CPU 占满，必须降级至 2.1.25
• 禁止同步轮询监控，会阻塞对话 6 分钟以上
• 各阶段有依赖关系：规划需先完成规格，构建需先完成计划
• 每次迭代消耗约 176K tokens，需控制单轮上下文体积

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/qlifebot-coder/ralph-loops/SKILL.md
来源类型：GitHub 仓库