SECTION

拡張 — スキル・フック・MCP・プラグイン

Claude Code の機能を広げる 4 つの拡張ポイント (スキル、フック、MCP、プラグイン) — エージェンティックハーネスを組み立てる素材を概念中心に整理します。

Claude Code スキル (SKILL.md) の概念と Progressive Disclosure の動作方式を整理した概要ドキュメントです。

Claude Code のライフサイクルイベントに反応して自動実行されるシェルスクリプト、フック (hook) の概念と主要イベントを整理します。

MCP(Model Context Protocol)で外部ツールとデータを Claude Code につなぐ概念、サーバー登録とスコープ、遅延ロード(Tool Search)、そして MoAI-ADK の MCP 運用方針を概念中心にまとめます。

プラグインとマーケットプレイス

Claude Code プラグインがコマンド・エージェント・スキル・hook・MCP を 1 つのパッケージに束ねて配布する方式と、マーケットプレイスで発見・インストール・管理する流れを説明します。

このグループは、Claude Code の基本機能を超えて動作を拡張する 4 つの方法を扱います。スキルで専門知識をモジュール化し、フックでイベントに自動化を仕掛け、MCP で外部ツールを接続し、プラグインでそれらすべてを 1 つのパッケージとして配布する流れを、概念中心に説明します。

背景リファレンス
このページは、MoAI-ADK が動作する基盤である Claude Code そのもの を解説する背景資料です。MoAI-ADK 自体の機能は、サイドバーの上位セクションで扱います。

この 4 つこそが エージェンティックハーネス (Agentic Harness) を組み立てる素材です。コードを直接書く代わりにエージェントがうまく働ける環境を設計するというハーネスエンジニアリングにおいて、スキルはエージェントの知識を、フックは決定論的な規律を、MCP は外部世界との接続を、プラグインはその組み合わせの配布単位を担います。MoAI-ADK が moai init 一発で配布するものも、/moai project がプロジェクト専用に生成するものも、結局はこれらの素材の組み合わせです。

情報
ひとことで言うと: スキル・フック・MCP・プラグインという 4 つの拡張ポイントを理解すれば、Claude Code をプロジェクト固有のハーネスに仕立てられます。

たとえで理解する
4 つの拡張ポイントは、こう描いておくと混乱しません。フックは人が近づくと自動で開く 自動ドアのセンサー — 特定のイベントが起きると決められた動作が自動で反応します。スキルは必要なときだけ取り出して読む マニュアル — 普段は表紙 (説明 1 行) だけが見え、その仕事が来たら本文を開きます。MCP は外部ツールを差し込む 標準コンセント、プラグインはこの 3 つを 1 つの箱に収めて配布する パッケージです。

学習の流れ

flowchart TD
    A[スキル
専門知識モジュール] --> B[フック Hooks
イベント駆動の自動化]
    B --> C[MCP サーバー
外部ツール接続]
    C --> D[プラグインとマーケットプレイス
拡張パッケージの配布]

最も軽量な拡張ポイントであるスキルから始め、自動化を仕掛けるフック、外部世界とつなぐ MCP、最後にそれらを束ねて配布するプラグインの順で読むことを推奨します。スキル・フック・MCP は MoAI-ADK の応用ドキュメントへ深くつながっているので、概念をつかんでからさらに掘り下げるとよいでしょう。

ドキュメント	説明
スキル	専門知識モジュールと段階的開示
フック (Hooks)	イベント駆動の自動化
MCP サーバー	外部ツール接続プロトコル
プラグインとマーケットプレイス	拡張パッケージとコードインテリジェンス