Ralph Wiggum - 病毒式代理编码循环

Ralph Wiggum 是一个简化的真实团队代理编码循环工具，结合了 Ralph 循环和 SpecKit 工作流，让 AI 代理获得清晰的验收标准，无需繁重的工作流程。

核心理念: 通过明确规格和完全自主执行，让 AI 代理能够可靠地交付生产就绪的代码。

GitHub 仓库：fstandhartinger/ralph-wiggum

核心特性

特性	说明
GitHub 原生	与 GitHub 工作流无缝集成
开源	透明、可复刻、社区驱动
社区主导	开放演进，对所有构建者友好
MIT 许可	可自由使用、商业化和分享
规格驱动	专业化规格确保 AI 知道构建什么
完全自主	AI 自主工作直到所有标准通过
跨平台	Claude Code、OpenAI Codex、Cursor 等
即时设置	单个 URL 即可开始

"Vibe Coding" 精神

迭代自我修正
AI 不在第一次尝试时停止
测试、发现问题、修复、重复
直到一切真正工作

工作流程

简单的三步循环

1. 规格（Specify）

使用自然语言创建功能规格，AI 生成专业验收标准：

bash

/speckit.specify Add user authentication with OAuth

2. 实施（Implement）

AI 自主工作直到所有标准通过：

提交、推送、部署、测试、迭代

bash

/speckit.implement

3. 完成（Done）

当一切通过时，获得可投入生产的代码：

markdown

<promise>DONE</promise>

架构设计

规划者和执行者模式

与 Cursor 的多 Agent 系统类似，Ralph Wiggum 采用职责分离：

规划者（Planners）:

持续探索代码库并创建任务
可针对特定区域派生子规划者
规划过程可以并行且递归展开

执行者（Workers）:

领取任务并专注完成
不与其他执行者协调
完成后提交变更

快速开始

新项目提示

text

I want to start a new project with Ralph Wiggum.
Set it up using https://github.com/fstandhartinger/ralph-wiggum

现有项目提示

text

Set up Ralph Wiggum in this project using
https://github.com/fstandhartinger/ralph-wiggum

项目组件

核心

Ralph 循环: 真实的 Bash 循环，强制执行完成
SpecKit 集成: 更轻量的工作流程
完成信号: <promise>DONE</promise> 和 <promise>ALL_DONE</promise>
断路器: 检测停滞，防止无限循环

平台支持

平台	脚本	特性
Claude Code	`./scripts/ralph-loop.sh`	`--print` 模式输出捕获
Codex CLI	`./scripts/ralph-loop-codex.sh`	YOLO 模式
Cursor	`/speckit.implement`	交互模式

设计原则

站在巨人的肩膀

Ralph Wiggum 建立在以下工作基础上：

Geoffrey Huntley - 原始发明者
Anthropic - 官方 Claude Code 插件
Matt Pocock - Ralph 循环变体解释者
GitHub - SpecKit

改进的 SpecKit

结合 Ralph 循环与更轻量的 SpecKit 工作流
AI 代理获得清晰验收标准，无需繁重工作流
专业化规格驱动的开发输出
完全自主执行和迭代
适用于任何 AI 代理平台
单个 URL 即时设置

为什么选择 Ralph Wiggum

迭代自我修正：AI 不会在第一次尝试时停止，测试、发现问题、修复并重复
规格驱动开发：专业化规格确保 AI 准确知道要构建什么
适用于任何地方：Claude Code、OpenAI Codex、Cursor 等 - 一种方法，任何平台
即时设置：将 AI 指向仓库，就这样

适用场景

AI 辅助开发：让 Claude/Cursor 完全自主完成开发任务
规格驱动开发：基于 SpecKit 规格或 GitHub Issues 系统化
持续集成：自动化实现规格直到验收标准通过
重复性任务：自动化需要多次迭代的开发工作
快速原型：快速实现功能规格

字节笔记本