Codex互換性に関する注記:

Codexでリポジトリスキルを呼び出す際は $skill-name を使用してください。このミラーコピーはレガシーClaudeの /skill-name 参照を書き直します。

このCodexミラーでの計画ガイダンスには plan-hard スキルを優先してください。

タスクトラッカー義務: ワークフローやスキルステップを実行する前に、すべてのステップのタスク追跡を作成・更新し、進捗の変化に応じて同期状態に保ってください。

ユーザー質問プロンプトは、Codexでユーザーに直接質問することを想定しています。

Claude固有のモード切り替え指示が表示される場合は無視してください。

厳密な実行契約: ユーザーがスキルを明示的に呼び出した場合、そのスキルプロトコルを記載通りに実行してください。

サブエージェント認可: スキルがユーザー呼び出しまたはAI検出され、そのプロトコルがサブエージェントを必要とする場合、そのスキル有効化は当該タスク用の必要な spawn_agent サブエージェントの使用を認可します。

ユーザーが明示的に偏差を承認した場合を除き、プロトコルステップをスキップ、並べ替え、または統合しないでください。

ワークフロースキルの場合、リストされた各子スキルステップを明示的に実行し、ステップごとの証拠をレポートしてください。

必要なステップ/ツールがこの環境で実行できない場合は、適応する前に停止してユーザーに確認してください。

Codexプロジェクト参照読み込み（フック未使用）

Codexはclaudeフックベースのドキュメント注入を受け取りません。コーディング、計画、デバッグ、テスト、またはレビュー時に、このルーティングを使用してプロジェクトドキュメントを明示的に開いてください。

常に読む:

docs/project-config.json (プロジェクト固有のパス、コマンド、モジュール、ワークフロー/テスト設定)
docs/project-reference/docs-index-reference.md (完全な docs/project-reference/* カタログへのルート)
docs/project-reference/lessons.md (常に有効なガードレールとアンチパターン)

状況別ドキュメント:

バックエンド/CQRS/API/ドメイン/エンティティの変更: backend-patterns-reference.md、domain-entities-reference.md、project-structure-reference.md
フロントエンド/UI/スタイリング/デザインシステム: frontend-patterns-reference.md、scss-styling-guide.md、design-system/README.md
仕様/テストケース計画またはTCマッピング: feature-docs-reference.md
統合テスト実装/レビュー: integration-test-reference.md
E2Eテスト実装/レビュー: e2e-test-reference.md
コードレビュー/監査作業: code-review-rules.md および変更されたファイルに基づくドメインドキュメント

すべてのドキュメントを盲目的に読まないでください。docs-index-reference.md から始めて、タスクに関連するファイルのみを開いてください。

クイックサマリー

目的: メインコンテキストを汚さずに、構成されたサーバーからMCPツール/プロンプト/リソースを検出、分析、および実行します。

ワークフロー:

構成管理 — .claude/.mcp.json を使用、Gemini CLIの場合は .gemini/settings.json へのシンボリックリンク
機能検出 — npx tsx scripts/cli.ts list-tools は assets/tools.json に保存
インテリジェント選択 — LLMが tools.json を分析し、タスク関連の機能を選択
実行 — 優先順位: Gemini CLIと標準入力パイピング。副次: ダイレクトスクリプト。フォールバック: 汎用サブエージェント

主要ルール:

Gemini CLI優先: 標準入力パイピング (echo "task" | gemini) を使用してください。-p フラグは使用しないでください(MCPの初期化がスキップされます)
GEMINI.md自動ロード: プロジェクトルートのファイルはGeminiからの構造化JSON応答を強制します
段階的な開示: 必要な機能のみロード。サブエージェントが検出を処理
永続的なカタログ: list-toolsは完全なスキーマを assets/tools.json に保存し、高速参照を実現

懐疑的でいてください。批判的思考、段階的思考を適用してください。すべての主張は証拠をトレースが必要であり、信頼度は80%以上である必要があります。

MCP管理

Model Context Protocol(MCP)サーバーを管理およびやり取りするスキル。

前提条件

⚠️ 重要必ず確認 実行前に references/configuration.md と references/gemini-cli-integration.md を読んでください。MCPサーバー構成形式、Gemini CLIセットアップ、実行パターン、およびコア機能と実装パターンセクションで必要なトラブルシューティングが含まれています。プロトコルの内部については、⚠️ 重要必ず確認 references/mcp-protocol.md も参照してください。

概要

MCPはAIエージェントが外部ツールやデータソースに接続できるようにするオープンプロトコルです。このスキルは、構成されたサーバーからMCP機能を検出、分析、および実行するスクリプトとユーティリティを提供し、メインコンテキストウィンドウを汚しません。

主なメリット:

MCP機能の段階的な開示(必要なもののみロード)
タスク要件に基づくインテリジェントなツール/プロンプト/リソース選択
単一の構成ファイルからの複数サーバー管理
コンテキスト効率的: サブエージェントがMCP検出と実行を処理
永続的なツールカタログ: 検出されたツールを自動的にJSONに保存し、高速参照

このスキルを使用する場合

以下の場合にこのスキルを使用してください:

MCP機能の検出: 構成されたサーバーから利用可能なツール/プロンプト/リソースをリストアップする必要がある
タスクベースのツール選択: 特定のタスクに関連するMCPツールを分析する
MCPツールの実行: MCPツールをプログラムで呼び出す(適切なパラメータ処理を使用)
MCP統合: MCPクライアント実装を構築またはデバッグする
コンテキスト管理: MCP操作をサブエージェントに委任することでコンテキスト汚染を回避

コア機能

1. 構成管理

MCPサーバーは .claude/.mcp.json に構成されます。

Gemini CLI統合(推奨): .gemini/settings.json へのシンボリックリンクを作成してください:

mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json

references/configuration.md と references/gemini-cli-integration.md を参照してください。

GEMINI.md応答形式: プロジェクトルートに GEMINI.md が含まれており、Gemini CLIが自動的にロードして、構造化JSON応答を強制します:

{"server":"name","tool":"name","success":true,"result":<data>,"error":null}

これにより、予測不可能な自然言語の代わりに解析可能で一貫性のある出力が保証されます。ファイルは以下を定義します:

必須のJSON専用応答形式(マークダウンや説明なし)
最大500文字の応答
エラーハンドリング構造
利用可能なMCPサーバーリファレンス

メリット: プログラムで解析可能な出力、一貫性のあるエラーレポート、DRY構成(形式は一度だけ定義)、コンテキスト効率的(Gemini CLIによって自動ロード)。

2. 機能検出

npx tsx scripts/cli.ts list-tools  # assets/tools.json に保存
npx tsx scripts/cli.ts list-prompts
npx tsx scripts/cli.ts list-resources

複数のサーバーからサーバー識別を含めて機能を集約します。

3. インテリジェントなツール分析

LLMが assets/tools.json を直接分析します。キーワードマッチングアルゴリズムより優れています。

4. ツール実行

優先順位: Gemini CLI(利用可能な場合)

# 重要: 標準入力パイピングを使用してください。-p フラグは使用しないでください(非推奨、MCPの初期化がスキップされます)
echo "Take a screenshot of https://example.com" | gemini -y -m gemini-2.5-flash

副次: ダイレクトスクリプト

npx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'

フォールバック: 汎用サブエージェント

references/gemini-cli-integration.md の完全な例を参照してください。

実装パターン

パターン1: Gemini CLI自動実行(優先順位)

Gemini CLIを使用して、自動ツール検出と実行を行ってください。Gemini CLIはプロジェクトルートから GEMINI.md を自動的にロードして、構造化JSON応答を強制します。

クイック例:

# 重要: 標準入力パイピングを使用してください。-p フラグは使用しないでください(非推奨、MCPの初期化がスキップされます)
# 構造化出力を強制するために "Return JSON only per GEMINI.md instructions" を追加してください
echo "Take a screenshot of https://example.com. Return JSON only per GEMINI.md instructions." | gemini -y -m gemini-2.5-flash

予想される出力:

{ "server": "puppeteer", "tool": "screenshot", "success": true, "result": "screenshot.png", "error": null }

メリット:

自動ツール検出
構造化JSON応答(Claudeによって解析可能)
GEMINI.md自動ロードで一貫性のある形式設定
サブエージェントオーケストレーションより高速
自然言語の曖昧さなし

references/gemini-cli-integration.md の完全なガイドを参照してください。

パターン2: サブエージェントベースの実行(フォールバック)

Gemini CLIが利用不可の場合は general-purpose エージェントを使用してください。サブエージェントがツールを検出し、関連するものを選択し、タスクを実行し、結果をレポートバックします。

メリット: メインコンテキストは清潔に保たれ、必要なときのみ関連するツール定義がロードされます。

パターン3: LLM駆動のツール選択

LLMが assets/tools.json を読み、コンテキスト理解、同義語、意図認識を使用してインテリジェントにツールを選択します。

パターン4: マルチサーバーオーケストレーション

複数のサーバー間でツールを調整します。各ツールは適切なルーティング用に送信元サーバーを認識しています。

スクリプトリファレンス

scripts/mcp-client.ts

コアMCPクライアント管理クラス。以下を処理します:

.claude/.mcp.json からの構成ロード
複数のMCPサーバーへの接続
すべてのサーバー間でのツール/プロンプト/リソースのリスト表示
適切なエラーハンドリングを使用したツール実行
接続ライフサイクル管理

scripts/cli.ts

MCP操作用のコマンドラインインターフェース。コマンド:

list-tools - すべてのツールを表示し、assets/tools.json に保存
list-prompts - すべてのプロンプトを表示
list-resources - すべてのリソースを表示
call-tool <server> <tool> <json> - ツールを実行

注: list-tools は完全なツールカタログを、完全なスキーマを含めて assets/tools.json に永続化し、高速参照、オフラインブラウジング、バージョン管理を実現します。

クイックスタート

方法1: Gemini CLI(推奨)

npm install -g gemini-cli
mkdir -p .gemini && ln -sf .claude/.mcp.json .gemini/settings.json
# 重要: 標準入力パイピングを使用してください。-p フラグは使用しないでください(非推奨、MCPの初期化がスキップされます)
# GEMINI.md自動ロードでJSON応答を強制します
echo "Take a screenshot of https://example.com. Return JSON only per GEMINI.md instructions." | gemini -y -m gemini-2.5-flash

構造化JSON を返します: {"server":"puppeteer","tool":"screenshot","success":true,"result":"screenshot.png","error":null}

方法2: スクリプト

cd .claude/skills/mcp-management/scripts && npm install
npx tsx cli.ts list-tools  # assets/tools.json に保存
npx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'

方法3: 汎用サブエージェント

references/gemini-cli-integration.md の完全なガイドを参照してください。

技術詳細

references/mcp-protocol.md を参照して以下を確認してください:

JSON-RPCプロトコルの詳細
メッセージタイプと形式
エラーコードとハンドリング
トランスポート機構(stdio、HTTP+SSE)
ベストプラクティス

統合戦略

実行優先順位

Gemini CLI(優先順位): 高速、自動、インテリジェントなツール選択
- 確認: command -v gemini
- 実行: echo "<task>" | gemini -y -m gemini-2.5-flash
- 重要: 標準入力パイピングを使用してください。-p フラグは使用しないでください(非推奨、MCPの初期化がスキップされます)
- 最適: 利用可能な場合はすべてのタスク
ダイレクトCLIスクリプト(副次): 手動ツール指定
- 使用場面: 特定のツール/サーバーコントロールが必要な場合
- 実行: npx tsx scripts/cli.ts call-tool <server> <tool> <args>
汎用サブエージェント(フォールバック): コンテキスト効率的な委任
- 使用場面: Geminiが利用不可またはに失敗した場合
- メインコンテキストを清潔に保つ

エージェント統合

general-purpose エージェントはこのスキルを使用して:

最初にGemini CLIの利用可能性をチェック
利用可能な場合は gemini コマンド経由で実行
ダイレクトスクリプト実行にフォールバック
メインコンテキストにロードせずにMCP機能を検出
メインエージェントに結果をレポート

これにより、メインエージェントコンテキストを清潔に保ち、効率的なMCP統合が有効になります。

関連スキル

mcp-builder
claude-code

[重要] タスク追跡を使用して、開始前にすべての作業を小さなタスクに分割してください(各ファイル読み込み用タスクを含む)。これは長いファイルからのコンテキスト損失を防ぎます。簡単なタスクについては、AIはユーザーにスキップするかどうかを必ず確認してください。

AI間違い防止 — すべてのタスクで避けるべき失敗モード: 削除前に下流参照をチェックしてください。 コンポーネント削除はドキュメントとコード陳腐化のカスケードを引き起こします。削除前にすべての参照ファイルをマップしてください。 AI生成コンテンツを実際のコードと照合してください。 AIはAPI、クラス名、メソッド署名を幻覚します。ドキュメント化または参照する前に、必ずgrepで存在を確認してください。 編集後の依存チェーン全体をトレースしてください。 定義の変更は、それから派生する下流変数とコンシューマーを見逃します。常にチェーン全体をトレースしてください。 正確性を確認するときはすべてのコードパスをトレースしてください。 コード存在の確認は実行の確認ではありません。常に早期終了、エラーブランチ、条件付きスキップをトレースしてください。幸せパスだけではありません。 デバッグ時は「誰の責任?」と聞いてください。 呼び出し側(データ不正)または呼び出し先(処理不正)で不具合かをトレースしてください。責任層で修正してください。症状サイトにパッチを当てることは決してしないでください。 既存値は意図的であると仮定してください。変更前に理由を聞いてください。 定数、制限、フラグ、またはパターンを変更する前に: コメントを読み、git blameを確認し、周囲のコードを調査してください。 最初の出力だけでなく、すべての影響を受ける出力を検証してください。 複数のスタックに触れる変更にはすべての出力の検証が必要です。1つの緑チェックはすべての緑チェックではありません。 全体的なデバッグ — 最も近い注意の罠に抵抗してください。 不具合を調査するときは、最初にすべての前提条件をリストします(構成、環境変数、DB名、エンドポイント、DI登録、データ前提条件)。その後、コード層の仮説を形成する前に各々を証拠に対して検証してください。 外科的変更 — diffテストを適用してください。 バグ修正: 変更された各行は直接不具合にトレースされる必要があります。隣接するコードをリースタイルしたり改善したりしないでください。拡張タスク: 改善を実装し、明示的に発表してください。 コーディング前に曖昧さを表面化してください。 リクエストに複数の解釈がある場合は、それぞれ努力見積もりを含めて提示し、確認してください。すべてのレコード、ファイルベース、またはより複雑なパスを静かに選択しないでください。

批判的思考マインドセット — 批判的思考、段階的思考を適用してください。すべての主張は証拠をトレースが必要であり、信頼度は80%以上である必要があります。 幻覚防止: 推測を事実として提示しないでください。すべての主張にソースを引用し、不確実さを自由に認め、出力の自己チェックエラー、独立した相互参照、自身の確実性に懐疑的 — 証拠ルートなしの確実性はすべての幻覚のルート。

重要必ず実施 批判的思考を適用してください。すべての主張は証拠をトレースが必要であり、信頼度は80%以上である必要があります。幻覚防止: 推測を事実として提示しないでください。

重要必ず実施 AI間違い防止を適用してください。全体的デバッグ、責任層で修正、コーディング前に曖昧さを表面化、圧縮後にファイルを再度読み込んでください。

終わりに

重要必ず実施 タスク追跡を使用して、開始前にすべての作業を小さなtodoタスクに分割してください 重要必ず実施 新しいコードを作成する前に、3つ以上の類似パターンを検索してください 重要必ず実施 すべての主張について file:line 証拠を引用してください(信頼度 > 80%で行動) 重要必ず実施 最終的なレビューtodoタスクを追加して、仕事の品質を検証してください 必須重要必ず実施 開始前に次のファイルを読んでください: 重要必ず実施 開始前に references/configuration.md を読んでください 重要必ず実施 開始前に references/mcp-protocol.md を読んでください

[タスク計画] 行動する前に、タスク追跡を使用してタスク範囲を分析し、小さなtodoタスクと部分タスクに体系的に分割してください。

フックレスプロンプトプロトコルミラー(自動同期)

ソース: .claude/hooks/lib/prompt-injections.cjs + .claude/.ck.json

[ワークフロー実行プロトコル] [ブロッキング] ワークフロー実行プロトコル — 必須重要必ず重大。理由を問わずスキップしないでください。

検出: プロンプトをワークフローカタログと照合
分析: ベストマッチワークフローを見つけ、カスタムステップの組み合わせがより適切かどうかを評価
質問(必須形式): この構造で直接ユーザー質問を使用してください:
- 質問: 「どのワークフローを有効化したいですか?」
- オプション1: 「[ベストマッチワークフロー] を有効化 (推奨)」
- オプション2: 「カスタムワークフロー: [step1 → step2 → ...]」を有効化 (1行の理由を含める)
有効化(確認時): 標準の場合は $workflow-start <workflowId> を呼び出し。カスタムステップは手動でシーケンス
タスク作成: すべてのワークフローステップのタスク追跡
実行: 各ステップをシーケンスで実行 [批判的思考マインドセット] 批判的思考、段階的思考を適用してください。すべての主張は証拠をトレースが必要であり、信頼度は80%以上である必要があります。幻覚防止原則: 推測を事実として提示しないでください。すべての主張にソースを引用し、不確実さを自由に認め、出力のエラーを自己チェック、独立して相互参照、自身の確実性に懐疑的 — 証拠ルートなしの確実性はすべての幻覚のルート。 AI注意原則(優先度-新近性): 長いプロンプト/プロトコルの上下の両方に3つの最も重要なルールを置いて、長いコンテキストウィンドウで指示順守が続くようにしてください。

学習レッスン

[重大] 苦労して得たプロジェクトデバッグ/アーキテクチャルール。仮説を形成またはコードを書く前に重要必ず実施適用してください。

クイックサマリー

目的: 既知の失敗パターンの再発生を防止 — デバッグ、アーキテクチャ、命名、AI オーケストレーション、環境。

トップルール(常に適用):

重要必ず実施コード層の仮説を形成する前にすべての前提条件(構成、環境、DB名、DI登録)を検証
重要必ず実施責任層で修正 — 症状サイトに呼び出し側固有の防御コードをパッチアップするべきではありません
重要必ず実施並列非同期 + repo/UoW には ExecuteInjectScopedAsync を使用 — ExecuteUowTask は使用しません
重要必ず実施コンテンツではなく目的で命名 — メンバー追加で強制リネーム = 破壊された抽象化
重要必ず実施サブエージェント検査結果を各ファイル後

ライセンス: Apache-2.0(寛容ライセンスのため全文を引用しています) · 原本リポジトリ

mcp-management

SKILL.md 本文

Codexプロジェクト参照読み込み（フック未使用）

クイックサマリー

MCP管理

前提条件

概要

このスキルを使用する場合

コア機能

1. 構成管理

2. 機能検出

3. インテリジェントなツール分析

4. ツール実行

実装パターン

パターン1: Gemini CLI自動実行(優先順位)

パターン2: サブエージェントベースの実行(フォールバック)

パターン3: LLM駆動のツール選択

パターン4: マルチサーバーオーケストレーション

スクリプトリファレンス

scripts/mcp-client.ts

scripts/cli.ts

クイックスタート

技術詳細

統合戦略

実行優先順位

エージェント統合

関連スキル

終わりに

フックレスプロンプトプロトコルミラー(自動同期)

[ワークフロー実行プロトコル] [ブロッキング] ワークフロー実行プロトコル — 必須重要必ず重大。理由を問わずスキップしないでください。

学習レッスン

学習レッスン

クイックサマリー

詳細情報