how

方法

太字またはバッククォートで示されたスキル名、あるいは /<name> として実行されるスキルは、このスキルのディレクトリの隣にある ../<name>/SKILL.md ファイルです。プレフィックスなしで示された原則名は、../principle-<name>/SKILL.md ファイルです。そのファイルを読み、従ってください。pstack スキルのほとんどはユーザー専用のため、スキルツールでは読み込めません。すべての delegate_task 呼び出しには、../poteto-mode/SKILL.md の Subagents セクションにあるデフォルト設定が適用されます。

「X はどのように動作しますか？」という質問に答えるため、コードベースを調査してください。サブシステムに新しく参加するシニアエンジニア向けに、実用的なメンタルモデルを構築できるだけの、アーキテクチャに関する説明を作成してください。注釈付きソースコードのように読めるほど詳細にはしないでください。

以下で起動する各プロセスは、mode: "async" の delegate_task 子プロセスです。調査担当者のタイトルは how explorer: <angle> とし、~/.config/pstack/pstack-models.md の how explorer 行を使用します。説明担当者のタイトルはすべて how explainer: <question> とし、how explainer 行を使用します。<providerInstanceId>/<model> (<effort>) というエントリは、target: {"providerInstanceId": ..., "model": ..., "options": {"<effort option id>": "<effort>"}} に変換します。effort option id は、そのモデルについて orchestrator_capabilities が一覧表示するものです。値が auto または inherit-parent の場合、あるいはファイルまたは行が存在しない場合は、target を省略してください。すると、子プロセスは親スレッドのモデルで実行されます。ファイルがない場合は、その旨を伝え、/setup-pstack を提案してください。delegate_task がエントリを拒否した場合は、同じプロバイダーのモデルのうち、orchestrator_capabilities に一覧表示されている最も近いものを使用し、その旨を伝えてください。Subagents セクションに従い、各サブエージェントのタスクに応じた推論レベルと高速または標準の速度を選んでください。子プロセスに渡されるのは依頼内容のみなので、依頼内容には必要事項を埋めたプロンプトテンプレートを含め、読み取り専用であること（調査のみ、書き込みや git コマンドは禁止）を明記してください。起動後はそのターンを終了し、完了通知を待ってください。

1. 複雑さを評価する

対象範囲が曖昧な場合は、解釈を示して調査してください。ユーザーは後から修正できます。

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

判断に迷う場合は、シンプルな方法を選んでください。

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

質問を 2～4 個の観点に分解し、それぞれをサブシステムの異なる側面にします。references/explorer-prompt.md に各観点を記入して、すべての調査担当者を同じターン内で起動します。

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

すべての調査担当者から結果が返ってきたら、references/explainer-prompt.md に各調査結果をすべて記入し、説明担当者を 1 人起動します。

4. 提示する

説明担当者の出力を提示します。明確さや会話の文脈に合わせた軽微な編集はかまいません。大幅に書き換えないでください。

出力形式

説明では references/explainer-prompt.md で定義されたセクションを使用し、該当しないセクションは省略します：Overview、Key Concepts、How It Works、Where Things Live、Gotchas。