自律的 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，你已经有了马力——现在你也有了标准。