Summon CLI は何をしますか？
目標
現在のリクエストを完全な形で、設定済みの外部Agent CLIに渡します。外部AgentはClaude Code、Grok CLI、Gemini CLI、Codex CLI、または今後追加されるAgentでありえます。API、モデル、フォアグラウンド/バックグラウンドプロトコル、起動パラメータ、目標Skillはすべて本スキル内の設定で決定され、動作説明にハードコードされません。
ユーザーが明示的に $summon-cli を呼び出した場合に本スキルが使用されます。現在、執筆自動ルートも設定されています。Codexがユーザーのショートポスト、記事、プロジェクト紹介、その他の公開可能なテキスト作成を検出した場合、writing タスク設定を読み込んで委任します。この自動ルートはローカルの AGENTS.md によって許可されており、本スキルが存在するという理由だけで他のタスクが自動的に委任されることはありません。
動作方法
初回使用時、または本スキルを別のマシンにコピーした後は、まず本スキルのディレクトリでローカル検出を実行します。
& '<本スキルディレクトリ>\scripts\summon.ps1' setup
macOS、Linux、WSL の場合は次を使用します。
sh '<本スキルディレクトリ>/scripts/summon.sh' setup
setup は現在のシステム上の Python、Agent CLI、Skill、グラフィカルターミナルのみを検出し、絶対パスを本スキル内のGitで無視される config/config.local.json に書き込みます。ソフトウェアのインストール、キーの移動、パブリック設定の変更は行いません。その後、show と doctor を実行して結果を確認します。
ユーザーが指定したタスク、プロファイル、Skillに基づいて設定を選択します。ユーザーが指定しない場合は、タスクの説明に基づいて設定済みのルートを選択します。タスクはSkillを使用しないか、1つのSkillを使用することができ、1回の呼び出しで外部Agentに複数のSkillを渡すことはできません。タスクがSkillを要求しているが、ユーザーもデフォルト設定も選択していない場合は、まずユーザーに今回使用するSkillを尋ねます。推測は行わず、候補を同時に呼び出すこともありません。
Codex によるウェブ補足
タスク設定の codex_web が supplement の場合、現在のCodexが呼び出し前の公開情報発見を担当します。まず、既存のリクエスト、ユーザー素材、ローカルオブジェクトを完全に読み取り、今回のタスク完了に公開情報が不足しているかどうかを判断します。既存の内容で十分な場合はそのまま引き継ぎ、本当に不足がある場合にのみインターネットに接続します。実際に使用するWebページの関連原文または必要なコンテキストを、ソースリンクとともに引き継ぎ情報に含めます。素材の身元は保持され、Codexが抽出した中心文、推奨アングル、ナラティブ説明、事前作成コンテンツは追加されません。
Codexが既存の内容または今回の補足で十分と判断した時点で、公開情報の発見は終了します。外部Agentは検索を繰り返さず、ユーザーの今回の要求に従って目標Skillの現在のフェーズを実行します。ユーザーがアウトラインを先に納品し、確認後に本文を書くよう要求した場合、今回はアウトラインフェーズのみを実行し、事例、フック、本文、チェック、修正を事前に準備しません。現在のフェーズの完了に必要な公開情報が依然として不足している場合にのみ、不足している具体的な材料を外部Agentが見つけるために渡します。ウェブ補足は素材の補完にのみ使用され、ユーザーコンテンツの項目ごとの確認やファクトチェックレポートの生成は行いません。
ユーザーがインターネット接続を明示的に禁止した場合、または既存の素材のみを使用するよう要求した場合、ウェブ補足はスキップされます。その他のタスクは、自身の設定で明示的に有効にされている場合にのみ、Codexが公開情報発見を処理します。
外部Agentへの引き渡し
外部Agentに渡されるのは、現在も実行が必要なユーザーの元の言葉と実際の素材であり、修正履歴全体ではありません。後続のユーザーメッセージが以前の方向性を修正した場合、無効になった要求、アングル、アシスタント成果物は直接取り除かれます。残りのユーザーの元の言葉、ソース本文、順序、ソースの身元は変更されません。現在の意図が複数のメッセージに分散している場合、依然として有効で、かつ外部Agentによる実行が依然として必要なユーザーの元の文のみが選択され、Codexがブリーフ、要約、中心文、ナラティブフレームワークに書き換えることはありません。
呼び出し入力には以下のみが含まれます。
- 現在も外部Agentによる実行が必要なユーザーの元の言葉とソース素材
- 今回実際に使用されるCodexのウェブ補足素材とリンク
- 必要な実行引き継ぎ情報
執筆またはコンテンツ委任の場合、素材が現在のCodexからアクセス可能な履歴タスク、ローカルファイル、またはプロジェクト内にある場合、現在のCodexが呼び出し前に実際に必要なコンテンツを読み取り、採用した原文を引き継ぎ情報とともに送信します。「この履歴を読んで」「これらのファイルを開いて」「このプロジェクトをチェックしてから素材を取ってきて」などの、現在のCodexが既に完了した取材指示は、外部Agentの未完了タスクとして繰り返し渡されません。実際の素材でこれらの指示を置き換えることは、ユーザーの作成要求を書き換えることにはなりません。外部AgentにSummon CLIのREADME、SKILL.md、設定説明、パブリック設定、テスト、Git履歴を読ませたり、「プロジェクトを自分で探索して素材を見つけて」を引き継ぎ情報に書いたりしないでください。ユーザーが今回明示的に外部Agentに特定のプロジェクトのレビューや修正を要求した場合にのみ、そのプロジェクト内のタスクに直接関連するファイルの検査を許可します。
実行引き継ぎ情報は、公開情報発見をどのレイヤーが引き続き処理するかのみを示し、素材の完成準備が完了したことを宣言するものではありません。これは外部Agentがウェブツールを引き続き呼び出すかどうかを判断するためだけに使用され、目標Skillの作業素材、作成準備結果、成果物には含まれません。Codexの分析プロセス、失敗した原稿、修正プロセス、内部ルート判断、メンテナンス説明、ファクトチェック、アウトライン、事前作成本文は、すべて現在のタスクに残ります。
完全な入力は標準入力からランチャーに渡されます。
$input | & '<本スキルディレクトリ>\scripts\summon.ps1' run --task writing --skill content-writing --cwd '<現在のタスクディレクトリ>'
macOS、Linux、WSL では対応する summon.sh を使用します。--cwd は外部Agentが実際に開くプロジェクトディレクトリです。これが渡されない場合は、Summon CLIを呼び出した現在のディレクトリが使用されるため、特定の開発者のマシン上のフォルダに固定されることはありません。
summon.py はローカル設定から一意のプロファイルを解析し、対応するAPI環境をロードし、外部Agentに一意の目標Skill名と SKILL.md の絶対パスを明示的に渡し、そのCLI用の現在のモードで設定されたプロトコルを使用してプロセスを起動します。入力を解釈、要約、書き換えはしません。
デフォルトの実行モードは visible です。claude-code 実行機は、Windows Terminal、macOS Terminal.app、またはLinuxで検出されたグラフィカルターミナルで実際のClaude Codeインタラクティブインターフェースを起動します。-p は使用せず、Auto権限モードで開始します。最初のラウンドが完了すると、セッションレベルのStop Hookを介してClaudeの完全な応答が現在のCodexタスクに返され、Claudeウィンドウは入力ボックスに残ったままユーザーが直接質問するか、自分で閉じることができます。ユーザーが今回要求した完全な成果物は、外部Agentの最後の返信に含まれている必要があります。ユーザーが段階ごとの確認を明示的に要求した場合、現在のフェーズのみを納品し、後続のフェーズを事前に実行しません。外部Agentが完全な結果の後に非常に短い完了サマリーを追加で送信した場合、Stop Hookは今回のセッション記録から以前の完全な結果を復元します。起動前にClaude Codeの既存のユーザー設定が継承され、初回初期化と現在の作業ディレクトリの信頼状態が準備されるため、スタイル、セキュリティ説明、ディレクトリ確認ページで停止することはありません。グラフィカルデスクトップがないマシンでは、可視モードが利用できないことが明確に報告され、バックグラウンドに勝手に変更されることはありません。設定内のタスクまたはプロファイルは run_mode を background に設定でき、その場合は -p を使用してバックグラウンドで実行し、結果をキャプチャします。明示的な呼び出し時には --run-mode で一時的に上書きすることもできます。解析順序は、今回のコマンド、タスク設定、プロファイル設定、グローバルデフォルト値です。
明示的な呼び出し時には --profile でタスクのデフォルトプロファイルをバイパスしたり、--skill でタスクのデフォルトSkillを上書きしたりできます。上書きは今回の呼び出しにのみ影響し、長期設定は変更しません。
外部CLIが成功結果を返した場合、その結果が完全に納品されます。呼び出しが失敗した場合は、実際の終了コード、標準出力、エラー出力が返されます。Agent、API、Skillの交換は行われず、Codexによる代替結果の生成も行われません。
リソース
scripts/summon.py：クロスプラットフォームコアプログラム。設定を読み取り、タスクと一意のSkillを解析し、プロファイル環境をロードし、外部Agent CLIを起動します。scripts/summon.ps1、scripts/summon.sh：それぞれWindows用とmacOS/Linux/WSL用のポータブルエントリポイント。config/config.json：スキルとともに移行可能なパブリック実行プロトコル、プロファイル、タスク、Skill名。ローカルの絶対パスは保存しません。config/config.local.json：setupによって生成されるローカルCLI、Skill、ターミナルパス。ファイルは本スキル内にあり、.gitignoreによって除外されます。config/profiles/*.env：対応するプロファイルのAPI環境。ファイルは他の設定とともに本スキル内に配置され、.gitignoreによって除外されます。references/configuration.md：設定および新しい実行機、プロファイル、タスク、Skillの追加方法について説明します。
出力と完了
デフォルトでは、外部Agentの実際のインタラクティブインターフェースまたはリアルタイム実行プロセスが独立したウィンドウに表示され、その完全な本文または結果が現在のタスクに返されます。Codexバージョンは追加されません。結果の返却はユーザーがウィンドウを閉じるのを待ちません。ネイティブのインタラクティブウィンドウは最初のラウンド完了後も残り、ユーザーが表示したり質問したりできます。外部Agentがユーザーの要求に応じてファイルを生成した場合、そのファイルはユーザーが明示的に指定した目標プロジェクトに属します。可視モードで最初のラウンドの引き継ぎに使用された一時ファイルは、結果返却後すぐにクリーンアップされます。ランチャーはプロンプト、本文、実行ログを保存しません。Claude Code自体は通常のメカニズムに従って復元可能なインタラクティブセッションを引き続き保存します。
外部Agentが実際に成功結果を返した場合にのみ、委任が完了したと見なされます。設定が解析可能であること、実行可能ファイルが存在すること、コマンドが起動できることは、それぞれ対応するレベルのみを証明します。APIキー、目標Skill、または互換性のある非インタラクティブプロトコルが不足している場合は、不足している項目を正確に説明し、停止します。