Elvis Li
Back to all posts
Engineering

規律あるAI：AntigravityにGoogleのAgent Skillsを注入する

#ai#software-engineering#antigravity#github

現実を見ましょう：AIが生成したコードは高速ですが、しばしばメンテナンスの悪夢となります。MacでAntigravityのようなツールを使用したことがあるなら、スピードがあることは知っているでしょうが、通常、規律はありません。

これを修正するために、Googleのエンジニアリング・リーダーシップはAgent Skillsをリリースしました。これは、AIに社内のソフトウェアエンジニアリング基準に従うことを強制する、20のアトミックスキルと7つのコマンドのセットです。これらの標準をローカルのMacBook環境に組み込む方法は次のとおりです。

コアバリュー：反合理化 (Anti-Rationalization)

AIは、テストの記述を避けるために「ハルシネーション（幻覚）」を起こしたり、「簡単すぎる」という理由でドキュメント作成のフェーズをスキップしたりする傾向があります。

Agent Skillsフレームワークは反合理化を導入します。AIがステップをスキップしようとすると、システムは押し返します。これは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 スキルを使用して、要件の定義を手伝ってください。」

AIが単にコードを書くのではなく、目標、ユーザーシナリオ、および非機能要件について尋問し始めた場合、ローカル環境にGoogleの基準を注入することに成功しています。

2. Gitのベストプラクティス

チームにも同じスキルを使用してもらいたいと思いますが、AIの「思考ログ」やセッションデータでリポジトリを汚染したくはないでしょう。これを.gitignoreに追加します：

# --- AI Agent Config ---
# 頭脳のランタイムデータを無視
.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はもはや単なるチャットボットではありません。「ログインページを作って」と言う代わりに、スラッシュコマンドを使い始めます：

  1. /spec：AIに技術仕様を最初に記述させます。
  2. /plan：その仕様をタスクリストに分割します。
  3. /review：「クリーンコード」の基準に照らして作業を監査します。

/specを実行するのに余分に60秒かかりますが、後で技術的負債のデバッグにかかる3時間を節約できます。M3 Macを実行しているなら、あなたには馬力があります。今、あなたには基準があります。