--- title: 'Ralph Loop(任务清单驱动循环)' concept: Ralph Loop aliases: [Ralph Loop, 任务清单驱动循环, 任务清单自主推进循环, Ralph, ralph loop] type: 概念页 sources: - 01-学习笔记/ai/greg-isenberg/2026-01-19-Claude Code 完全解读.md - 01-学习笔记/ai/sabrina-ramonov/2026-02-19-Claude Code 零基础上手教程.md - 01-学习笔记/ai/all-about-ai/2026-03-23-用自动研究循环红队自测vibecoded网站.md - 01-学习笔记/ai/all-about-ai/2026-04-08-Claude Code 无头循环搭被动收入自动化.md - 01-学习笔记/ai/cole-medin/2026-05-28-Harness工程拆解从选工具到编排多会话.md - 01-学习笔记/ai/chase-ai/2026-06-24-四步循环工程任何事物（+提示工程为何未死）.md - 01-学习笔记/ai/chase-ai/2026-07-02-Fable5五个高杠杆用例.md - 01-学习笔记/ai/sabrina-ramonov/2026-07-03-11分钟掌握AI循环工程.md topics: [Claude Code 工作流, Agent 工程, Claude Code 定制扩展, MCP 与工具调用, AI 自动化, AI 编程与建站, AI 变现, 多 Agent 协作, 模型与能力] promoted: 2026-07-07 --- > **术语判别**:Ralph Loop 是 Jeffrey Huntley 提出的概念名(原始 GitHub 项目以 "Ralph Wiggum" 命名),中文圈没有完整对等词,**保留英文为主**,中文"任务清单驱动循环"作为解释别名。 ## 定义 把 **PRD / 任务清单交给 agent 逐项自主推进、每步验证(测试 + lint)通过才前进、直到清单跑完**的自动化循环——本质是 [[forward-goal]] 自主推进模式的一种具体实现。机制朴素但稳:每完成一项就写进度记录(如 `progress.txt`),继续下一项,清单跑完即停。原始作者 Jeffrey Huntley。 它与 while-true 常驻轮询(All About AI 无头循环)"形似而神异":Ralph Loop 是**任务清单驱动、完成即停的一次性自动化**,while-true 是**定时无限重复触发同一 skill 的常驻自动化**——终止条件与目的相反。Chase 的"循环工程"把它扩展到带状态记忆的长期场景(心跳 + maker/checker),承袭了 Ralph Loop 的迭代-验证-推进骨架。 ## 各信源立场对照 | 信源 | 立场/侧重 | 锚点 | 采信 | |---|---|---|---| | Greg·Claude Code 完全解读 | **首见**:机制朴素——给 PRD/任务清单,逐项完成、每项写进度记录、清单跑完才停。**机制稳,救不了烂 PRD**(天花板取决于 PRD 质量) | [17:40](https://youtu.be/zxMjOqM7DFs?t=1060) | 利益中性,声明未硬推立场与原创者一致 | | Sabrina·Claude Code 零基础 | 把 Ralph Loop / Agent Teams / Git Worktree 归到"入门之后的进阶玩法",Plan Mode 与权限弄懂再谈 | — | 利益中性,Plan Mode 前半段无利益绑定 | | All About AI·红队自测 vibecoded 网站 | 变体:在验证环节加 0-100 打分并按分数 keep / reset——是"读清单/历史 → 执行 → 验证 → 前进"的带评估爬山版 | — | 利益中性,引自家视频但评分循环属通用方法 | | All About AI·无头循环被动收入 | 必须放在 Claude Code 之外的终端跑(因为它本身在反复调起 Claude Code);与 Ralph Loop "形似而神异":Ralph Loop 完成即停,while-true 永续轮询 | [1:03](https://youtu.be/4kLUq4dgVaM?t=63) | 利益中性,收益自述未佐证但骨架属通用 | | Cole·Harness 工程拆解 | 编排多会话是 Ralph Loop 自动化:每个会话一个高度聚焦的任务(探索需求 → 写计划 → 计划传给实现 → 多个 code review agent 并行盯安全/正确性/简洁性 → 全过开 PR);补上出处(Jeffrey Huntley 是先驱)与退出机制(`done.txt` 作为 while 循环唯一退出条件) | [13:07](https://youtu.be/UFzo2v0kTU4?t=787) | 与利益同向,待印证,Archon 是自家开源推广 | | Chase·四步循环工程 | 循环工程直接承袭自 Ralph Loop:把任务逐项交给 agent 自主推进、每步验证通过才前进——可看作向长期、带状态记忆场景的推广 | [8:42](https://youtu.be/HlAdF8BLnB4?t=522) | 利益中性,推付费但循环骨架属通用共识 | | Chase·Fable5 五用例 | PRD 是长任务产出上限的前置因素,Ralph Loop 是 forward/goal 自主循环的具体实现(每个 feature 测试 + lint 过才前进) | — | 利益中性,推付费社区但长任务模式属共识 | | Sabrina·AI 循环工程 | 循环工程 Part1(心跳)+ Part5(maker/checker)结合的早期实践版本,直接承袭 Ralph Loop 的迭代-验证-推进骨架 | — | 利益中性,引直播流量未见直接推销 | ## 分歧与共识 - **共识**:Ralph Loop = "任务清单驱动、逐项推进、验证通过才前进、完成即停"的一次性自动化。机制朴素、稳;天花板取决于 PRD 质量。Cole / Chase / Sabrina 都把它看作"循环工程"系列的早期实践骨架。 - **分歧 / 侧重**: - **机制 vs PRD 的边界**:Greg 首见强调"机制稳,救不了烂 PRD"——Ralph Loop 是 PRD 的执行器,不是 PRD 的替代品。Cole 把执行侧细化到"多 code review agent 并行盯安全/正确性/简洁性"——验证环节可以叠加并行评审。 - **Ralph Loop vs while-true 常驻轮询**:All About AI 无头循环明确"形似而神异"——前者完成即停,后者永续轮询同一 skill。混用会导致循环死锁或资源浪费。 - **扩展路径不同**:Chase 循环工程把它扩展到带状态记忆的长期场景,Sabrina 把它拆成心跳 + maker/checker 复用,All About AI 红队自测在验证环节加 0-100 评分——三种扩展都是 Ralph Loop 的合法变体,但选哪条取决于场景需求。 ## 怎么用 - **先把 PRD 写到能验收**:Greg 首见明确"机制稳,救不了烂 PRD"。Ralph Loop 的天花板取决于 PRD 质量——验收标准模糊、任务拆分过粗、依赖未理清,循环跑得越久越偏。每个 feature 必须有可执行的"通过"定义(test + lint 通过即前进)。 - **退出机制要硬**:`done.txt` 作为 while 循环唯一退出条件(Cole·13:07)——不要靠"对话里 Claude 自称完成了"或 token 烧光作为退出。退出条件必须是文件状态、PR 创建、CI 通过这类**可机器验证**的硬信号。 - **Ralph Loop vs while-true 常驻轮询,别混**:任务清单驱动选 Ralph Loop(完成即停);定时无限重复触发同一 skill 选 while-true(All About AI·1:03)。混用会破坏终止条件,要么循环死锁、要么资源烧光。 - **验证环节可叠加并行评审**:Cole·13:07 给出"多 code review agent 并行盯安全/正确性/简洁性"——每个验证维度用一个独立 agent,全过才前进。这一动作把 Ralph Loop 的"测试 + lint"扩展到多视角评审。 ## 适用边界 - **PRD 是其天花板**:Greg 首见明文"机制稳,救不了烂 PRD"——Ralph Loop 是 PRD 的执行器、不是 PRD 的替代品,任务拆分过粗或验收标准模糊时循环跑得越久越偏。 - **退出条件不可机器验证则失控**:Cole·13:07 明示 `done.txt` / PR 创建 / CI 通过才是 while 循环唯一退出条件——靠"对话里 Claude 自称完成"或 token 烧光当退出,是 Ralph Loop 跑飞的常见失效路径。 - **永续轮询套 Ralph Loop = 循环死锁**:与 while-true 形似而神异(All About AI·1:03)——Ralph Loop 完成即停,定时无限重复触发同一 skill 应走另一条架构(常驻自动化),混用即破坏终止条件。 ## 关联 - [[forward-goal]] — 印证:Ralph Loop 是 forward/goal 自主推进模式带测试门禁(每项测试 + lint 通过才前进)的具体实现。 - PRD — 印证:PRD 是 Ralph Loop 的输入清单,Ralph Loop 把 PRD 拆出的每个 feature 逐一实现,二者是上下游关系。