Show HN: Sphinx – 在部署前對 AI 程式碼進行提問檢查的 Hook

開源工具 Sphinx：在部署前對 AI 程式碼進行提問檢查

Sphinx 是一款開源工具，為協作開發工作流程加上一層「理解力檢查」。它的核心想法是「你可以外包思考，但不能外包理解」。開發者把程式碼推送到受保護的分支時，Git 會暫停並彈出問卷，要求開發者預測變更的影響。如果答錯，系統會提供解釋，並給出新的情境讓開發者再試，直到通過檢查，推送才會繼續。這個機制適用於 Claude Code、Codex、Cursor、OpenCode、Pi 等編程代理工具，也適用於只用普通 git push 的場景。

運作機制與審查模型

Sphinx 的檢查由獨立的審查模型執行。這個模型透過唯讀 Git 工具讀取已提交的變更，但看不到產生程式碼的對話記錄。問題涵蓋行為、故障模式與不變量，而不是單純問檔案或函數名稱。檢查採開卷形式，開發者可以先閱讀程式碼，或請代理工具展示內容後再作答。

舉例來說，針對新增背景工作佇列的變更，系統可能會問：「若工作者在提交操作後但在確認前崩潰，重送時操作是否會執行兩次？」如果開發者答錯，Sphinx 會指出確認動作發生在提交之後，崩潰會使未確認的工作被重送，操作因此執行兩次。接著系統會給出新情境，例如工作超時導致重複接收，要求開發者說明如何防止重複執行。

安裝與設定要求

安裝 Sphinx 需要 Node.js 22.19 或更新版本、Git，以及 macOS、Linux 或 WSL 環境，原生 Windows 目前不支援。執行 `sphinx install` 會設定全域 Git `core.hooksPath`，並確保現有鉤子先執行，之後對 `main` 或 `master` 分支的推送都會受到檢查。開發者可用 `sphinx init` 調整各儲存庫的設定。

使用 Sphinx 需要審查模型帳戶。可選擇已登入的 Codex 或 Claude Code CLI（使用其方案額度）、OpenRouter API 金鑰（需單獨計費，即使用免費模型也需要金鑰），或任何 OpenAI 相容端點。Sphinx 本身沒有帳號或託管服務。

安全與隱私考量

程式碼會離開本地機器。審查提供者會收到變更的程式碼、相關檔案、開發者的答案，以及 `.sphinxcontext.md` 的內容。預設情況下，`.env` 檔案、私密金鑰和常見憑證檔案會被排除，被忽略的檔案也不會被讀取。開發者應在首次檢查前，把敏感路徑加進 `.sphinxignore`。忽略規則只比對檔案路徑，所以如果秘密被貼進一般原始碼，規則就偵測不到。

Sphinx 沒有預設的模型呼叫上限。典型檢查約需 5 至 8 次請求，之後每次回答再多約一次請求。開發者可以自行設定上限，也建議在付費提供者那邊設定支出限制。

檢查流程與限制

推送觸發檢查後，Git 最多會等待 25 分鐘。如果編程代理工具的殼層逾時比這更快，可能會出問題。檢查期間，開發者可以暫停、跳過或繼續。跳過不算通過，也不會阻止推送。答錯時，開發者會拿到解釋並面對新情境；提出爭議或發生錯誤同樣不算通過。關閉瀏覽器分頁不會停止檢查，Git 會繼續等，直到 25 分鐘期限結束。

Sphinx 只檢查本地提交與推送，不涵蓋網頁合併、CI 必要檢查或部署。它無法讀取二進位檔案內容，測試的是理解力，不是稽核程式碼。通過檢查，並不能證明程式碼由誰撰寫，也不能證明開發者是獨立理解的，因為本地存取者（包括編程代理工具）可以繞過鉤子或尋求外部協助，而且審查者是 LLM，也可能出錯。

配置與命令

開發者可用 `sphinx config` 調整審查模型、介面（瀏覽器或終端機）和限制。`.sphinxconfig` 檔案可設定檢查的事件、分支、遠端和深度。`.sphinxignore` 以 gitignore 風格的模式排除檔案。`.sphinxcontext.md` 放專案的簡短描述，幫助審查者聚焦重點，內容應小於 16 KB，且不含秘密。

常用命令包括：`install` 設定全域鉤子、`init` 建立儲存庫政策、`doctor` 檢查整合狀態、`check` 在終端機啟動檢查、`yolo` 切換跳過檢查，以及 `uninstall` 移除整合。GitHub 使用者可選擇在提交上標記狀態，或在拉取請求中留下摘要評論，但這不會阻止推送。