PageAI-Pro/ralph-loop

解决的问题

Ralph Loop 旨在自动化长期运行的软件开发任务。通过迭代式地处理结构化任务列表，直到项目完成，防止 AI 代理失去焦点或提前停止，从而有效实现 AI 连续数天编写代码。

工作原理

Ralph 作为一个循环运行，管理在隔离的 Docker Sandboxes 内的代理 AI CLI（如 Claude Code、Cursor 或 Gemini）。在每次迭代中，系统遵循特定的工作流程：

1. 任务选择：从查找表中识别优先级最高的未完成任务。
2. 执行：代理执行该任务的详细步骤。
3. 验证：代理运行测试、代码检查和类型检查以验证工作成果。
4. 完成：验证通过后，代理截取屏幕截图，更新任务状态，并提交更改。

用户可以通过编辑 STEERING.md 文件，注入关键优先级，要求代理在继续标准任务列表前必须处理这些事项。

适用人群

希望自动化实现完整产品需求文档（PRD）的软件开发者，利用代理 AI 自主完成编码、测试和提交更改的重复循环。

主要亮点

• PRD 到任务自动化：包含 prd-creator 技能，可将非结构化需求转换为正式 PRD 和详细任务列表。
• 沙箱化执行：使用 Docker Sandboxes 提供安全、隔离的环境，并为不同代理提供确定性命名。
• 可观测性：提供实时流式预览、迭代耗时以及代理执行每一步的历史日志。
• 可扩展技能：提供可重用的“技能”库（专门知识和工作流），适用于 React、PostgreSQL、Playwright 等各种框架。
• 人机协同：使用语义承诺标签（如 <promise>BLOCKED</promise>）在需要人工干预或决策时发出信号。