🧠
🧠

Agent Skills

  • Google Antigravityの新機能で、エージェントを『専門社員』に。

  • ただの助手から、自律的にタスクをこなすパートナーへ。

Slide 1 of 3Remaining 2

Google Antigravityの新機能「Agent Skills」は、エージェントを自律的な専門家へと進化させます。しかし、その真価を発揮するためには、適切な 「住処(Habitat)」 を整える必要があります。

本記事では、2026年現在のベストプラクティスに基づく 「推奨フォルダ構成」「設定ファイル(Config)」 の完全ガイドをお届けします。

1. ディレクトリ構成の決定版 (Standard Structure)

2026年の標準的な構成は以下の通りです。この構造を維持することで、エージェントはコンテキストを迷わずに取得できます。

推奨ディレクトリ構成

.
├── .antigravity/ # The Agent"s "Brain" & "Config"
│ ├── skills/ # 個別のスキル(タスク単位)
│ │ ├── create-article/
│ │ │ ├── SKILL.md # 手順書 (Detailed SOP)
│ │ │ └── scripts/ # 専用ツール (Python/TS)
│ │ └── deploy/
│ ├── rules/ # グローバルな行動指針
│ │ └── rules.md # プロジェクト共通の制約
│ └── README.md # エージェント向けプロジェクト概要
├── .agent/ # (Legacy) 旧バージョンのワークフロー
└── src/ # ソースコード

なぜこの構造なのか?

  • Self-Contained (自己完結性) : スクリプトを skills/ 内に配置することで、そのスキルを使う時だけツールが読み込まれます(Just-In-Time Context)。
  • Clear separation : rules/(守るべきルール)と skills/(やるべきこと)を明確に分離します。

2. Setting Files: 何を書くべきか?

.antigravity/rules/rules.md

プロジェクト全体でエージェントが「絶対に守るべき」制約を記述します。

# Agent Rules

## Code Style

- **Framework** : Astro v5 + React
- **Language** : TypeScript (Strict mode)
- **Styling** : Tailwind CSS (Utility-first)

## Forbidden Actions

- ❌ Do NOT make changes to `legacy/` directory.
- ❌ Do NOT use `npm` or `yarn`. Always use `pnpm`.

.antigravity/skills/[skill-name]/SKILL.md

特定のタスクを実行するための詳細手順書です。

---
name: create-feature
description: 新機能を実装するための標準フロー。テスト駆動開発(TDD)を採用。
---

# 手順
1. **仕様理解** : ユーザーの要望を分析し、ユースケースを列挙する。
2. **テスト作成** : `src/tests/` に失敗するテストを作成する。
3. **実装** : テストが通る最小限のコードを実装する。
4. **リファクタリング** : コードを整理し、`rules.md` の規約に合わせる。

3. 推奨されるVS Code設定

Antigravityエージェントと快適に協調作業を行うための設定です。

.vscode/settings.json

{
 "antigravity.agent.mode": "auto, // タスクに応じてPlan/Fastを自動切替
 "antigravity.security.sandbox": "strict", // 破壊的コマンドのブロック
 "files.exclude": {
 " **/.antigravity/cache": true // エージェントの思考ログを隠す
 }
}

4. エージェントとの「共存」Gitフロー

エージェントによる変更と人間による変更が衝突しないための運用ルールです。

1.** Agent Branch **: 大きなタスク(リファクタリング等)は、エージェント専用のブランチ(例: agent/refactor-auth)で作業させる。

2.** Conventional Commits **: エージェントにはコミットメッセージの形式を強制させます。

  • feat(auth): add login flow
  • fix(ui): correct color contrast

3.** Review First** : エージェントの生成物は必ずPR(Pull Request)として扱い、人間がレビューしてからマージする。

まとめ:環境が知性を形作る

優秀なエンジニアが良いデスク環境にこだわるように、優秀なエージェントには「整理されたディレクトリ」と「明確なルールファイル」が必要です。

この構成をテンプレートとして保存し、新規プロジェクトのたびにコピーして使うことをお勧めします。そうすれば、エージェントは初日から「ベテラン社員」のように動いてくれるはずです。

引用: YouTube

エージェント設定の実践的なデモ動画も併せてご覧ください。