| name | agent-spec |
| description | Use when creating, updating, or maintaining agents, understanding agent structure, or implementing subagents. Also use when user says エージェント, サブエージェント, agents. Claude Code プラグインの agent 仕様知識で、サブエージェントの正しい形式、フロントマター、tools/model/skills フィールドを提供する。 |
| context | fork |
| user-invocable | false |
| allowed-tools | Read, Grep, Glob |
Agent Spec スキル
Claude Code プラグインの agent（サブエージェント）仕様知識を提供する。
Instructions
このスキルは agent の正しい形式と実装パターンについての知識を提供します。
重要: 実装前に必ず公式ドキュメント（英語版）を確認し、最新の仕様に従ってください。
公式ドキュメント
エージェントとは
- 独立したコンテキストでタスクを実行するサブプロセス
- 親から呼び出され、結果を返す
- 専用の tools, model, skills を持つことができる
ファイル配置
agents/{agent-name}.md
agents/{category}/{agent-name}.md # サブディレクトリ可
- ファイル名がエージェント名になる
- kebab-case を使用（例:
code-reviewer.md）
- サブディレクトリでカテゴリ分類可能
フロントマター
必須フィールド
---
name: agent-name
description: いつ呼ばれるかの説明
---
オプションフィールド
---
name: agent-name
description: いつ呼ばれるかの説明
tools: Read, Glob, Grep, Bash
model: haiku
permissionMode: default
skills: skill1, skill2
---
| フィールド | 型 | 説明 |
|---|
name | String | エージェント識別子（必須） |
description | String | いつ呼ばれるかの説明（必須） |
tools | String | 使用可能ツール（省略時は全継承） |
model | String | 使用モデル |
permissionMode | String | 権限モード |
skills | String | 使用するスキル（カンマ区切り） |
tools フィールド
| 指定 | 動作 |
|---|
| 省略 | 親の全ツール + MCP ツールを継承 |
| 指定 | 指定ツールのみ使用可能 |
例
tools: Read, Glob, Grep
tools: Read, Glob, Grep, Bash, Write, Edit
model フィールド
エージェントでは短縮名を指定：
| 値 | 説明 |
|---|
inherit | 親から継承（推奨） |
haiku | 高速・定型タスク向け |
opus | 最高性能・複雑なタスク向け |
注意:
sonnet は現在の Claude Code では推奨されません- ユーザーの使用モデルを継承する
inherit がデフォルト推奨
例
model: inherit
model: haiku
model: opus
skills フィールド
エージェントはスキルを自動継承しません。使用するスキルは明示的に指定：
skills: security-check, code-style
注意: ビルトインエージェント（Explore, Plan, Verify）と Task ツールはスキルにアクセス不可
permissionMode フィールド
| 値 | 説明 |
|---|
default | デフォルト権限 |
bypassPermissions | 権限チェックをバイパス |
実装例
基本的なエージェント
---
name: code-reviewer
description: コードレビューを担当。コード品質、セキュリティ、パフォーマンスを評価。
tools: Read, Glob, Grep
model: inherit
---
# Code Reviewer エージェント
あなたはコードレビューを担当するサブエージェントです。
## 役割
1. コードを読み込む
2. 品質・セキュリティ・パフォーマンスを評価
3. 改善点を報告
## 出力フォーマット
レビュー結果を構造化して報告してください。
スキル参照エージェント
---
name: security-auditor
description: セキュリティ監査を担当。脆弱性、認証、認可をチェック。
tools: Read, Glob, Grep
model: inherit
skills: security-check, owasp-top10
---
# Security Auditor エージェント
あなたはセキュリティ監査を担当するサブエージェントです。
## 役割
1. security-check スキルに従ってコードを分析
2. owasp-top10 スキルの知識を活用
3. 脆弱性を報告
## 出力フォーマット
| 脆弱性 | 重要度 | 推奨対策 |
|--------|--------|---------|
| ... | ... | ... |
実行系エージェント
---
name: test-runner
description: テスト実行を担当。ユニットテスト、統合テストを実行し結果を報告。
tools: Read, Glob, Grep, Bash
model: inherit
---
# Test Runner エージェント
あなたはテスト実行を担当するサブエージェントです。
## 役割
1. テストコマンドを実行
2. 結果を解析
3. 失敗テストを報告
## 実行フロー
1. テストスクリプト検出（package.json, pytest.ini など）
2. テスト実行
3. 結果解析と報告
バリデーションルール
| ルール | 重要度 |
|---|
フロントマターに name 必須 | エラー |
フロントマターに description 必須 | エラー |
| ファイル名は kebab-case | 推奨 |
| model は短縮名（haiku, opus, inherit） | 必須（指定時） |
Examples
エージェント作成の相談
Q: 新しいエージェントを作りたい
A: agents/{name}.md を作成し、フロントマターに name と description を必ず含めてください。
tools で使用可能ツールを制限、model でモデルを指定できます。
スキル参照の相談
Q: エージェントでスキルを使いたい
A: フロントマターに skills: skill-name1, skill-name2 のように指定してください。
エージェントはスキルを自動継承しないため、明示的な指定が必要です。
model 指定の相談
Q: エージェントで使うモデルを指定したい
A: フロントマターに model: inherit（推奨）を追加してください。
inherit はユーザーの使用モデルを継承します。
特定のモデルが必要な場合は haiku または opus を指定できます。
