tzachbon/smart-ralph

解決的問題

Smart Ralph 是一個為 AI 編碼代理（特別是 Claude Code 和 Codex）設計的規格驅動開發框架。它防止代理在沒有計畫的情況下直接進入編碼，而是強制執行研究、需求收集與技術設計的結構化流程，直到開始實作為止。這確保了複雜功能經過充分思考，並可在多個會話中恢復或審計。

工作原理

此專案實作了一個多代理工作流程，不同專業代理負責開發的不同階段：

1. 分診：將大目標拆分為更小的、具備依賴關係感知的規格（史詩）。
2. 研究：分析現有程式碼庫，並在網路中搜尋可行性。
3. 需求：定義使用者故事與接受標準。
4. 原型：（可選）在暫時環境中測試特定設計問題。
5. 設計：定義架構與技術權衡。
6. 任務：將設計分解為一系列可執行的任務。
7. 執行：逐一實作任務，為每個任務使用全新上下文，並應用品質門檻（POC、重構、測試與 linting）。

它還包含一個程式碼庫索引功能，可掃描專案以建立可搜尋的元件規格，幫助研究代理更有效率地找到現有程式碼。

適用對象

使用 Claude Code 或 OpenAI Codex 的開發者，希望採用更嚴謹、架構導向的 AI 輔助功能開發方式，而非單純的提示式程式碼生成。

主要亮點

• 規格驅動工作流程：強制執行研究 → 需求 → 設計 → 任務 → 實作的順序。
• 狀態持久化：將進度記錄於 .progress.md 與 tasks.md，支援會話中斷後恢復工作。
• 程式碼庫索引：自動掃描控制器、服務與模型，為 AI 建立可搜尋的索引。
• 多代理專業化：為不同階段使用不同角色（如 triage-analyst、product-manager、architect-reviewer）。
• 靈活執行：支援詳細「正常」模式（含審核檢查點）與快速「快速」模式，以實現更快迭代。