Skip to main content
Legalai.guide
claude tutorialClaude tutorial

Tutorial 09: Custom Legal Skills, Hooks & Agents

Build custom skills for your firm's workflows, create compliance hooks, and deploy multi-agent systems for complex legal tasks.

What You'll Learn

このチュートリアルでは、カスタム法務スキルの構築、セーフティチェック（フック）の追加、マルチエージェントワークフローの実行方法を説明します。技術的習熟が必要です。

エキスパートレベル

開発者スキル推奨。推定所要時間：120 分。

Claude Code 2.1.181 ソース確認

Claude Code 2.1.181 では、/config key=value、サンドボックス化された macOS Apple Events 向けの opt-in 設定 sandbox.allowAppleEvents、CLAUDE_CLIENT_PRESENCE_FILE、思考中の API 接続断に対する retry 改善、ネットワークドライブやクラウド同期フォルダでのより安全な Write/Edit、MCP tools/list 失敗の可視化、さらに background sessions、subagents、Remote Control、clipboard、settings、timezone の各修正が追加されました。Allowlisted な Claude Code Action も、同梱の Claude Code と Claude Agent SDK の既定値を 2.1.181 / 0.3.181 に更新しました。法務リポジトリでは、managed settings の変更、macOS 自動化権限、cloud folder への書き込み挙動、MCP ヘルスチェック、background-session history retention、subagent depth controls、GitHub Action の version pins を、client data を含むフォルダで無監督ワークフローを動かす前に再テストしてください。

Claude Code 2.1.183 ソース確認

Claude Code 2.1.183 は、要求されていない破壊的な git コマンドやインフラ破壊コマンドをブロックして auto-mode の安全性を強化し、要求モデルが deprecated または自動更新対象のときに警告を出し、commit と PR attribution 用の attribution.sessionUrl 設定を追加し、scheduled task と webhook trigger の分類を修正して pending action を承認できないようにし、headless および SDK モードでの MCP auth-stub tool 露出を修正しました。Allowlisted な Claude Code Action も、同梱の Claude Code と Agent SDK の既定値を 2.1.183 / 0.3.183 に更新しました。法務リポジトリでは、destructive-command review gates、webhook と scheduled-task の approval boundaries、model-retirement warnings、PR attribution policy、MCP authentication exposure、version pins を、client-data フォルダで無監督ワークフローを動かす前に再テストしてください。

Claude Action の PR review フィルタリング

2026 年 6 月の allowlisted Claude Code Action commit により、pull-request reviews と inline review comments が authorized trigger time に合わせて filter され、既存の issue/PR comments と bodies の trigger-time filtering に揃いました。法務向け legal PR agents では、この fix を含む version を pin し、trigger 後に追加された review threads は信頼できない参照コンテキストとして扱い、checkout credentials を non-persistent に保ち、agent-authored changes が client-data repositories に届く前に human merge review を必須にしてください。

学習目標

このチュートリアルを終えると、次のことができるようになります：

  • Claude Code のアーキテクチャ（Skills、Hooks、Sub-agents）を理解
  • 事務所のワークフロー用カスタム法務スキルを構築
  • 品質管理とコンプライアンスのためのフックを作成
  • 複雑な法務タスクのためのマルチエージェントシステムをデプロイ

Part 1：Claude Code スタックの理解

アーキテクチャ

Skills：コンテキストに基づいて Claude が読み取るファイルに格納された専門指示とベストプラクティス。

Hooks：Claude の実行ライフサイクルの特定のポイントで実行されるスクリプト。

Sub-agents：特定のサブタスクを処理するために起動される自律エージェント。

MCP Servers：外部ツール接続（チュートリアル 07）。

Plugins：Skills + Hooks + MCP のパッケージバンドル。

法務への応用

コンポーネント法務応用
Skillsプレイブック、レビュー手順、作成基準をエンコード
Hooksコンプライアンスの強制、不正アクションの防止、監査ログ
Sub-agents文書レビュー、調査タスクの並列化
Plugins事務所ワークフローの配布用パッケージ

Part 2：カスタム法務スキルの構築

Skills とは？

Skills は、コンテキストに基づいて Claude が読み取るファイルに格納された専門指示です。プロンプト（1回限り）とは異なり、Skills は永続し、自動的にアクティブ化されます。

Skill ファイル構造

your-skill/
├── SKILL.md          # メイン指示（必須）
├── examples/         # 入出力例
├── templates/       # 文書テンプレート
└── resources/       # 参照資料

契約レビュースキルの作成

ステップ 1：Skill ディレクトリを作成（コマンドは英語セクション参照）。

ステップ 2：Purpose、Activation、Instructions、Output format で SKILL.md を記述。

ステップ 3：examples/ に good/bad 例を追加。

Part 3：品質とコンプライアンスのためのフック

フックはアクションの前/後に実行されます。用途：送信前の出力検証、不正アクションのブロック、機密データアクセスのログ記録。

本番運用メモ： フックはワークフローをブロックまたは変更できます。クライアント案件や特権文書に使う前に、実際の権限、effort レベル、MCP サーバーでサンドボックステストしてください。

フックとは？

PreToolUse、PostToolUse、SessionStart、UserPromptSubmit、Stop の各ポイントで実行されるスクリプト。表は英語セクション参照。

法務コンプライアンスフックの例

特権フォルダへの不正変更を防止。コードは英語セクション参照。

その他のフックユースケース

引用検証、機密性チェック。例は英語セクション参照。

Part 4：マルチエージェント法務ワークフロー

サブエージェントの理解

Claude は特定タスク用のサブエージェントを起動可能：並列化（複数文書の同時レビュー）、専門化（専用エージェント）、分離（別コンテキスト）。

例：並列デューデリジェンスレビュー

複数エージェントを並列実行（顧客契約、IP、雇用、訴訟）。コードは英語セクション参照。

例：リサーチ＋ドラフトワークフロー

リサーチエージェント→ドラフトエージェント→レビューエージェント。フローは英語セクション参照。

Part 5：Skills のプラグイン化

プラグイン構造

plugin.json、SKILL.md、.mcp.json、hooks/、commands/、resources/ を含むディレクトリ。完全な構造は英語セクション参照。

プラグインマニフェスト

マニフェストの形式・スキーマは進化します。公式プラグインリファレンスを参照してください。

インストールと配布

claude --plugin-dir、claude plugin install、claude plugin enable。コマンドは英語セクション参照。

Part 6：セキュリティ考慮事項

Skill セキュリティ

ソース検証、フックコードのレビュー、スキルファイルにクライアントデータを含めない、アクセス制御。

データ保護

UserPromptSubmit フックでサニタイズ。例は英語セクション参照。

コンプライアンス要件

  • IT セキュリティによる Skills レビュー
  • サンドボックスでのフックテスト
  • 監査ログ有効化
  • クライアントデータ分離の検証

今すぐ実行

  • 事務所のレビュープロセスのカスタムスキルを作成
  • コンプライアンスまたは監査用のセーフティチェック（フック）を少なくとも1つ追加
  • 並列文書処理のマルチエージェントワークフローをテスト
  • チームが使えるようスキルを文書化
  • 配布用プラグイン化を検討

関連ファミリーページ

ナビゲーション

Quick Reference: Claude Code Commands

Official Claude Code terminal screenshot showing Claude running in a command-line workflow

Official Claude screenshot from Claude Code. Terminal workflows should be paired with scoped folders, explicit permission modes, and a reviewable diff before legal workflow changes are accepted.

# Skills (filesystem locations)
~/.claude/skills/           # Personal custom skills
.claude/skills/             # Project custom skills
 
# Hooks
/hooks                      # Open hooks manager in Claude Code
 
# Plugin hooks
${CLAUDE_PLUGIN_ROOT}/hooks/hooks.json
 
# Debugging
claude --help

Sources

Additional Reading

On this page

1 What You'll Learn2 学習目標3 Part 1：Claude Code スタックの理解3.1 アーキテクチャ3.2 法務への応用4 Part 2：カスタム法務スキルの構築4.1 Skills とは？4.2 Skill ファイル構造4.3 契約レビュースキルの作成5 Part 3：品質とコンプライアンスのためのフック5.1 フックとは？5.2 法務コンプライアンスフックの例5.3 その他のフックユースケース6 Part 4：マルチエージェント法務ワークフロー6.1 サブエージェントの理解6.2 例：並列デューデリジェンスレビュー6.3 例：リサーチ＋ドラフトワークフロー7 Part 5：Skills のプラグイン化7.1 プラグイン構造7.2 プラグインマニフェスト7.3 インストールと配布8 Part 6：セキュリティ考慮事項8.1 Skill セキュリティ8.2 データ保護8.3 コンプライアンス要件9 今すぐ実行10 関連ファミリーページ11 ナビゲーション12 Quick Reference: Claude Code Commands13 Sources14 Additional Reading