Ralph 开发循环任务分解大项目如何被拆成 5 步可执行小任务【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-codeRalph for Claude Code 是一个围绕 Claude Code 构建的自主开发循环系统核心机制是开发循环加任务分解ralph-import把 PRD 拆成带优先级的任务清单ralph主循环反复执行读指令→干活→记进度→判完成直到退出条件满足。本文基于仓库真实文档和源码讲清这套机制看完你手里会有一条从文档到跑起来的完整路径。一、它把需求变成任务的全过程 导入这一步把一份文档变成一套可执行的任务结构。命令形态是ralph-import 文档 项目名支持 Markdown、TXT、JSON也支持从 GitHub Issue 直接导入ralph-import --github-issue 42。转换由 Claude Code 完成一次生成.ralph/PROMPT.md—— 项目目标和开发原则相当于给 AI 的总纲.ralph/fix_plan.md—— 按优先级排列的任务清单每个任务是一个可勾选的- [ ]条目像施工图纸旁边的待办看板.ralph/specs/requirements.md—— 从文档里提取出的技术规范.ralphrc—— 工具权限和速率限制配置四个文件之间是有层级的PROMPT.md 定方向specs/ 放细节fix_plan.md 落到具体任务。导入后先扫一眼生成的文件再启动比直接跑更稳。二、一轮开发循环的五个动作 每一轮循环就是五个固定动作循环本身由ralph_loop.sh驱动读取指令加载PROMPT.md确认本轮该做什么。执行 Claude Code带上当轮上下文和任务优先级跑 Claude Code让它去改代码。跟踪进度更新fix_plan.md里的勾选状态把执行结果写进.ralph/logs/。评估完成度检查退出条件、API 用量必要时触发熔断器。重复未完成就进入下一轮直到项目完成或撞上限制。每轮结束Claude 会按模板输出一个RALPH_STATUS状态块状态、改动文件数、测试情况、EXIT_SIGNALRalph 靠它判断局势。加--monitor参数还能用 tmux 看到循环计数和调用用量的实时仪表盘。三、退出判定两个条件是怎么配合的 退出不是看单条信号而是一道双条件门completion_indicators 2且EXIT_SIGNAL: true缺一不可。Loop 5Claude 输出阶段完成进入下一个功能 → 完成指示器 3自然语言模式匹配到的完成说法但EXIT_SIGNAL: false→继续循环尊重它还有活要干的表态Loop 8Claude 输出所有任务完成 → 完成指示器 4EXIT_SIGNAL: true→退出标记project_complete为什么要两个条件单靠措辞判断一句这部分完成了就可能让 Ralph 在还有任务时提前收工单靠EXIT_SIGNAL又可能漏掉 Claude 反复宣称完成却还在磨洋工的情况。前者是行为证据后者是明确表态两边对上才停。补充一点任务清单里标进Optional、Future、Nice to Have这类小节下的未勾选项不阻塞退出低优先级需求不会把循环锁死。四、三个关键文件各管一摊 文件职责关键内容PROMPT.md每轮循环读一次的高层指令项目目标、技术栈、质量约束、成功标准fix_plan.md循环实际执行的任务清单按优先级分组的勾选项Ralph 边干边打勾、也会补新任务specs/详细技术规范需求不够细时按功能拆文件specs/stdlib/放团队复用约定简单项目前两个文件就够用功能复杂了再往specs/里加文件任务项里写一句按 specs/xxx.md 实现即可。五、从 PRD 到跑起来完整上手路径 安装只做一次之后每个项目初始化即可。已有需求文档的项目走导入路径git clone https://gitcode.com/GitHub_Trending/ra/ralph-claude-code cd ralph-claude-code ./install.sh # 一次性安装 ralph、ralph-import 等全局命令ralph-import product-requirements.md my-app # PRD 转成 Ralph 项目 cd my-app ralph --monitor没有文档的项目用ralph-setup my-awesome-project从零建骨架再手工编辑.ralph/PROMPT.md和fix_plan.md现有项目用ralph-enable向导自动检测项目类型并生成.ralph/目录。跑起来之后看状态和日志ralph --status # 当前循环状态JSON tail -f .ralph/logs/ralph.log # 手动跟踪日志六、卡住了对照这张表排查 现象常见原因怎么办循环被暂停、出现倒计时触及每小时调用上限默认 100 次Ralph 自动等待并显示倒计时整点重置一般不用管提示 5 小时 API 上限Claude API 五小时额度用尽选等待 60 分钟或优雅退出无人值守模式会自动等待连续多轮没有进展fix_plan.md里任务含糊或互相冲突把任务写具体例如加 JWT 登录接口而不是做认证熔断器默认 3 轮无进展开断、冷却后可恢复还没做完就退了退出阈值偏松检查~/.ralph/ralph_loop.sh里的阈值变量并确认 Claude 是否过早给了EXIT_SIGNAL: true第一轮就静默退出Claude Code CLI 未安装或不在 PATH装好 CLInpx 用法时在.ralphrc里设CLAUDE_CODE_CMD报timeout: command not foundmacOS缺 GNU coreutilsbrew install coreutilsRalph 会自动识别gtimeout更多参数细节见 docs/CLI_OPTIONS.md文件职责的完整说明见 docs/user-guide/。到这里Ralph 的任务分解逻辑就讲完了需求进任务清单出循环按清单推进退出要过双条件这道门。对负责人来说价值在于大项目重新变得可预测、可管理——任意时刻你能回答还剩哪些任务和它是否真做完了所有状态都摆在项目的.ralph/目录里随时可查。【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Ralph 开发循环任务分解：大项目如何被拆成 5 步可执行小任务
Ralph 开发循环任务分解大项目如何被拆成 5 步可执行小任务【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-codeRalph for Claude Code 是一个围绕 Claude Code 构建的自主开发循环系统核心机制是开发循环加任务分解ralph-import把 PRD 拆成带优先级的任务清单ralph主循环反复执行读指令→干活→记进度→判完成直到退出条件满足。本文基于仓库真实文档和源码讲清这套机制看完你手里会有一条从文档到跑起来的完整路径。一、它把需求变成任务的全过程 导入这一步把一份文档变成一套可执行的任务结构。命令形态是ralph-import 文档 项目名支持 Markdown、TXT、JSON也支持从 GitHub Issue 直接导入ralph-import --github-issue 42。转换由 Claude Code 完成一次生成.ralph/PROMPT.md—— 项目目标和开发原则相当于给 AI 的总纲.ralph/fix_plan.md—— 按优先级排列的任务清单每个任务是一个可勾选的- [ ]条目像施工图纸旁边的待办看板.ralph/specs/requirements.md—— 从文档里提取出的技术规范.ralphrc—— 工具权限和速率限制配置四个文件之间是有层级的PROMPT.md 定方向specs/ 放细节fix_plan.md 落到具体任务。导入后先扫一眼生成的文件再启动比直接跑更稳。二、一轮开发循环的五个动作 每一轮循环就是五个固定动作循环本身由ralph_loop.sh驱动读取指令加载PROMPT.md确认本轮该做什么。执行 Claude Code带上当轮上下文和任务优先级跑 Claude Code让它去改代码。跟踪进度更新fix_plan.md里的勾选状态把执行结果写进.ralph/logs/。评估完成度检查退出条件、API 用量必要时触发熔断器。重复未完成就进入下一轮直到项目完成或撞上限制。每轮结束Claude 会按模板输出一个RALPH_STATUS状态块状态、改动文件数、测试情况、EXIT_SIGNALRalph 靠它判断局势。加--monitor参数还能用 tmux 看到循环计数和调用用量的实时仪表盘。三、退出判定两个条件是怎么配合的 退出不是看单条信号而是一道双条件门completion_indicators 2且EXIT_SIGNAL: true缺一不可。Loop 5Claude 输出阶段完成进入下一个功能 → 完成指示器 3自然语言模式匹配到的完成说法但EXIT_SIGNAL: false→继续循环尊重它还有活要干的表态Loop 8Claude 输出所有任务完成 → 完成指示器 4EXIT_SIGNAL: true→退出标记project_complete为什么要两个条件单靠措辞判断一句这部分完成了就可能让 Ralph 在还有任务时提前收工单靠EXIT_SIGNAL又可能漏掉 Claude 反复宣称完成却还在磨洋工的情况。前者是行为证据后者是明确表态两边对上才停。补充一点任务清单里标进Optional、Future、Nice to Have这类小节下的未勾选项不阻塞退出低优先级需求不会把循环锁死。四、三个关键文件各管一摊 文件职责关键内容PROMPT.md每轮循环读一次的高层指令项目目标、技术栈、质量约束、成功标准fix_plan.md循环实际执行的任务清单按优先级分组的勾选项Ralph 边干边打勾、也会补新任务specs/详细技术规范需求不够细时按功能拆文件specs/stdlib/放团队复用约定简单项目前两个文件就够用功能复杂了再往specs/里加文件任务项里写一句按 specs/xxx.md 实现即可。五、从 PRD 到跑起来完整上手路径 安装只做一次之后每个项目初始化即可。已有需求文档的项目走导入路径git clone https://gitcode.com/GitHub_Trending/ra/ralph-claude-code cd ralph-claude-code ./install.sh # 一次性安装 ralph、ralph-import 等全局命令ralph-import product-requirements.md my-app # PRD 转成 Ralph 项目 cd my-app ralph --monitor没有文档的项目用ralph-setup my-awesome-project从零建骨架再手工编辑.ralph/PROMPT.md和fix_plan.md现有项目用ralph-enable向导自动检测项目类型并生成.ralph/目录。跑起来之后看状态和日志ralph --status # 当前循环状态JSON tail -f .ralph/logs/ralph.log # 手动跟踪日志六、卡住了对照这张表排查 现象常见原因怎么办循环被暂停、出现倒计时触及每小时调用上限默认 100 次Ralph 自动等待并显示倒计时整点重置一般不用管提示 5 小时 API 上限Claude API 五小时额度用尽选等待 60 分钟或优雅退出无人值守模式会自动等待连续多轮没有进展fix_plan.md里任务含糊或互相冲突把任务写具体例如加 JWT 登录接口而不是做认证熔断器默认 3 轮无进展开断、冷却后可恢复还没做完就退了退出阈值偏松检查~/.ralph/ralph_loop.sh里的阈值变量并确认 Claude 是否过早给了EXIT_SIGNAL: true第一轮就静默退出Claude Code CLI 未安装或不在 PATH装好 CLInpx 用法时在.ralphrc里设CLAUDE_CODE_CMD报timeout: command not foundmacOS缺 GNU coreutilsbrew install coreutilsRalph 会自动识别gtimeout更多参数细节见 docs/CLI_OPTIONS.md文件职责的完整说明见 docs/user-guide/。到这里Ralph 的任务分解逻辑就讲完了需求进任务清单出循环按清单推进退出要过双条件这道门。对负责人来说价值在于大项目重新变得可预测、可管理——任意时刻你能回答还剩哪些任务和它是否真做完了所有状态都摆在项目的.ralph/目录里随时可查。【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考