◆ Claude Codeを「自分の仕事」に合わせて作り替える｜Skill・サブエージェント・フックの実装ガイド

■ この資料に書いてあること(購入前にご確認ください)

全19,000字前後です。無料で読める範囲でも、この資料が何を扱っているかが分かるようにしています。設定ファイルとコードはすべて全文を掲載しており、省略や「〜のように書く」で終わらせている箇所はありません。

なぜ「毎回同じ指示を打つ」が損なのか(指示を資産に変える考え方)

Claude Codeを素の状態のまま使い続け、毎回同じ前提・同じ注意事項を打ち込んでいる状態がなぜ損なのかを、「指示の使い捨て」と「指示の資産化」という対比で説明しています。

CLAUDE.mdの設計(何を書き、何を書かないか)

常時読み込まれるファイルに何を書くべきで、何を書くと逆効果になるかを、肥大化が実際にどう効かなくなるかのメカニズムつきで解説しています。

Skillの作り方(.claude/skills/<name>/SKILL.md 全文例つき)

frontmatterの name と description がそれぞれ何のためにあるか、特に description の書き方1つで自動呼び出しの精度がどう変わるかを、良い例・悪い例の両方で示しています。

サブエージェントの作り方(.claude/agents/<name>.md 全文例つき)

frontmatterでモデルとツールをどう絞るか、そして「どの作業をサブエージェントに切り出すべきか」を判断する基準(失敗したときに誰が気づくか)を、具体例とともに整理しています。

本体とサブエージェントの役割分担表

探索・判断は本体、手順が確定した反復作業はサブエージェント、広い探索は結論だけ受け取る、という切り分け方を表にして紹介しています。

フックの作り方(.claude/settings.json 全文例つき)

コミット前のテスト確認など、人間が忘れがちな工程を機械的に強制する仕組みを、実際に動くシェルスクリプトと設定ファイルの全文で紹介しています。

実際にやった失敗3つとその対処

排他資源の宣言と実際の運用がずれて事故りかけた話、対象ファイルが無い状態でサブエージェントを起動してしまった話、反復作業を全部本体に処理させて処理能力を溶かした話を、具体的な指示文の変更内容つきで紹介しています。

▼ 想定している読者

- Claude Codeを使い始めたが、標準機能のまま毎回同じ指示を打ち込んでいる方

- Skill・サブエージェント・フックという言葉は聞いたことがあるが、実際に手を動かして作ったことがない方

- 自分の業務(原稿執筆、コーディング、事務作業など)に合わせてClaude Codeをカスタマイズしたい方

▼ この資料で扱わないこと

- Claude Code自体のインストール・初期セットアップの手順

- 他のAIコーディングツールとの比較・優劣

- チームや組織規模での運用ルール整備(本資料は個人利用を前提にしています)

▼ お断り

- 記載しているコード・設定ファイルは実際に検証したうえで書いていますが、Claude Codeはアップデートが頻繁なツールであり、将来のバージョンで挙動が変わる可能性があります。導入時はお使いのバージョンでの動作をご自身でも確認してください

- 特定のツールやサービスの購入・契約を勧めるものではありません

- 本文中の失敗談は実際の運用から一般化した内容であり、特定の取引先・案件の詳細を含みません

────────────────────