エージェントスキルアーキテクチャガイド は何をしますか？
Claude Code、KiloCode、OpenClaw、OpenAI CodexにわたるAIエージェントスキルの構築と整理のための包括的なリファレンスです。SKILL.md仕様、フォルダ構造、モードスコープ付きスキル、エージェントオーケストレーション、セルフホストモデル設定をカバーします。
目次
はじめに
エージェントスキルは、AIコーディングアシスタントに特定の機能や知識を提供する自己完結型のモジュールです。このガイドは、複数のプラットフォームで一貫性のあるスキルを構築するための標準化されたアプローチを提供します。
SKILL.md 仕様
各エージェントスキルは、そのルートディレクトリにSKILL.mdファイルを含む必要があります。このファイルはスキルを定義し、以下のセクションを含みます：
- メタデータ: 名前、説明、バージョン、作成者。
- トリガー: スキルをアクティブ化する条件（キーワード、ファイルパターン、モード）。
- アクション: スキルが実行できるタスク（コード生成、リファクタリング、分析）。
- 設定: 環境変数、APIキー、モデル設定。
- 例: 使用方法を示すコードスニペット。
SKILL.md テンプレート
名前: my-custom-skill
説明: 私のカスタムエージェントスキルの説明。
バージョン: 1.0.0
作成者: あなたの名前
トリガー:
キーワード:
- "デプロイ"
- "ビルド"
ファイルパターン:
- "*.py"
- "Dockerfile"
アクション:
- 名前: デプロイ
説明: アプリケーションを本番環境にデプロイします。
コマンド: "deploy.sh"
フォルダ構造
スキルを整理するための推奨フォルダ構造：
skills/
├── my-skill/
│ ├── SKILL.md
│ ├── actions/
│ │ ├── action1.sh
│ │ └── action2.py
│ ├── config/
│ │ └── settings.yaml
│ └── docs/
│ └── usage.md
├── another-skill/
│ └── SKILL.md
モードスコープ付きスキル
特定のモード（例：codex、claude）にスキルを制限できます。SKILL.mdのmodeフィールドを使用します：
モード: ["codex", "claude"]
エージェントオーケストレーション
複数のエージェントスキルがどのように連携するかを定義します：
- チェーン: スキルA -> スキルB -> スキルC
- 並列: スキルAとスキルBを同時に実行
- 条件分岐: 条件に基づいて異なるスキルにルーティング
セルフホストモデル設定
セルフホストのAIモデルでスキルを使用するには、config.yamlで以下を設定します：
モデル:
プロバイダー: ollama
モデル名: codellama:7b
api_url: "http://localhost:11434"
認証:
タイプ: none
ベストプラクティス
- スキルは小さく、焦点を絞ったものにしてください。
- 各スキルに明確なトリガーを定義してください。
- 適切なバージョン管理を使用してください。
- アクションの使用例を含めてください。
- スキルを定期的に更新して、新しいプラットフォーム機能に対応してください。