2026-03-26_agent-skills

# Agent Skills ## AIエージェントの新しいオープンスタンダード 2026.03.26 イジゲングループ株式会社　開発本部　宮崎ひび --- ## Agent Skills とは AIエージェントに**モジュール化された再利用可能な能力**を提供する仕組み - 指示書・スクリプト・テンプレートをフォルダにまとめた「スキルパッケージ」 - エージェントがタスクに応じて動的にロードし、専門的な作業を遂行 - Anthropicが開発し、2025年12月に**オープンスタンダード**として公開 - 現在30以上のAIツールが同じ形式を採用 --- ## スキルの基本構造 ``` my-skill/ ├── SKILL.md # メインの指示書（必須） ├── scripts/ # 実行可能スクリプト ├── references/ # 参照ドキュメント └── assets/ # テンプレート・素材 ``` 核となるのは `SKILL.md` — YAMLフロントマター + Markdown形式の指示内容 --- ## 段階的ロードの仕組みスキルは3段階でコンテキストに読み込まれる | 段階 | 内容 | タイミング | |------|------|-----------| | **Level 1** | name + description（~100トークン） | 常にコンテキストに常駐 | | **Level 2** | 関連性の判断 | ユーザーのリクエストと照合 | | **Level 3** | SKILL.md全体をロード | 関連ありと判断された時 | コンテキストウィンドウを効率的に使用する設計 --- ## 呼び出し方法 - **自動呼び出し**: 会話内容に基づいてエージェントが自動選択 - **手動呼び出し**: `/skill-name` でスラッシュコマンドとして直接実行 - **呼び出し制御**: フロントマターで自動呼び出しの禁止や非表示が可能 ```yaml --- name: my-skill description: スキルの説明 disable-model-invocation: true # 自動呼び出し禁止 allowed-tools: Read, Grep # ツール制限 --- ``` --- ## 配置場所と優先度 | レベル | パス | 適用範囲 | |--------|------|----------| | Enterprise | マネージド設定 | 組織全体 | | Personal | `~/.claude/skills/` | 全プロジェクト | | Project | `.claude/skills/` | 該当プロジェクトのみ | | Plugin | プラグイン内 | プラグイン有効時 | 優先順位: **Enterprise > Personal > Project** --- ## 主要なユースケース - **コード規約の適用** — APIデザインパターン・命名規則をチーム共有 - **デプロイ自動化** — テスト→ビルド→デプロイの手順をスキル化 - **ドキュメント生成** — プレゼン資料・レポートの自動生成 - **PR要約・レビュー** — GitHub PR情報を取得し自動で要約 - **ドメイン知識の提供** — レガシー仕様・業界規制・社内ルールを格納 --- ## 対応ツール一覧 | ツール | 開発元 | 備考 | |--------|--------|------| | **Claude Code** | Anthropic | 標準策定元。最も機能豊富 | | **OpenAI Codex CLI** | OpenAI | SKILL.md形式を採用 | | **GitHub Copilot** | Microsoft | VS Code内でサポート | | **Cursor** | Cursor Inc. | AI IDEとして統合 | | **Gemini CLI** | Google | Agent Skills仕様を採用 | | **Kiro** | AWS | AWSのAI開発ツール | 他にもGoose、Roo Code、Spring AIなど **30以上のツール** が対応 --- ## メリットとデメリット **メリット** - ファイルを置くだけで動作、特別なSDK不要 - 30以上のツール間で互換性あり（ベンダーロックイン解消） - Gitでバージョン管理・チーム共有が可能 - `allowed-tools` によるセキュリティ制御 **デメリット** - スキル数増加でコンテキスト予算を圧迫する可能性 - descriptionの書き方次第で発火精度が変動 - オープンスタンダードは歴史が浅く、実装差異が存在 --- ## 今後の展望 - **エコシステムの急拡大** — 公開3ヶ月で30以上のツールが採用 - **スキルマーケットプレイス** — npm的なレジストリの整備が進行中 - **エンタープライズ活用** — 組織ナレッジのスキル化と全社展開 - **マルチエージェント連携** — 複数の専門エージェントが協調するワークフロー - **ツール間ポータビリティ** — 同一SKILL.mdを複数ツールで使い回す世界へ ---