Claude Code 2.1：フォークコンテキスト、ホットリロード＆カスタムエージェントガイド
Claude Code 2.1のスキル機能を深掘り：フォークコンテキスト、ホットリロード、カスタムエージェントサポート。実際の例とコードでこれらの機能の使い方を学びましょう。
Claude Code 2.1では、エージェントワークフローの構築と実行方法を根本的に変える3つのスキルレベルの機能がリリースされました：フォークコンテキスト、ホットリロード、カスタムエージェントサポート。スキルを単なるスラッシュコマンドのショートカットとして使っていたなら、このガイドでその真の実力を示します。動作するフロントマターの例、具体的なユースケース、Claude Codeセッション内でマルチエージェントパイプラインを組み立てるためのメンタルモデルを得られます。
なぜこの3つの機能が重要なのか
2.1以前、スキルは基本的にステートレスなプロンプトテンプレートでした。すべての呼び出しが現在の会話内で実行され、同じコンテキストウィンドウを共有し、場合によっては汚染していました。
フォークコンテキストは分離の問題を解決します。ホットリロードはイテレーション速度の問題を解決します。カスタムエージェントサポートは特化の問題を解決します。これらを合わせると、スキルは「スマートマクロ」から、Unixパイプのように組み合わせられる本格的なサブエージェントオーケストレーションへと移行します。
フォークコンテキスト：長時間実行タスクの分離
スキルのフロントマターにcontext: forkを追加すると、分離されたサブセッションで実行されます。
---
name: deep-research
description: >
メインセッションを汚染せずにマルチステップのリサーチタスクを実行。
トピックを徹底的に調査してクリーンなサマリーを返す時に使用。
context: fork
---
フォークコンテキストを使用するタイミング：
- スクロールしたくない大量の中間出力を生成するリサーチや分析タスク
- バッチ処理ジョブ（ファイルのリネーム、リポ全体のリンティング、テストフィクスチャの生成）
- クリーンなロールバックセマンティクスが必要なタスク
使用しないタイミング：
- フォーク内でやり取りしたいインタラクティブなタスク
- 共有状態を変更してメインセッションですぐに見えるようにする必要があるタスク
---
name: codebase-audit
description: >
コードベースのセキュリティアンチパターンを監査し、
優先順位付けされた調査結果レポートを返す。
context: fork
tools:
- Read
- Glob
- Grep
disable-model-invocation: false
---
あなたはセキュリティ監査者です。現在のプロジェクトのすべてのソースファイルを
体系的にスキャンして、ハードコードされたシークレット、SQL文字列連結、
入力バリデーションの欠如、非推奨の暗号APIの使用を確認してください。
重要度でランク付けされたMarkdownレポートを返してください。中間的な
検索結果は出力せず、最終的な構造化された調査結果のみを返してください。
ホットリロード：再起動なしでスキルをイテレーション
ホットリロード以前は、スキルの更新にはClaude Codeの再起動（セッションの喪失）か、新しいセッションのゼロからの開始が必要でした。2.1では、SKILL.mdファイルを編集して以下を実行するだけです：
/reload-skills
スキル定義が即座に更新されます。会話コンテキストはそのままです。この単一コマンドにより、実践的にスキル開発のイテレーション時間が約80%削減されました。
ホットリロードを使った実践的な開発ワークフロー：
- ラフドラフトで
SKILL.mdを作成 /your-skill-nameでスキルを呼び出し- Claudeの動作（または間違い）を観察
- エディタで
SKILL.mdを編集 /reload-skillsを実行- 再度呼び出し — 同じセッション、更新された動作
カスタムエージェントサポート：専門サブエージェント
agentフロントマターフィールドにより、スキル実行時に使用するエージェント設定を指定できます。
---
name: pr-reviewer
description: >
プルリクエストをロジックエラー、セキュリティ問題、
スタイル違反についてレビュー。
context: fork
agent: .claude/agents/strict-reviewer.md
tools:
- Bash
- Read
---
3つのエージェントターゲットオプション：
| フィールド値 | 動作 |
|---|---|
agent: explore | ビルトインのExploreエージェント（読み取り専用、広範な検索） |
agent: plan | ビルトインのPlanエージェント（分析と分解） |
agent: .claude/agents/my-agent.md | カスタムエージェント定義を使用 |
3つすべてを組み合わせる：完全なパイプライン例
ステップ1：リサーチスキル（フォーク、カスタムエージェント）
---
name: market-research
description: >
市場セグメントを調査し構造化された調査結果を返す。
メインセッションをクリーンに保つため分離して実行。
context: fork
agent: .claude/agents/researcher.md
tools:
- WebSearch
- Read
- Bash
---
ステップ2：レポートスキル（通常コンテキスト、リサーチ出力を消費）
---
name: generate-report
description: >
構造化された市場調査JSONをエグゼクティブ向け
PDFレポートに変換。/market-researchの後に呼び出す。
tools:
- Read
- Bash
disable-model-invocation: false
---
フロントマターのHooks：隠された第4の機能
2.1リリースでは、別のHooks設定ファイルを必要とせず、スキルのフロントマターに直接ライフサイクルフックを添付する機能も追加されました。
---
name: safe-deploy
description: >
現在のブランチをステージング環境にデプロイ。
事前デプロイチェックを実行し完了時にSlackに通知。
disable-model-invocation: true
hooks:
pre-tool-use:
- command: "bash scripts/pre-deploy-check.sh"
on_failure: block
post-tool-use:
- command: "bash scripts/notify-slack.sh"
on_failure: warn
---
既存スキルの2.1への移行
2.1以前に書かれたスキルがある場合の最小限の移行チェックリストです：
1. フォークコンテキストの候補を特定する
大量の中間出力を生成するスキルを探す：リサーチスキル、監査スクリプト、テストランナー。フロントマターにcontext: forkを追加。他の変更は不要です。
2. 手動リロードの回避策を削除する
スキル変更を反映するためにClaude Codeを再起動するスクリプトやエイリアスがあれば削除。/reload-skillsがすべてに取って代わります。
3. 再利用可能なエージェントパーソナリティを抽出する
特定の「ペルソナ」を記述する長いシステムプロンプトセクションがあるスキルは、それらのセクションを.claude/agents/ファイルに移動。agent:フィールドで参照。
4. リスクのあるスキルにHooksを追加する
ファイル書き込み、デプロイ実行、メッセージ送信、外部API呼び出しを行うスキルには、確認またはバリデーションスクリプト付きのpre-tool-useフックを追加。
この移行は完全に後方互換性があります。新しいフィールドのないスキルは以前と全く同じように動作し続けます。
次に構築するもの
これらの3つの機能により、2.1以前は実用的でなかったワークフローが可能になります：
- 並列リサーチ：異なるトピックで複数のフォークリサーチスキルを同時に呼び出し、メインセッションで統合
- 段階的コードレビュー：厳格なレビュアーにフォーク、パフォーマンスレビュアーに別にフォーク、メインで調査結果をマージ
- 安全なリファクタリング：大規模なリファクタリングを試みるためにフォークし、diffを検査し、適用するかどうかを決定
Claude Code 2.1リリースにより、スキルは便利な機能から本格的なオーケストレーションレイヤーへと移行しました。claudeskills.infoの141以上のスキルのエコシステム全体が、このレンズを通して閲覧する価値があります。多くのスキルがフォークコンテキストとカスタムエージェントと組み合わせると大幅にパワフルになります。
