企业官网建设流程全解析

ralph-claude-code 任务拆解实战：4步跑通自主开发循环

【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-code

你敲下一条 ralph 命令就可以离开。回来时，它已把需求拆成的任务逐条做完，还把进度写进了任务清单。这就是 ralph-claude-code 的自主开发循环：把一份大需求文档变成能持续转下去的开工单，两道锁同时打开才停手。

从一条命令到跑完整循环

整个流程按时间推进，只有四站。

第一步，安装脚本 把ralph、ralph-import、ralph-monitor等命令注册进你的 PATH。第二步，ralph-import读取需求文档，产出三个落盘文件。第三步，ralph --monitor启动循环，每一轮做四件事：读PROMPT.md里的指令、带着当前进度跑 Claude Code、勾选任务清单、核对退出条件。第四步，退出条件满足后写日志收工。一轮通常几分钟。卡在哪一站，看下一节。

两道锁：什么时候算"真正做完"

循环每轮结束后会核两个量。

第一道锁是完成指示器：解析 Claude 回复里的自然语言模式，命中"任务完成""全部就绪"这类措辞就加分。阈值是 2 分，单轮说一次"完成"不会触发退出。第二道锁是EXIT_SIGNAL：Claude 必须在结构化输出里明确给出EXIT_SIGNAL: true，才算它自己确认收工。

两锁同时打开才退出。举例：Loop 5 里 Claude 说"阶段完成，进入下一个功能"，指示器记 3 分，但 EXIT_SIGNAL 是 false，循环继续——它尊重 Claude"还没干完"的表态。到 Loop 8，Claude 输出"所有任务完成，项目就绪"，指示器 4 分、EXIT_SIGNAL 为 true，循环退出并标记project_complete。这套设计堵住了一个常见坑：模型嘴上空喊完成，代码却没写完。

任务清单如何驱动循环

任务排阵靠.ralph/fix_plan.md里的优先级分层。Priority 1 放核心路径，比如入口文件和依赖初始化；Priority 2 放主要功能；Priority 3 放打磨项，如帮助文案和边界处理。Claude 每轮先清 Priority 1 里未勾掉的项，再往下游走。

进度评估是三维的：数清单里- [ ]与- [x]的条数得出完成率；看源码文件相对上一轮有没有 diff；跑测试确认通过情况。三项合起来刷新任务看板，也喂给上面的退出判定。全部勾完本身就是独立退出条件，不依赖模型表态。

落盘的三个文件

• PROMPT.md（现位于.ralph/PROMPT.md）：开发指令本体。写清项目目标、范围边界、成功标准。Claude 每轮的上下文都从这里来。旧式项目里也叫@fix_plan.md、@AGENT.md，二者等效。
• .ralph/fix_plan.md：任务看板。勾选框即状态，优先级分组即排期。它是循环的"记忆"，重置会话也不会丢进度。
• .ralph/specs/：技术规范目录。requirements.md存从需求文档提取的规格说明，stdlib/放标准库相关约定。改需求先改这里，别让 Claude 猜。

从 import 到 monitor：最小路径

装：

git clone https://gitcode.com/GitHub_Trending/ra/ralph-claude-code cd ralph-claude-code && ./install.sh

导：把需求文档转成 Ralph 项目，三个文件一次生成。

ralph-import product-requirements.md my-app

跑：

cd my-app && ralph --monitor

看：随时ralph --status拿 JSON 状态，或tail -f .ralph/logs/ralph.log盯实时日志。ralph-monitor则给出带速率限制倒计时的监控面板。

跑偏了怎么办

• 症状：循环暂停，提示等待。原因：触及每小时 API 调用上限，-c参数控制默认值。处理：等倒计时结束自动恢复，或提前用ralph --status盯用量。

• 症状：同一任务连续几轮反复失败。原因：任务描述含糊，或@fix_plan.md里条目互相冲突。处理：暂停循环，把大条目拆成单输入单输出的小项。熔断器连续触发后，--reset-circuit可重置状态。

• 症状：项目没做完循环却提前退出。原因：完成指示器阈值过低，或清单里大量条目被一次性勾掉。处理：回到PROMPT.md收紧成功标准，把验收写具体，别让"差不多"通过双锁。

细节参见快速上手指南。

收尾

大需求不再压垮人：拆成清单，锁住退出，剩下的交给循环。

【免费下载链接】ralph-claude-codeAutonomous AI development loop for Claude Code with intelligent exit detection项目地址: https://gitcode.com/GitHub_Trending/ra/ralph-claude-code