Awesome Ralph

关于Ralph（即Ralph Wiggum）的精选资源列表，这是一种AI编码技术，通过自动化循环运行AI编码代理，直到满足规范要求。

Ralph是由Geoffrey Huntley提出的一种用于自主AI编码的技术。其核心概念非常简洁：

while :; do cat PROMPT.md | claude-code ; done

关键原则：

• 不断重复运行AI代理，直到PRD或规格说明完成
• 进展保存在文件和Git历史中，而非上下文中
• 每次迭代都从干净的上下文开始
• 使用“反压”（如测试、代码检查、类型检查）来验证工作成果
• 哲学理念：“坐在循环之外，而不是其中”——或者正如Huntley所说：“在一个不确定的世界里，以确定的方式犯错”

觉得有用吗？⭐️ 给这个仓库点个赞，帮助更多人发现它

目录

• 官方资源
• 操作手册与方法论
• 实现方案
  • Claude Code插件
  • 独立实现
  • 特定工具的实现
  • 多智能体系统
• 教程与指南
• 文章与博客
• 视频与播客
  • 视频
  • 播客
• 社区
  • Hacker News讨论
  • 工具与目录
  • Ralph社区
• 相关工具
• 支持
• 贡献

官方资源

来自Ralph技术创造者Geoffrey Huntley的主要资料。

• Ralph Wiggum作为“软件工程师” - 最权威的入门介绍。解释了Bash循环、“像调吉他一样调优”的比喻，以及自主编码的经济学原理。
• 一切都是Ralph循环 - 更深层次的哲学探讨，涵盖“逆向模式”的洁净室处理、编排模式以及“编织机”概念。
• 别浪费你的反压 - 关于反压的技术深度解析——如何在不产生过多阻力的情况下拒绝无效生成。
• 我让Claude连续运行了三个月 - 案例研究：Ralph构建了CURSED，一种基于Z世代俚语的编程语言，并配有LLVM编译器。
• 模型上下文协议服务器太多了 - 上下文分配理论——Ralph尽量减少分配，以避免压缩事件的发生。

操作手册与方法论

全面的实施指南，涵盖“3个阶段、2个提示、1个循环”的工作流程。

• 如何使用Ralph Wiggum - Geoffrey Huntley的官方操作手册，内容包括上下文管理、沙箱环境以及提示模板。
• ralph-playbook - 详尽的方法论指南，配有图表、各阶段说明以及“标志与门控”引导技巧。

核心工作流程

第1阶段：定义需求 — 人类与LLM对话生成符合JTBD的规格说明
第2阶段：规划模式 — 差距分析生成优先级待办事项清单（不涉及具体实现）
第3阶段：构建模式 — 根据计划进行实现，运行测试，提交代码，循环往复

必要的文件结构

project-root/
├── loop.sh                    # Ralph循环脚本
├── PROMPT_build.md            # 构建模式指令
├── PROMPT_plan.md             # 规划模式指令
├── AGENTS.md                  # 操作指南（不超过60行）
├── IMPLEMENTATION_PLAN.md     # 优先级任务列表（由系统生成）
├── specs/                     # 需求规格（每个JTBD对应一份）
└── src/                       # 应用程序源代码

实现方案

Claude Code插件

• ralph-claude-code - Claude Code结合智能退出检测、速率限制、熔断机制和语义响应分析器。
• choo-choo-ralph - 基于珠子的工作流，包含5个阶段，结构化的规格说明、经过验证的实现以及知识的累积——按项目安装，可完全自定义工作流。

独立实现

• ralph-starter - CLI工具，集成GitHub、Linear和Notion；支持多代理、交互式向导、预设工作流及成本跟踪。
• snartank/ralph - 基于PRD的任务管理工具，具备自动分支、流程图可视化和自动归档功能。
• iannuttall/ralph - 极简的基于文件的代理循环，支持Codex/Claude/Droid/OpenCode等模型。
• smart-ralph - 基于规格驱动的开发工作流。将功能请求转化为结构化的规格说明（调研、需求、设计、任务），然后逐项自主执行。
• ralph-wiggum-bdd - 一个独立的Bash脚本，用于行为驱动开发，结合Ralph Wiggum循环。
• ralph-orchestrator - Rust编排工具，内置7个AI后端、专长角色的Hat System，以及交互式TUI模式。
• nitodeco/ralph - CLI编排工具，用于基于PRD的开发，支持顺序执行任务和交互式终端界面。
• pentoai/ml-ralph - 自主ML代理，可用于运行Claude或Codex实验。
• oh-my-ralph - 采用Python实现的意见型Ralph Wiggum循环。

工具特定实现

• ralph-wiggum-cursor - 具有令牌跟踪、8万令牌上下文轮转以及交互式设置的光标实现。
• opencode-ralph-wiggum - OpenCode 实现，具备实时状态显示、循环中段上下文注入和挣扎检测功能。
• ralph (GitHub Copilot) - VS Code 扩展，包含可视化控制面板、进度时间轴和全新聊天模式。
• ralph-tui - 终端 UI 协调器，可连接到任务跟踪工具，并支持交互式 PRD 创建。
• Goose Ralph Loop 教程 - Block 的 Goose 实现，结合跨模型评审和基于配方的工作流。

多智能体系统

• ralph-loop-agent - Vercel 的 TypeScript SDK 封装，提供验证回调和上下文摘要功能。
• multi-agent-ralph-loop - 用于需要并行工作流的复杂项目的多智能体编排。

教程与指南

• Ralph 入门 - Matt Pocock 提供的逐步快速入门指南，结合 Claude Code 和 Docker。
• 使用 Ralph Wiggum 进行 AI 编码的 11 条技巧 - 包括离线编码、HITL Ralph、迭代上限和进度跟踪等内容。
• Ralph Wiggum 方法 - 涵盖停止钩子机制、故障排除及问答环节。
• 真正的 Ralph Wiggum 循环 - 阐明了原始 Bash 循环与 Anthropic 插件理念之间的区别。
• Ralph Wiggum 指南 - 社区撰写的综合指南。
• Awesome Claude - Ralph Wiggum - 资源页面，提供更多技巧和配置示例。
• 如何在 7 分钟内构建一个高效的长期运行智能体循环 - 从创建规格说明、构建和完善 PRD，再到使用 Claude Code、Codex 和 OpenCode 等框架运行智能体，全程指导。

文章与博客

• [Ralph Wiggum 如何从《辛普森一家》成为 AI 界最大牌] (https://venturebeat.com/technology/how-ralph-wiggum-went-from-the-simpsons-to-the-biggest-name-in-ai-right-now) - VentureBeat 对这一文化现象的报道。
• Ralph 简史 - 包含 Y Combinator 黑客松故事的完整时间线。
• Ralph Wiggum 与 AI 编码循环 - 从春田镇到现实世界的软件自动化。
• Ralph Wiggum 解析：持续运行的 Claude Code 循环 - 技术性解释其运作原理及原因。
• 2026 年：Ralph 循环智能体之年 - 关于 Ralph 循环对开发影响的预测与分析。

视频与播客

视频

• Geoffrey Huntley 深入解读 Ralph Wiggum - 经典视频。现场编码演示、历史回顾，以及 Bash 循环与停止钩子实现的对比。
• AI That Works 播客节目 - 75 分钟深度探讨 Ralph 为何有效——上下文窗口、控制循环及其应用。
• Matt Pocock 的 Ralph 概览 - 基于看板和需求发现的实用概述。

播客

• 发明 Ralph Wiggum 循环 - Dev Interrupted - Geoffrey Huntley 讲述上下文衰减、压缩以及每小时 10.42 美元的计算。
• 发明 Ralph Wiggum 循环（文字稿） - Dev Interrupted 节目的完整文字稿。
• Ralph Wiggum 编码智能体高级工具 - BoundaryML - 深入探讨工具链和高级技术。
• Ralph Wiggum AI 智能体解析 - Startup Ideas 播客 - 面向创始人和开发者的易懂介绍。

社区

Hacker News 讨论

• 我们把一个编码智能体放进了一个 while 循环里 - Geoffrey Huntley 参与讨论；默认密码的安全问题被提出。
• Ralph Wiggum 作为软件工程师 - 关于代码质量和可维护性的批评与辩论。
• 最初的 HN 讨论 - 推动该技术普及的讨论。
• 技巧讨论 - 社区分享技巧和经验的主题帖。
• 从第一性原理出发的 Ralph（视频） - 围绕教育视频内容的讨论。
• Ralph Wiggum 之后会怎样？ - 探讨自主编码模式的未来。

工具与目录

• Vibe Coding - Ralph Wiggum 循环 - 工具目录条目，附带快速入门资源。

Ralph 社区

• r/ralphcoding - 一个关于 Ralph 编码的 subreddit。与社区分享你的学习心得、资源和成就。
• Ralph Discord - Discord 社区，讨论 Ralph 方法、资源和成就。

相关工具

• 面向编码智能体的高级上下文工程 - 用于优化自主智能体上下文窗口和提示的技术。

支持

如果这份列表帮助你发现了有用的 Ralph 资源，请为它点个赞！这有助于其他人找到这个合集。

贡献

欢迎贡献！请先阅读 贡献指南。

加入 Discord 和 Reddit 社区。

Awesome Ralph 快速上手指南

Ralph（又名 Ralph Wiggum）是一种自主 AI 编码技术，其核心理念是将 AI 代理置于自动化循环中运行，直到满足规格说明。它强调“坐在循环外，而非循环内”，通过文件系统和 Git 历史持久化进度，每次迭代都使用干净的上下文重新启动。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统: Linux, macOS 或 Windows (WSL2 推荐)。
• 核心依赖:
  • bash 或 zsh shell 环境。
  • Git: 用于版本控制和进度持久化。
  • Node.js (可选但推荐): 如果你计划使用 claude-code CLI 或其他基于 JS 的实现。
• AI 代理工具:
  • 必须拥有 Claude Code (claude-code) 的访问权限及有效的 API Key。
  • 或者配置好其他支持的代理工具（如 Codex, OpenCode 等）。
• 项目规范: 准备好你的需求文档 (PRD.md 或 specs/ 目录)，Ralph 需要明确的输入才能工作。

注意: Ralph 本身不是一个单一的安装包，而是一种方法论。你可以选择手动编写脚本，或使用社区实现的工具。

安装步骤

你可以选择“原生极简模式”或“社区增强模式”。

方案 A：原生极简模式（推荐初学者理解原理）

无需安装额外软件，只需创建一个脚本文件。

1. 在项目根目录下创建名为 loop.sh 的文件。
2. 写入以下核心逻辑代码：

#!/bin/bash
# loop.sh - The core Ralph Loop

while :; do
  echo "🔄 Starting Ralph iteration..."
  # 将提示词文件传递给 AI 代理
  # 请根据实际使用的代理命令调整下方指令
  cat PROMPT.md | claude-code 
  
  # 可选：在此处添加“背压”检查（测试、Lint、类型检查）
  # 如果检查失败，循环将继续；如果成功，可手动中断或添加退出逻辑
  echo "✅ Iteration complete. Review changes and commit if necessary."
done

3. 赋予执行权限：

chmod +x loop.sh

方案 B：使用社区实现（功能更丰富）

如果你需要自动退出检测、速率限制或多代理编排，可以使用成熟的开源实现。以 ralph-starter 为例：

# 克隆项目
git clone https://github.com/rubenmarcus/ralph-starter.git
cd ralph-starter

# 安装依赖 (需预先安装 Node.js)
npm install

# 按照向导进行初始化配置
npm run init

基本使用

以下是基于原生极简模式的最简工作流程，遵循 "3 阶段、2 提示词、1 循环” 的方法论。

1. 定义需求 (Phase 1)

在项目根目录创建 specs/ 文件夹，并编写具体的需求文档。同时创建主提示词文件 PROMPT.md。

文件结构示例：

project-root/
├── loop.sh
├── PROMPT.md            # 主指令入口
├── specs/
│   └── feature-login.md # 具体需求
└── src/                 # 代码输出目录

PROMPT.md 内容示例：

# Role
You are an autonomous coding agent using the Ralph technique.

# Context
Review the specifications in ./specs/ directory.
Check existing code in ./src/.

# Instructions
1. Analyze the gap between current implementation and specs.
2. Implement the necessary changes to fulfill the requirements.
3. Run tests if available.
4. Stop when the task is logically complete or blocked.

# Constraints
- Do not hallucinate files.
- Keep changes minimal and focused.
- If you encounter errors, fix them in the next iteration.

2. 规划模式 (Phase 2 - 可选但推荐)

在正式编码前，可以先让 AI 生成一个任务列表。修改 PROMPT.md 要求 AI 仅输出 IMPLEMENTATION_PLAN.md 而不写代码，或者直接运行一次循环生成计划。

3. 构建模式 (Phase 3)

启动循环，让 AI 开始工作。

# 在终端运行
./loop.sh

运行过程说明：

1. AI 读取 PROMPT.md 和当前代码状态。
2. AI 生成代码修改、运行测试（如果在提示词中配置了测试命令）。
3. 循环结束，回到起点。
4. 人工介入: 检查 Git 变更 (git diff)。如果满意，提交代码 (git add . && git commit -m "Ralph iteration"); 如果不满意，调整 PROMPT.md 或修复测试用例（背压），然后继续运行循环。

关键原则：背压 (Backpressure)

Ralph 的核心在于利用测试、Linter 或类型检查作为“背压”来验证工作。不要让 AI 在无限制的上下文中无限运行。

进阶用法示例（带简单背压）：

#!/bin/bash
while :; do
  cat PROMPT.md | claude-code
  
  # 背压检查：如果测试失败，循环继续；如果成功，打印消息但不自动退出（由人决定）
  npm test 
  if [ $? -ne 0 ]; then
    echo "❌ Tests failed. Feeding errors back to context for next iteration..."
    # 错误日志会自动成为下一次对话的上下文（如果是交互式 shell）
    # 或者你可以将错误日志追加到 PROMPT.md 中
  else
    echo "✅ All tests passed!"
  fi
  
  sleep 2
done

通过这种方式，Ralph 能够在一个不确定的世界中，以“确定性的糟糕”（即不断试错）方式逐步逼近完美的代码实现。