claude-ralph

claude-ralph 是一個自主程式設計代理迴圈，旨在將產品需求文件 (PRD) 轉換為完整實作的功能分支。透過將經過驗證的 Ralph 模式移植到 Claude Code CLI，此工具讓開發人員能將重複的實作任務交給 AI 進行迭代開發。該代理程式會處理基於 JSON 的 PRD，選取高優先順序的使用者故事，並為每個任務啟動乾淨、獨立的 Claude Code 實例來處理實作、測試與驗證。它透過 git、進度日誌和結構化任務檔案在迭代間維護上下文與狀態，確保開發流程保持井然有序、高品質且可靠。此系統包含內建的品質閘門（如 Linting、型別檢查與自動化測試），非常適合建構複雜功能。它也透過 Playwright 支援前端功能的使用者介面驗證。使用者可定義 Markdown 格式的需求，將其轉換為 JSON，並讓自動化迴圈處理從分支建立到程式碼庫更新的所有事務。此工具非常適合希望透過既有的 Claude Max 訂閱來加速發布速度、進行深度端到端自主編碼的個人開發者或團隊。

• 完全自動化迴圈執行：自動循環執行 prd.json 中的任務，直到所有故事完成為止。

• Claude Code CLI 整合：透過官方 Claude Code 介面使用您現有的 Claude Pro 或 Max 訂閱。

• 迭代實作：將大型功能拆解為小型、原子化的使用者故事，便於 AI 管理與驗證。

• 品質保證：在每次提交前強制執行包括型別檢查、Linting 和單元測試在內的品質閘門。

• UI 驗證支援：針對使用 Playwright 進行瀏覽器測試提供特定支援。

• 狀態持久化：使用 progress.txt 和 git 歷史記錄來追蹤跨工作階段的學習內容、模式與程式碼庫知識。

• 安裝：將儲存庫複製到您的 scripts/ 目錄，並依照全域或專案特定技能的使用說明進行設定。

• 使用方式：首先使用 PRD 技能產生需求，然後將其轉換為 prd.json 以供自動化執行器使用。

• 先決條件：需要安裝 Claude Code CLI、jq、git，以及選用的 Playwright 用於前端測試。

• 工作流程：遵循產生 PRD、精簡使用者故事並啟動自動化 ralph.sh 迴圈的迭代流程。

• 最佳實踐：確保故事的大小適合單次程式設計週期，並包含明確的二元驗收標準以獲得最佳效果。