Ralph for Claude Code: 三步把一份 PRD 跑成自主开发循环【免费下载链接】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 是运行在 Bash 里的自主开发循环工具对需求文档做任务分解拆成带优先级的小任务再驱动 Claude Code 一轮轮实现最后靠双条件检测判断项目何时真正做完。它适合想说一次目标让 AI 自己推进到底的人。 十分钟从 clone 到第一轮循环Ralph 分两段用系统装一次项目初始化多次。装完ralph、ralph-import、ralph-monitor等命令进 PATH任意目录可用。git clone https://gitcode.com/GitHub_Trending/ra/ralph-claude-code cd ralph-claude-code ./install.sh ralph-import api-spec.json backend-service第四行把 JSON 接口规格转成名为 backend-service 的项目Markdown PRD 用法相同如ralph-import product-requirements.md my-app。想从零建空白项目用ralph-setup my-awesome-project。进入项目目录执行ralph --monitortmux 左窗格是循环输出右窗格是实时面板。落地建议先拿一个不重要的项目完整跑一遍熟悉面板与日志位置再回主力仓库。 导入后多出的文件各管什么ralph-import借 Claude Code 把原始需求翻译成四样东西.ralph/PROMPT.md开发指令。写项目目标与范围、技术栈、成功标准每轮开头都会读。.ralph/fix_plan.md任务清单。需求拆成高、中、低三档优先级Claude 完成一项勾一项也允许随时补新任务。.ralph/specs/requirements.md从文档抽出的技术规范更细的规格放 specs/复用型约定放 specs/stdlib/。.ralphrc项目配置管工具权限、限流、超时默认值一般不用动。四者关系是单向的PROMPT.md 定方向specs 补细节fix_plan.md 落任务干完再回头更新清单。落地建议启动前通读 fix_plan.md把颗粒度不对的任务先改到位。 双条件退出怎么防止提前下班退出循环必须同时满足两条完成指示器completion_indicators 2从 Claude 输出的自然语言里按经验模式统计出的置信度Claude 在 RALPH_STATUS 块里显式给出EXIT_SIGNAL: true。两个场景对比着看。某轮 Claude 说这个阶段做完了准备进入下一个功能指示器已到 3但 EXIT_SIGNAL 是 falseRalph 判断它还想继续循环照跑几轮后 Claude 输出所有任务完成项目可以交付指示器 4 且 EXIT_SIGNAL 为 true才退出并标记project_complete。辅助出口还有fix_plan.md 全部勾选、连续多次 done 信号、连续多轮只跑测试没有实现功能大概率已收敛、撞上 API 5 小时用量上限。一个细节值得注意Optional、Future、Nice to Have小节下的未勾选项不参与完成判定小节名可用.ralphrc的OPTIONAL_SECTIONS自定义锦上添花的任务不会把退出卡死。落地建议可延后的工作挪进 Optional 小节让核心路径任务独担全部完成的判定。一轮循环内部发生了什么五步读 PROMPT.md 拿指令 → 带当前上下文调 Claude Code → 更新任务清单并记录结果 → 评估退出条件 → 不满足就再来一轮。进度不看它说完了而看三个客观维度源文件是否真实变更、测试是否通过、项目能否构建运行。会话默认跨轮延续SESSION_CONTINUITYtrue24 小时过期自动重置想每轮全新对话加--no-continue。两道安全阀限流器默认每小时最多 100 次调用MAX_CALLS_PER_HOUR到点挂起并给出倒计时熔断器在连续 3 轮无文件变更、或连续 5 轮撞同一错误时打开电路冷却 30 分钟后半开试探恢复避免空转烧钱。落地建议首轮把MAX_CALLS_PER_HOUR压到 50 附近确认不跑偏再放开。 退出阈值和限流参数怎么调抱怨刚开工就停前先分清是哪种停限流等待每小时配额用完自动挂起带倒计时属正常行为。5 小时 API 上限三层检测超时保护 → 结构化 JSON → 文本兜底确认后让你二选一等 60 分钟重置或优雅退出无人值守时超时自动选等待。熔断打开ralph --circuit-status查状态修好问题后ralph --reset-circuit复位会话漂移用ralph --reset-session清掉。真·提前退出翻~/.ralph/ralph_loop.sh里的计数器——连续 3 轮纯测试、连续 2 次 done 信号、30% 以上循环在跑测试都会触发退出。排查从状态查起ralph --status ralph --circuit-status tail -f .ralph/logs/ralph.logralph --status输出 JSON 格式的循环数、调用数与限额。改.ralphrc之前先用ralph --dry-run空跑一遍完整脚手架验证配置不花 API 调用。落地建议怀疑提前停先ralph --dry-run --verbose复现再对着日志时间线下结论。任务拆到什么粒度循环才顺经验值每条任务 1–3 小时做完、输入输出说得清、能单独测试。fix_plan.md 高优先级放关键路径中优先级放重要但不急的功能低优先级放优化项。PROMPT.md 要求一轮只做一件最重的事做完、跑测试、更新清单再进下一轮。两个反例很典型让 API 能用——Claude 只能自己猜边界建一个 auth 文件夹——太小一整轮浪费在搬砖上。前者拆成可验证的接口清单后者合并成实现登录/登出接口并通过测试。落地建议给每条任务问三句——多久做完、怎么算完、怎么测答不上来的就重写。 监控面板与四件高频事故ralph-monitor或ralph --monitor的右窗格实时显示当前循环计数与状态、API 用量对比限额、最近日志条目、限流倒计时。挂后台跑用CtrlB后按D分离 tmux 会话之后tmux attach -t 会话名接回。四件高频事故的排查路径卡住空转fix_plan.md 里有含糊或互相冲突的任务回去写具体。停得太早对照退出阈值同时确认 EXIT_SIGNAL 有没有被过早设成 true。限流 / 5 小时上限等倒计时或换时段无人值守把配额调保守。权限被拒Claude Code 拒绝某条命令时 Ralph 会停步。编辑.ralphrc的ALLOWED_TOOLS补上所需工具如Bash(npm *)、Bash(git *)、Bash(pytest)再ralph --reset-session重启。落地建议把ralph --status和tail -f .ralph/logs/ralph.log练成肌肉记忆异常先对时间线再下结论。从一份 PRD 到ralph --monitorRalph 把大项目拆小任务这件最耗人力的事固化成了文件约定PROMPT.md 给方向、fix_plan.md 给任务、双条件退出给终点。剩下的工作是按上面的路径调参让循环替你推进项目。【免费下载链接】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 for Claude Code: 三步把一份 PRD 跑成自主开发循环
Ralph for Claude Code: 三步把一份 PRD 跑成自主开发循环【免费下载链接】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 是运行在 Bash 里的自主开发循环工具对需求文档做任务分解拆成带优先级的小任务再驱动 Claude Code 一轮轮实现最后靠双条件检测判断项目何时真正做完。它适合想说一次目标让 AI 自己推进到底的人。 十分钟从 clone 到第一轮循环Ralph 分两段用系统装一次项目初始化多次。装完ralph、ralph-import、ralph-monitor等命令进 PATH任意目录可用。git clone https://gitcode.com/GitHub_Trending/ra/ralph-claude-code cd ralph-claude-code ./install.sh ralph-import api-spec.json backend-service第四行把 JSON 接口规格转成名为 backend-service 的项目Markdown PRD 用法相同如ralph-import product-requirements.md my-app。想从零建空白项目用ralph-setup my-awesome-project。进入项目目录执行ralph --monitortmux 左窗格是循环输出右窗格是实时面板。落地建议先拿一个不重要的项目完整跑一遍熟悉面板与日志位置再回主力仓库。 导入后多出的文件各管什么ralph-import借 Claude Code 把原始需求翻译成四样东西.ralph/PROMPT.md开发指令。写项目目标与范围、技术栈、成功标准每轮开头都会读。.ralph/fix_plan.md任务清单。需求拆成高、中、低三档优先级Claude 完成一项勾一项也允许随时补新任务。.ralph/specs/requirements.md从文档抽出的技术规范更细的规格放 specs/复用型约定放 specs/stdlib/。.ralphrc项目配置管工具权限、限流、超时默认值一般不用动。四者关系是单向的PROMPT.md 定方向specs 补细节fix_plan.md 落任务干完再回头更新清单。落地建议启动前通读 fix_plan.md把颗粒度不对的任务先改到位。 双条件退出怎么防止提前下班退出循环必须同时满足两条完成指示器completion_indicators 2从 Claude 输出的自然语言里按经验模式统计出的置信度Claude 在 RALPH_STATUS 块里显式给出EXIT_SIGNAL: true。两个场景对比着看。某轮 Claude 说这个阶段做完了准备进入下一个功能指示器已到 3但 EXIT_SIGNAL 是 falseRalph 判断它还想继续循环照跑几轮后 Claude 输出所有任务完成项目可以交付指示器 4 且 EXIT_SIGNAL 为 true才退出并标记project_complete。辅助出口还有fix_plan.md 全部勾选、连续多次 done 信号、连续多轮只跑测试没有实现功能大概率已收敛、撞上 API 5 小时用量上限。一个细节值得注意Optional、Future、Nice to Have小节下的未勾选项不参与完成判定小节名可用.ralphrc的OPTIONAL_SECTIONS自定义锦上添花的任务不会把退出卡死。落地建议可延后的工作挪进 Optional 小节让核心路径任务独担全部完成的判定。一轮循环内部发生了什么五步读 PROMPT.md 拿指令 → 带当前上下文调 Claude Code → 更新任务清单并记录结果 → 评估退出条件 → 不满足就再来一轮。进度不看它说完了而看三个客观维度源文件是否真实变更、测试是否通过、项目能否构建运行。会话默认跨轮延续SESSION_CONTINUITYtrue24 小时过期自动重置想每轮全新对话加--no-continue。两道安全阀限流器默认每小时最多 100 次调用MAX_CALLS_PER_HOUR到点挂起并给出倒计时熔断器在连续 3 轮无文件变更、或连续 5 轮撞同一错误时打开电路冷却 30 分钟后半开试探恢复避免空转烧钱。落地建议首轮把MAX_CALLS_PER_HOUR压到 50 附近确认不跑偏再放开。 退出阈值和限流参数怎么调抱怨刚开工就停前先分清是哪种停限流等待每小时配额用完自动挂起带倒计时属正常行为。5 小时 API 上限三层检测超时保护 → 结构化 JSON → 文本兜底确认后让你二选一等 60 分钟重置或优雅退出无人值守时超时自动选等待。熔断打开ralph --circuit-status查状态修好问题后ralph --reset-circuit复位会话漂移用ralph --reset-session清掉。真·提前退出翻~/.ralph/ralph_loop.sh里的计数器——连续 3 轮纯测试、连续 2 次 done 信号、30% 以上循环在跑测试都会触发退出。排查从状态查起ralph --status ralph --circuit-status tail -f .ralph/logs/ralph.logralph --status输出 JSON 格式的循环数、调用数与限额。改.ralphrc之前先用ralph --dry-run空跑一遍完整脚手架验证配置不花 API 调用。落地建议怀疑提前停先ralph --dry-run --verbose复现再对着日志时间线下结论。任务拆到什么粒度循环才顺经验值每条任务 1–3 小时做完、输入输出说得清、能单独测试。fix_plan.md 高优先级放关键路径中优先级放重要但不急的功能低优先级放优化项。PROMPT.md 要求一轮只做一件最重的事做完、跑测试、更新清单再进下一轮。两个反例很典型让 API 能用——Claude 只能自己猜边界建一个 auth 文件夹——太小一整轮浪费在搬砖上。前者拆成可验证的接口清单后者合并成实现登录/登出接口并通过测试。落地建议给每条任务问三句——多久做完、怎么算完、怎么测答不上来的就重写。 监控面板与四件高频事故ralph-monitor或ralph --monitor的右窗格实时显示当前循环计数与状态、API 用量对比限额、最近日志条目、限流倒计时。挂后台跑用CtrlB后按D分离 tmux 会话之后tmux attach -t 会话名接回。四件高频事故的排查路径卡住空转fix_plan.md 里有含糊或互相冲突的任务回去写具体。停得太早对照退出阈值同时确认 EXIT_SIGNAL 有没有被过早设成 true。限流 / 5 小时上限等倒计时或换时段无人值守把配额调保守。权限被拒Claude Code 拒绝某条命令时 Ralph 会停步。编辑.ralphrc的ALLOWED_TOOLS补上所需工具如Bash(npm *)、Bash(git *)、Bash(pytest)再ralph --reset-session重启。落地建议把ralph --status和tail -f .ralph/logs/ralph.log练成肌肉记忆异常先对时间线再下结论。从一份 PRD 到ralph --monitorRalph 把大项目拆小任务这件最耗人力的事固化成了文件约定PROMPT.md 给方向、fix_plan.md 给任务、双条件退出给终点。剩下的工作是按上面的路径调参让循环替你推进项目。【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
