CLAUDE.md・スキル・サブエージェント・フックの使い分け
CLAUDE.md、スキル、サブエージェント、フック。似た言葉が並ぶので、違いを1つの表にまとめました。
ただ、先にお伝えしておくと、使い分けは部長（部門ごとのフォルダで動く Claude Code）に任せてよいと私は考えています。その理由も紹介します。
4つを会社にたとえると
このサイトでは、4つを会社にあるものにたとえています。並べると、次のようになります。
| 名前 | たとえ | 動くとき | 向いていること |
|---|---|---|---|
| CLAUDE.md | 部門の方針書 | 毎回、全部読まれる | いつも守ってほしい決まり |
| スキル | 作業の手順書 | 部長が必要と判断したとき（あなたが名前を指定して呼ぶこともできる） | 何段階もある作業の進め方 |
| サブエージェント | 寡黙な職人 | 部長が仕事を頼んだとき | 結果だけ欲しい作業、別の目での確認 |
| フック | 必ず通る関所 | 決まった場面が来たら必ず | 忘れては困る確認 |
足すきっかけの目安
公式の説明では、最初から全部を用意しなくてよいとされています。まずは CLAUDE.md から。困ったことが起きたら、それに合うものを足していけばよい、という考え方です。
公式が挙げている目安のうち、この4つに関わるものは次のとおりです。
- 部長が同じ間違いを2回したら、CLAUDE.md に決まりを書く
- 同じ手順を何度もチャットに貼っているなら、スキルにする
- 本題とは別の作業で、あとで見返さない結果がチャットにあふれるなら、サブエージェントに回す
- 頼まなくても毎回必ず起きてほしいなら、フックにする
必ず守らせたいならフック
使い分けは任せても、1つだけ知っておくと役に立つ違いがあります。公式の説明では、CLAUDE.md やスキルに書いた決まりは、お願いにすぎません。部長が読んで、従おうとするものです。
毎回必ず守らせたい決まりは、フックにするよう公式は勧めています。私の場合は、返答が何度も英語になり、イライラしていました。そこで、日本語で書き直させるフックを入れています。
フックについては、こちらの記事で解説しています。
関連記事：フックとは何か、CLAUDE.md の決まりとの違いを知る
使い分けは部長に任せていい
私は、どれを使うかを決めていません。部長が選んで、進めてくれるからです。
任せてよいのには、理由があります。
公式の説明によると、スキルやサブエージェント（寡黙な職人）には、何をするものかを書いた短い説明が付いています。部長が読むのは、この説明。今の作業に合うものを、ここから選びます。
説明がはっきり書かれていれば、選び間違えにくいということです。
CLAUDE.md は毎回読まれ、フックは決まった場面で必ず動きます。どちらも、使うたびに選ぶものではありません。
私は部長に、相談の途中で必要があれば、スキル・サブエージェント・フックを積極的に使ってほしいとお願いしました。そのときのことは、こちらの記事で紹介しています。
関連記事：スキルとは何か、CLAUDE.md との違いを知る
あなたにも、使い分けは部長に任せることをお勧めします。
手順書は部長に作ってもらえる
目安に当てはまる作業に気づいたら、部長に頼んで手順書にしてもらえます。作ってもらう方法は、こちらの記事に書いています。
