vibesafe

Vibesafe 是一款專業的開發工具，旨在解決人工意圖與 AI 生成程式碼之間的落差。它提供了一個穩健的合約系統，讓開發者能夠透過型別註解與嵌入式 doctest 撰寫 Python 函式規格，並由 AI 填充經驗證的實作。透過內容尋址雜湊 (content-addressed hashing) 與確定性檢查點，Vibesafe 能確保生產環境執行的程式碼與開發階段測試的完全一致，防止非確定性 LLM 輸出所造成的程式碼漂移。此技能整合了 Vibesafe MCP 伺服器，讓您能夠管理整個工具鏈——從掃描專案中的裝飾器單元，到強制執行品質閘道與自動重新生成過時的程式碼。

• 執行全面的專案掃描，識別並索引所有經 Vibesafe 標記的單元及其元資料。

• 自動化程式碼生成與編譯任務，支援指定目標與強制重新生成，以實現精確的實作控制。

• 執行整合式 doctest 與品質閘道，透過 mypy 檢查型別安全，並透過 ruff 進行程式碼風格檢查。

• 管理並儲存經雜湊鎖定的檢查點，以凍結已驗證的程式碼，確保不同環境間的可重現性。

• 產生包含版本資訊、單元數量、環境狀態與檢查點完整性的詳細狀態報告。

• 透過比較當前實作與已驗證檢查點來偵測漂移，在部署前向開發者警示未經授權的規格變更。

• 當您從事需要 AI 輔助開發，且同時對安全性與可重現性有嚴格要求的企業級 Python 專案時，請使用此技能。

• 輸入通常包含選擇性操作的目標單元識別碼，或進行批次狀態檢查與驗證的專案範圍指令。

• 預期輸出包含診斷表格、編譯日誌、測試結果，以及檢查點同步確認。

• 請注意，Vibesafe 強制執行嚴格的開發/生產生命週期：在開發階段，雜湊不匹配會觸發自動重新生成；而在生產階段，這些不匹配會導致快速失敗錯誤，以保護部署的完整性。

• 確保您的環境已設定適當的 AI 供應商（如 OpenAI 相容的 LLM），以啟用 Vibesafe 框架內的自動生成能力。