自律的 AI：在 Antigravity 中注入 Google 代理技能

說實話：人工智慧生成的代碼速度很快，但這通常是一場維護噩夢。如果您在 Mac 上使用過像 Antigravity 這樣的工具，您就會知道速度是有的，但通常缺乏自律。

為了解決這個問題，Google 的工程領導團隊發布了 Agent Skills——一套包含 20 項原子技能和 7 個命令的集合，它強制人工智慧遵循內部軟體工程標準。以下是如何將這些標準融入到您的本地 MacBook 環境中。

核心價值：反合理化 (Anti-Rationalization)

由於“太簡單”，人工智慧傾向於以“幻覺”的方式跳過編寫測試或文件階段。

Agent Skills 框架引入了 反合理化。如果人工智慧試圖跳過某個步驟，系統就會進行反擊。它強制執行 Beyoncé 規則（“如果你喜歡它，你就應該給它加個測試”），並確保在編寫第一行代碼之前，每一行代碼都有規範 (Spec) 作為支撐。

1. 設置您的 Mac M3

因為我們在 Apple Silicon 上，所以我們希望保持工具的原生性和路徑的整潔。我們將從 Homebrew 和 GitHub CLI (gh) 開始。

1.1 安裝工具和認證

打開終端並運行以下命令以確保您的環境已準備就緒：

# 安裝 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 確保 Brew 在您的路徑中
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"

# 安裝 GitHub CLI 並登錄
brew install gh
gh auth login

在運行 gh auth login 之後。請完全按照提示進行操作：選擇 GitHub.com -> HTTPS -> Yes（用於驗證） -> Login with a web browser（使用網路瀏覽器登錄）。

專家提示：您的終端會吐出一個 8 個字元的代碼（例如 1234-ABCD）。按 Enter 鍵在瀏覽器中打開 GitHub，將該代碼粘貼到框中，然後單擊綠色的 Authorize 按鈕以鏈接您的帳戶。

1.2 將技能注入 Antigravity

Antigravity 會尋找特定的目錄結構來“學習”新行為。我們將把 Google 的工程標準直接克隆到您項目隱藏的代理文件夾中。

# 導航到您的項目根目錄
cd ~/your-project-path

# 為 AI 技能創建標準目錄
mkdir -p .agent/skills

# 克隆 Google Agent Skills 倉庫
gh repo clone addyosmani/agent-skills .agent/skills/engineering-standards

# 清理嵌套的 git 數據，以便您可以在自己的倉庫中跟蹤它
rm -rf .agent/skills/engineering-standards/.git

1.3 激活“大腦”

既然技能已經到位，您需要喚醒它們。重新啟動 Antigravity，或者直接在其控制台中運行：

/reload-skills

測試設置：將此內容拖入 Antigravity 聊天中：

“我想啟動一個新功能。使用 /spec 技能幫助我定義需求。”

如果人工智慧開始向您詢問有關目標、用戶場景和非功能性需求的問題，而不僅僅是編寫代碼，那麼您已經成功地將 Google 的標準注入到您的本地環境中了。

2. Git 最佳實踐

您希望您的團隊使用這些相同的技能，但您不想用 AI 的“思維日誌”或會話數據污染您的倉庫。將此內容添加到您的 .gitignore 中：

# --- AI 代理配置 ---
# 忽略大腦的運行時數據
.agent/workspaces/
.agent/logs/
.agent/cache/
.agent/sessions/

# 保留技能
!.agent/skills/

2.1 深入探討：為什麼 Git 策略很重要

您可能想知道為什麼我們對 .gitignore 如此挑剔。原因如下：

2.1.1 為什麼你不應該忽略 .agent/skills

agent-skills 文件夾本質上是您的 AI 的“標準操作程序”。

一致性：如果您不提交此文件夾，您的隊友（或在不同機器上的您）只會得到一個“通用”的 AI。您將失去訪問諸如 /spec 或 /review 等高級技能的權限。

版本控制：如果您調整了 SKILL.md——例如，將所需的測試覆蓋率從 80% 提高到 90%——該邏輯應該與您的源代碼一起存在和發展。

2.1.2 為什麼你必須忽略其他子目錄

隱私與安全：諸如 .agent/sessions 或工作區之類的文件夾可能包含原始對話歷史記錄、敏感的中間數據或您的工作過程片段。您絕對不希望將其推送到伺服器。

零效用：日誌和緩存是在本地生成的，特定於您的機器。提交它們只會使倉庫膨脹，並產生不必要的合併衝突。

3. 從“聊天機器人”轉變為“工程師”

一旦您重新啟動 Antigravity，AI 就不再只是一個聊天機器人。不要說“給我建一個登錄頁面”，而是開始利用斜槓命令：

/spec：強制 AI 首先編寫技術規範。
/plan：將該規範分解為任務列表。
/review：對照“整潔代碼”標準審核工作。

運行一個 /spec 會多花 60 秒鐘，但它可以在以後節省 3 個小時的技術債務調試時間。如果你運行的是 M3 Mac，你已經有了馬力——現在你也有了標準。