reticlehq/reticle

解決的問題

Reticle 為 AI 編碼代理提供一個驗證層，防止其發布看似正確但實際損壞的程式碼。它解決了「靜默失敗」問題——例如 500 錯誤、錯誤的狀態值或控制台錯誤——這些錯誤在 UI 上不可見，因此對依賴截圖或僅 DOM 工具的代理來說是不可見的。

工作原理

Reticle 在執行中的 Web 應用內部運行一個僅限開發使用的 SDK。它不從外部觀察應用，而是監控內部程式事件，包括網路呼叫、狀態儲存、訊號和 React fiber 樹。當代理執行操作時，Reticle 會將這些內部事件與一組謂詞（例如："POST 請求是否回傳 200？"）進行比對，並返回確定性的通過/失敗判斷，同時提供需要修復的程式碼中確切的 file:line。

適用對象

使用 AI 編碼代理（如 Claude Code、Cursor、Copilot 或任何 MCP 相容代理）建構基於 React、Vue、Svelte、Preact、Astro 或 Electron 和 Tauri 等框架的 Web 和桌面應用程式的開發者。

核心亮點

• 內部可見性：可存取對視覺模型和瀏覽器代理不可見的網路回應、應用狀態和控制台日誌。
• 確定性驗證：使用結構化事件而非 LLM 推測或截圖，消除不穩定性（flake）。
• 代理整合：作為 MCP 伺服器運作，並提供一個斜線命令（/reticle），可無縫整合到代理的工作流程中。
• 精準定位：提供失敗程式碼的精確 file:line，減少代理修復 bug 所需的工具呼叫次數。
• 回歸測試：只需錄製一次流程，即可在後續每次編輯中確定性地重播。