GAAI-framework
將 AI 編碼工具轉化為可靠的軟體交付系統。在任何專案中放入 .gaai/ 資料夾 — Discovery 定義建置內容,Delivery 自動執行直到通過標準。
GAAI-framework 是什麼?
將 AI 編碼工具轉化為可靠的軟體交付系統。在任何專案中放入 .gaai/ 資料夾 — Discovery 定義建置內容,Delivery 自動執行直到通過標準。相容於 Claude Code、Codex CLI、Gemini CLI、Cursor 等工具。無需 SDK。無需套件。僅需 Markdown + YAML + bash。
GAAI-framework 概覽
這是什麼
GAAI-framework 是一個為 AI 編碼工具設計的治理層。它是一個 .gaai/ 資料夾,你可以放入任何 git 專案中。它使用 Markdown、YAML 和 bash,並附帶一個自帶的 Python 執行環境和幾個 Node 輔助工具。沒有 SDK、沒有需要安裝的套件、也沒有外部服務。這個框架透過加入跨工作階段的記憶、範圍授權和結構化交付,將 AI 編碼工具轉變為可靠的代理式軟體交付系統。
主要功能
- 探索與交付隔離:探索(Discovery)只推理,從不執行;交付(Delivery)只執行,從不決定範圍。它們在不同的作業系統行程中執行,因此系統提示不會互相污染。
- 待辦事項作為合約:待辦事項是探索與交付之間的合約。只有列在其中的東西才會被建置。
- 交付守護程序:
/gaai-daemon啟動一個背景守護程序,輪詢待辦事項並平行交付多個故事,每個故事在自己的 tmux 工作階段中執行。需要一個具有staging分支的 git 儲存庫。 - 可移植至支援子代理的執行環境:交付工作流程適用於 Claude Code、Codex CLI、Gemini CLI、Cursor 等工具。Claude Code 是參考實作。
- 無 SDK 或套件:治理是 Markdown、YAML 和 bash。交付還需要在 PATH 中有
python3和node,以及.gaai/core/vendor/中自帶的 PyYAML 執行環境。 - 結構化專案資料夾:
.gaai/資料夾包含core/(框架引擎,自動同步)和project/(你的專案資料,更新時不會被覆寫)。
使用情境
GAAI 專為已經有產品清晰度的開發者打造——獨立創業者、資深工程師和小型團隊,他們知道要建置什麼,並需要一個能可靠交付且不偏離腳本的代理。適合任何曾說過「代理碰了它不該碰的程式碼」的人。
快速開始
將 .gaai/ 資料夾複製到你的專案中。從 GitHub 下載,將 .gaai/ 放入專案根目錄,然後告訴你的 AI 工具:「讀取 .gaai/core/README.md 並引導此專案。」選項 A — 請你的 AI 工具執行:Install the GAAI framework into my current project.Determine {user-tool} by identifying which AI coding tool is running thisprompt. Valid values: claude-code | cursor | windsurf | other.If you cannot determine it, ask the user before proceeding.Then run: rm -rf /tmp/gaai git clone https://github.com/Fr-e-d/GAAI-framework.git /tmp/gaai bash /tmp/gaai/.gaai/core/scripts/install.sh --target . --tool {user-tool} --yes rm -rf /tmp/gaaiAfter install, show the user the next steps exactly as printed by theinstaller.選項 B — CLI:bashgit clone https://github.com/Fr-e-d/GAAI-framework.git /tmp/gaai && bash /tmp/gaai/.gaai/core/scripts/install.sh --wizard && rm -rf /tmp/gaai
授權與價格
授權條款未標明。此專案被列為開源。
內容整理自該專案公開的 README 與儲存庫資訊。