kenn-io/roborev

roborev – 面向編碼代理的持續 AI 驅動程式碼審查

這是什麼

• 一個基於 Go 的命令列工具，安裝 post-commit Git 鈎子與背景守護程序。每次提交時，roborev 會將變更的程式碼傳送給基於 LLM 的編碼代理（Claude Code、Codex、Gemini、Copilot 等），並接收審查結果。
• 審查結果可在本地透過終端 UI（TUI）或原生瀏覽器 UI 查看。也可將結果回饋給同一代理，使其自動應用修復。

為何重要

• 依賴 AI 編碼助手的開發者經常收到後續發現有 bug 的建議。roborev 透過在變更累積前 立即 審查每個提交，填補了這項閉環。
• 所有處理皆在開發者的機器上執行，無需外部服務或雲端基礎設施，保持低延遲與資料私密性。

主要功能（如 README 所述）

功能	你能獲得什麼
後台審查	Git 鈎子會為每次提交觸發審查，無需遠端 CI 服務。
自動修復 / 優化循環	roborev fix 將審查結果送回代理，代理應用提交；roborev refine 重複此過程，直到審查通過。
代理鈎子	可選整合九種主流 AI 編碼代理（Claude Code、Codex、Gemini、Copilot CLI、Cursor、Factory Droid、Hermes、Qwen、Pi）。鈎子可將未決發現直接在代理的 UI 中顯示。
內建分析	重複程式碼、複雜度、重構、死程式碼、安全、測試用例建議、API 設計、架構檢查等。每項分析均以可自動修復的審查形式呈現。
互動式 TUI	Vim 風格導航，審查佇列與細節的分屏檢視。
原生瀏覽器 UI	本地 Web UI 顯示佇列，支援過濾、留言、關閉或重新執行審查，並展示分析資料（成本、延遲、可靠性）。
審查驗證	roborev compact 在呈現前去重並過濾誤報。
可擴展鈎子	在審查事件上執行任意 shell 命令；內建的 beads 和 kata 整合可自動建立問題工單。
匯出與分析	將完成的審查、CI 面板指標和成本資料匯出為 JSON，用於報告或歸檔。
設定	使用 .roborev.toml（專案本地）或 ~/.roborev/config.toml（全域）設定預設代理、模型、審查指南、提交作者資訊及 kata 整合設定。

典型工作流程

1. roborev init – 安裝 post-commit 鈎子。
2. 正常提交；鈎子將審查加入佇列。
3. 執行 roborev tui（或 roborev ui）查看發現。
4. 可手動修復，或執行 roborev fix / roborev refine 讓關聯的 AI 代理自動應用建議變更。
5. 可選安裝 roborev agent-hook，使代理的 UI 能即時顯示未決發現。

安裝選項

• 一行式 shell 腳本（curl … | bash）
• Homebrew tap（brew install kenn-io/tap/roborev）
• Windows 用 PowerShell 腳本
• go install go.kenn.io/roborev/cmd/roborev@latest
• 使用 make install 從原始碼建置（包含內嵌瀏覽器資源）

適合對象

• 已使用 AI 編碼助手並希望增加自動化本地程式碼審查步驟的團隊。
• 希望在不設定 CI 流水線的情況下，立即獲得 AI 生成程式碼回饋的獨立開發者。
• 需要 AI 生成變更的可重現審計日誌（匯出、成本追蹤、問題建立鈎子）的任何人。

總結 roborev 是一個真正的開源專案，透過整合 Git 鈎子、本地 LLM 代理與互動式 UI，提供在開發者機器上執行的持續 AI 驅動程式碼審查與自動修復。它正位於 AI 增強軟體開發工具的最前線。