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 flowfix(ui): correct color contrast
3.** Review First** : エージェントの生成物は必ずPR(Pull Request)として扱い、人間がレビューしてからマージする。
まとめ:環境が知性を形作る
優秀なエンジニアが良いデスク環境にこだわるように、優秀なエージェントには「整理されたディレクトリ」と「明確なルールファイル」が必要です。
この構成をテンプレートとして保存し、新規プロジェクトのたびにコピーして使うことをお勧めします。そうすれば、エージェントは初日から「ベテラン社員」のように動いてくれるはずです。
エージェント設定の実践的なデモ動画も併せてご覧ください。





⚠️ コメントのルール
※違反コメントはAIおよび管理者により予告なく削除されます
まだコメントがありません。最初のコメントを投稿しましょう!