ファイルの基本形
プロジェクト専用なら .claude/agents/*.md に置きます。YAML frontmatterへ名前、使う場面、許可ツール、モデルを書き、本文をその役の指示にします。
---
name: inspector
description: 実装後にテスト・安全性・要件漏れを検査するときに使う
tools: Read, Glob, Grep, Bash
model: sonnet
---
あなたは検査係です。
ファイルは変更せず、要件と検証結果を照合してください。
問題は「場所・理由・直し方」の順で報告してください。江戸商家のように分ける
役職名は自由ですが、description には「いつ使うか」を具体的に書きます。役割を重ねすぎず、必要な道具だけ渡すことが公式ガイドの構成と合います。
| 部署 | 仕事 | 道具の目安 |
|---|---|---|
| 調査係 | 公式資料と現状を確認し、出典つきで返す | Read / Glob / Grep / Web |
| 実装係 | 決まった仕様を変更し、テストする | Read / Edit / Write / Bash |
| 検査係 | 変更せず、要件漏れと不具合を探す | Read / Glob / Grep / Bash |
| デザイン係 | 画面の使いやすさと表示崩れを確認する | Read / Glob / Grep / Bash |
| 物語係 | 決まった世界観に沿って文章案を返す | Read / Glob / Grep |
使い分け
- いつも守る短い約束は
CLAUDE.md - 必要なときだけ読む手順や知識はSkill
- 別文脈で完結する調査・検査はSubagent
- 複数セッション同士が連携する大仕事はAgent teams。これは実験機能です