Ralph Wiggum Loop

ralph-wiggum-loop

多模型迭代开发 Agent 插件 — Ralph Loop 采用跨模型工作者／审查者架构，提供规范驱动开发技能、Stop 钩子以及 SHIP/REVISE 决策引擎。

概述

Ralph Loop 实现了一种两阶段迭代工作流：工作者模型负责执行任务，审查者模型负责跨模型审查，并不断迭代，直到审查者说出 “SHIP”。

本项目是一个跨平台 Agent 插件（plugin.json、mcp.json、.agents/skills/ralph-wiggum-loop/ 和 skills/ralph-wiggum-loop/），包含原生实现：

• Linux / macOS（Bash）： bin/ralph-wiggum-loop.sh（使用 bin/mcp-sdk.sh）
• Windows（PowerShell）： bin/ralph-wiggum-loop.ps1（使用 bin/mcp-sdk.psm1）
• 多语言运行器： bin/script-runner.sh / bin/script-runner.ps1（可在 POSIX sh/bash 和 PowerShell 中运行）

安装技能（.agents/skills/）

根据 Agent Skills 规范，将技能安装到 .agents/skills/：

# Project-level (.agents/skills/ralph-wiggum-loop) or User-level (~/.agents/skills/ralph-wiggum-loop)
mkdir -p .agents/skills
cp -R skills/ralph-wiggum-loop .agents/skills/ralph-wiggum-loop

New-Item -ItemType Directory -Path .agents/skills -Force | Out-Null
Copy-Item -Recurse -Force skills/ralph-wiggum-loop .agents/skills/ralph-wiggum-loop

特定操作系统的 MCP 服务（mcp.json）

MCP 服务名称	操作系统／运行时	传输方式	命令／端点
ralph-wiggum-loop	Linux / macOS（Bash）	stdio	./bin/script-runner.sh ralph-wiggum-loop --stdio
ralph-wiggum-loop-pwsh	Windows（PowerShell 7+）	stdio	pwsh -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio
ralph-wiggum-loop-powershell	Windows（PowerShell 5.1）	stdio	powershell.exe -NoProfile -ExecutionPolicy Bypass -File ${PLUGIN_ROOT}/bin/script-runner.ps1 ralph-wiggum-loop --stdio
ralph-wiggum-loop-http	跨平台	streamable-http	http://127.0.0.1:8080/mcp

快速开始

1. CLI 模式

• Linux / macOS（Bash）：

  ./bin/ralph-wiggum-loop.sh "Implement user authentication with JWT tokens" --profile pro
  

• Windows（PowerShell）：

  pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\ralph-wiggum-loop.ps1 "Implement user authentication with JWT tokens" --profile pro
  

2. MCP 服务（stdio 模式）

• Linux / macOS（Bash）：

  ./bin/ralph-wiggum-loop.sh --stdio
  

• Windows（PowerShell）：

  pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\ralph-wiggum-loop.ps1 --stdio
  

3. MCP 服务（streamable-http 服务模式）

• Linux / macOS（Bash）：

  ./bin/script-runner.sh start-http-server start --host 127.0.0.1 --port 8080
  

• Windows（PowerShell）：

  pwsh -NoProfile -ExecutionPolicy Bypass -File .\bin\script-runner.ps1 start-http-server start --host 127.0.0.1 --port 8080
  

文档

• 技能与 Agent 说明 — 操作系统选择规则、循环执行模式和 Streamable HTTP 设置
• 完整文档 — API 参考、工具和状态管理
• 部署指南 — 安装与配置

仓库

• 源代码： https://github.com/sheldonrobinson/ralph-wiggum-loop
• Agent 插件规范： https://agent-plugins.org
• MCP 规范： https://modelcontextprotocol.io

许可证

MIT