Agent Spec スキル

Claude Code プラグインの agent（サブエージェント）仕様知識を提供する。

Instructions

このスキルは agent の正しい形式と実装パターンについての知識を提供します。

重要: 実装前に必ず公式ドキュメント（英語版）を確認し、最新の仕様に従ってください。

公式ドキュメント

• Sub-agents
• Claude Models (API)

エージェントとは

• 独立したコンテキストでタスクを実行するサブプロセス
• 親から呼び出され、結果を返す
• 専用の 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
---

tools フィールド

例

# 読み取り専用エージェント
tools: Read, Glob, Grep

# 実行可能エージェント
tools: Read, Glob, Grep, Bash, Write, Edit

model フィールド

エージェントでは短縮名を指定：

注意:

• sonnet は現在の Claude Code では推奨されません
• ユーザーの使用モデルを継承する inherit がデフォルト推奨

例

# 親と同じ（推奨）
model: inherit

# 高速エージェント
model: haiku

# 高精度エージェント
model: opus

skills フィールド

エージェントはスキルを自動継承しません。使用するスキルは明示的に指定：

skills: security-check, code-style

注意: ビルトインエージェント（Explore, Plan, Verify）と Task ツールはスキルにアクセス不可

permissionMode フィールド

実装例

基本的なエージェント

---
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. 結果解析と報告

バリデーションルール

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 を指定できます。