PageAI-Pro/ralph-loop

解決的問題

Ralph Loop 是設計用來自動化長時間執行的軟體開發任務。透過反覆處理結構化的任務清單，直到專案完成，防止 AI 代理失去焦點或提前中止，有效讓 AI 可以連續數天進行程式碼撰寫。

作法說明

Ralph 以循環方式運作，於隔離的 Docker Sandboxes 內管理代理 AI CLI（例如 Claude Code、Cursor 或 Gemini）。每次迭代中，系統遵循特定的工作流程：

1. 任務選擇：從查閱表中識別優先級最高的未完成任務。
2. 執行：代理執行該任務的詳細步驟。
3. 驗證：代理執行測試、Linting、型別檢查，以驗證工作成果。
4. 完成：驗證通過後，代理截取螢幕截圖，更新任務狀態，並提交變更。

使用者可透過編輯 STEERING.md 檔案，注入關鍵優先事項，要求代理在繼續標準任務清單前必須處理這些事項。

適用對象

希望自動化完整產品需求文件（PRD）實作，並使用代理 AI 自主處理重複的編碼、測試與提交變更循環的軟體開發者。

主要特色

• PRD 到任務自動化：內建 prd-creator 技能，可將非結構化需求轉換為正式 PRD 與詳細任務清單。
• 沙箱執行：使用 Docker Sandboxes 提供安全、隔離的環境，並為不同代理提供可預測的命名。
• 可觀測性：提供即時串流預覽、迭代耗時，以及代理執行每一步的歷史日誌。
• 可擴展技能：提供可重用的「技能」庫（專門知識與工作流程），適用於 React、PostgreSQL、Playwright 等各類框架。
• 人機協同：使用語意承諾標籤（例如 <promise>BLOCKED</promise>）在需要人工介入或決策時發出信號。