prp-ralph-loop

prp-ralph-loop 是一個自主執行代理技能，旨在彌合規劃與生產級代碼之間的差距。該技能基於「Ralph Wiggum」循環技術，通過運行迭代開發週期直到滿足所有定義的標準，從而促進持續的自我修正。它作為執行產品需求提示 (PRP) 的 AI 代理的協調者，確保代碼修改不僅僅是被實現，還能通過建構、代碼檢查 (linting) 和測試閘道進行嚴格驗證。

此技能通過檢測 .claude/prp-ralph.state.md 的存在來識別活動的工作會話，該狀態文件用於追蹤迭代、任務進度和代碼庫的歷史學習。通過維護這種狀態，代理確保了迭代間的連續性，使其能夠調試之前的失敗、遵循早期循環中發現的模式，並系統地核對需求。它是專為使用 Claude Code 來自動化複雜功能實現、錯誤修復和代碼庫重構的開發人員與工程團隊設計的。

• 執行迭代代碼實現週期，直到檢測到完成訊號。

• 強制執行嚴格的驗證要求，包括類型檢查、代碼檢查、測試套件和建構驗證。

• 通過 .claude/prp-ralph.state.md 文件保持持久狀態，實現上下文感知恢復和進度日誌記錄。

• 與本地 Shell 掛鉤 (hooks) 集成，以管理會話生命週期和持續提示。

• 通過在每次修復後強制重新驗證，支持系統化的錯誤處理。

• 需要一個已初始化的項目，其中包含 PRP 計畫文件或要執行的具體任務。

• 最適合具有明確、基於目標的驗證閘道的任務（例如，測試覆蓋率或編譯器成功）。

• 在初始執行時務必指定 --max-iterations 以防止無限循環情況。

• 確保 stop hook (.claude/hooks/prp-ralph-stop.sh) 已在 settings.local.json 中正確配置，以啟用自動循環控制。

• 當所有驗證（TypeScript、Python、測試、建構）均退出且代碼為 0，並且所有計畫要求均滿足時，循環才會觸發最終完成訊號 <promise>COMPLETE</promise>。