s
snwfdhmp/awesome-ralph
A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.
ai-codingclaudeclaude-coderalphralph-loopralph-wiggumvibe-coding
创建于 2026/1/19更新于 今天
README
由 Gemini 翻译整理
Awesome Ralph 
Ralph (又名 Ralph Wiggum) 是一项 AI 编程技术，其核心是将 AI 编程代理（Agent）置于自动化循环中运行，直至达成既定需求。本列表收录了关于该技术的精选资源。
Ralph 是由 Geoffrey Huntley 创建的一种自主 AI 编程技术。其核心理念优雅且简洁：
while :; do cat PROMPT.md | claude-code ; done
关键原则：
- 让 AI 代理重复运行，直至 PRD（产品需求文档）或规范完成
- 进展持久化在文件和 git 历史中，而非上下文（context）中
- 每次迭代都从干净的上下文重新开始
- 利用“背压”（Backpressure，如测试、lint、类型检查）来验证工作成果
- 哲学理念：“置身于循环之上，而非循环之中” —— 正如 Huntley 所言：“在一个非确定性的世界里保持确定性的糟糕（deterministically bad）”
觉得有用吗？⭐️ 给这个仓库点个赞，帮助更多人发现它。
目录
官方资源
来自 Ralph 技术创建者 Geoffrey Huntley 的一手资料。
- Ralph Wiggum 作为“软件工程师” - 权威入门介绍。解释了 bash 循环、“像调音一样调优”的隐喻，以及自主编程的经济学。
- 一切皆为 Ralph 循环 - 对“反向模式”洁净室开发、编排器模式和“织布机（The Weaving Loom）”概念的深入哲学探讨。
- 别浪费你的背压 - 关于背压的技术深度解析——即如何在不造成过度阻力的情况下拒绝无效生成的艺术。
- 我让 Claude 循环运行了三个月 - 案例研究：Ralph 构建了 CURSED，一种基于 Gen Z 俚语、带 LLVM 编译器的编程语言。
- 太多的模型上下文协议（MCP）服务器 - 上下文分配理论——Ralph 通过最小化分配来避免压缩事件。
实战手册与方法论
涵盖 3 个阶段、2 个提示词、1 个循环 工作流的综合实现指南。
- 如何使用 Ralph Wiggum - Geoffrey Huntley 的官方手册，涵盖了上下文管理、沙盒化和提示词模式。
- ralph-playbook - 包含图表、阶段说明和“标志与门（signs & gates）”引导技术的综合方法论指南。
核心工作流
第一阶段：定义需求 — 人类与 LLM 对话，生成与 JTBD（待办任务）一致的规范 第二阶段：规划模式 — 差距分析生成优先级 TODO 列表（不进行具体实现） 第三阶段：构建模式 — 根据计划实施、运行测试、提交代码，循环往复
必备文件结构
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 - 基于 Beads 的 5 阶段工作流，具有结构化规范、验证实现和知识积累功能——每个项目安装，工作流可完全自定义。
独立实现
- ralph-starter - 集成 GitHub、Linear 和 Notion 的 CLI 工具；支持多代理、交互式向导、工作流预设和成本跟踪。
- snarktank/ralph - PRD 驱动的任务管理，支持自动分支、流程图可视化和自动归档。
- iannuttall/ralph - 最小化实现。