客製化與安全
預設的代理不認識你的專案慣例，也不知道哪些動作該先問你。這一區說明如何用四個層次讓它更懂你，以及如何用權限與沙盒把風險控制在可接受的範圍。
四個客製化層次
| 層次 | 解決的問題 | 一句話 |
|---|---|---|
| Rules | 代理不知道專案規範 | 寫成文字，讓代理照做 |
| Skills | 代理不會你的固定流程 | 打包成可重複載入的技能 |
| MCP | 代理拿不到外部資料 | 連資料庫、API 與開發工具 |
| Subagents 與 Hooks | 任務太大，或要自動檢查 | 平行分工、在關鍵節點跑腳本 |
安全設定
- 權限與沙盒：Deny > Ask > Allow 規則、權限預設組合、終端機沙盒與瀏覽器隔離。
設定檔放哪裡
多數設定有「工作區」與「全域」兩個位置。工作區設定放在專案根目錄的 .agents/ 下，可以進版本控制、與團隊共享；全域設定放在家目錄，對你所有專案生效。
| 類型 | 工作區 | 全域 |
|---|---|---|
| Rules | .agents/rules/、專案根目錄的 GEMINI.md／AGENTS.md |
~/.gemini/GEMINI.md（CLI 為 ~/.gemini/antigravity-cli/rules/） |
| Skills | .agents/skills/<名稱>/ |
~/.gemini/config/skills/（CLI 為 ~/.gemini/antigravity-cli/skills/） |
| MCP | .agents/mcp_config.json |
~/.gemini/config/mcp_config.json |
| Subagents | .agents/agents/<名稱>.md |
~/.gemini/config/agents/<名稱>.md |
| Hooks | .agents/hooks.json |
~/.gemini/config/hooks.json |
| CLI 設定 | — | ~/.gemini/antigravity-cli/settings.json |
先從 Rules 開始
多數專案只要一份好的 Rules 就能明顯提升品質。其他層次等到真的遇到重複問題再加。