open-gitagent/gitagent

解決的問題

Gitagent 是一個用於建立 AI 代理的框架，代理的完整狀態——包括其身份、規則、記憶和工具——都作為版本控制檔案儲存在 git 儲存庫中。這種「代理即儲存庫」的方法讓使用者可以像處理原始碼一樣，對代理的個性與記憶進行 fork、分支與 diff。

工作原理

代理由包含若干關鍵檔案的特定目錄結構定義：

• agent.yaml: 配置 LLM 模型、工具與執行階段設定。
• SOUL.md 與 RULES.md: 定義代理的個性與行為約束。
• memory/: 儲存具有完整歷史紀錄的 git 已提交記憶。
• tools/ 與 skills/: 包含宣告式工具定義與可組合的指令模組。

Gitagent 可以透過 CLI、程式化 TypeScript SDK 或語音 UI 執行。它還可以作為 MCP (Model Context Protocol) 用戶端運作，允許它自動發現並使用來自任何 MCP 伺服器的工具。

適用對象

• 希望對其 AI 代理配置與行為演進進行版本控制的開發人員。
• 希望透過 git 共享與協作代理個性及技能集的團隊。
• 希望擁有能夠與本地檔案、Shell 指令及外部 MCP 伺服器互動的多模態代理的使用者。

亮點

• Git 原生狀態: 身份、記憶與規則皆為版本控制檔案。
• MCP 整合: 原生支援任何 MCP 伺服器，實現即時工具擴充。
• 可擴充架構: 支援外掛程式、自定義宣告式工具與程式化生命週期鉤子。
• 靈活部署: 提供精簡的 CLI、用於進程內整合的完整 SDK 以及支援語音的 Web UI。