how

使い方

コードベースを調査して、「X はどのように動作するのか？」という質問に答えます。サブシステムに加わるシニアエンジニアが理解できるレベルで、動作するメンタルモデルを構築できるだけのアーキテクチャ解説を作成します。ただし、ソースコードに注釈を付けたような内容にはしません。

タスクの起動ごとに、subagent_type: generalPurpose かつ readonly: true の Task サブエージェントを使用します。調査担当者は pstack 設定ファイル（Cursor では ~/.cursor/rules/pstack-models.mdc、その他のハーネスでは ~/.agents/pstack-models.md）の how explorer 行を使用します（デフォルトは grok-4.7-xhigh-fast）。説明担当者は how explainer 行を使用します（デフォルトは claude-opus-5-5-xhigh）。model には、その行の値、またはファイルか行がない場合はデフォルトを設定します。値が auto または inherit-parent の場合は、model を未設定のままにします。サブエージェントツールでモデルのスラッグが拒否された場合は、デフォルトを使用し、その旨を伝えます。デフォルトも拒否された場合は、エラーメッセージまたはハーネスのモデル一覧から、同じファミリーの最も近い有効なスラッグを使用します。poteto-mode スキルの Subagents セクションに従い、タスクに応じて各サブエージェントの推論レベルと高速または標準の実行速度を選択します。

1. 複雑さを評価する

範囲が曖昧な場合は、解釈を明示して調査します。ユーザーは必要に応じて方向を修正できます。

• 単純（単一モジュール、小さなユーティリティ、「関数 X はどのように動作するのか」のような範囲の狭い質問）：調査担当者は起動しません。references/explainer-prompt.md から explorer-findings セクションを除いたプロンプトを作成し、調査と説明を一度に行う説明担当者を 1 人起動します。手順 4 に進みます。
• 複雑（複数ファイルやサービスにまたがるサブシステム、横断的な機能、アーキテクチャ全体の概要）：手順 2 に進みます。

判断に迷う場合は、単純な方を選びます。

その他のハーネス。 このスキルでは Cursor の Task ツールを使用します。別のハーネスでは、そのサブエージェントツールを使用します。Claude Code では Agent（subagent_type: general-purpose）、OpenCode では task（subagent_type: general）、Codex では spawn_agent を使用します。プロンプトとモデルはそのまま使用します。ツールにないパラメーターは省略します。Pi の拡張機能のように、ハーネスにサブエージェントツールがない場合は、各役割を順番に自分で実行します。

2. 調査する（複雑な場合のみ）

質問を 2〜4 個の観点に分解します。それぞれ、サブシステムの異なる側面を扱うようにします。各観点を埋めた references/explorer-prompt.md を使用して、すべての調査担当者を 1 回のメッセージで起動します。

3. 統合する（複雑な場合のみ）

すべての調査担当者から結果が返ってきたら、各調査結果を埋め込んだ references/explainer-prompt.md を使用して、説明担当者を 1 人起動します。

4. 提示する

説明担当者の出力を提示します。会話の文脈に合わせて、明瞭さや補足情報を軽く編集してもかまいません。大幅な書き換えはしないでください。

出力形式

説明では、references/explainer-prompt.md で定義されているセクションを使用し、該当しないものは省略します。セクションは次のとおりです：概要、主要な概念、動作の仕組み、関連ファイル、注意点。