1仕組みと動作原理

純粋なプロンプトオーケストレーション、スクリプトおよびアセットゼロ：how の SKILL.md は「分割と委任の方法」のみを規定し、コード読み込みアクションはすべてホスト Task サブエージェントに委ねられ、組み込みの2つのプロンプトテンプレート（explorer/explainer）のみを参照物とします。

pstack/skills/how/SKILL.md

Explore the codebase to answer "how does X work?" questions. Produce architectural explanations at the level of a senior engineer onboarding onto a subsystem, enough to build a working mental model, not so much that it reads like annotated source code.

位置づけは「シニアエンジニアのオンボーディング級メンタルモデル」であり、1行ごとの逐条解説的な羅列を意図的に排除しています——これが出力品質のアンカーとなります。

複雑度ルーティング：単純な質問は1パスの explainer で直接出力し、複雑な質問はまず2〜4つの視点から並列に explorer を派遣してスライス深掘りを行い、その後に explainer に集約・合成させます。判断に迷った場合はデフォルトで単純パスを選択します。

pstack/skills/how/SKILL.md

**Simple** (a single module, a small utility, a narrow question such as "how does function X work"): no explorers. One explainer explores and explains in a single pass. Go to Step 2b.

並列度は質問の実際の複雑さによって決定されます。「When in doubt, take the simple path.」により、大げさな処理や複数サブエージェントの空回りを防ぎます。

explorer はすべて読み取り専用、並列実行、1回のメッセージで一斉送信：各ルートに1つの generalPurpose サブエージェントを割り当て、model は設定値（デフォルト grok-4.6-fast-xhigh）を取得、readonly は常に true——探索層は副作用のない事実収集機として設計されています。

pstack/skills/how/SKILL.md

Decompose the question into 2 to 4 exploration angles, each a distinct slice of the subsystem. Spawn all explorers in a single message

同セクションの下部に各項目（subagent_type: generalPurpose、model: your configured how-explorer model (default `grok-4.6-fast-xhigh`)、readonly: true）が記載されており、3箇所の spawn ブロック（2a/2b/3）すべてに readonly が明記されています。

explorer の成果物は固定構造の事実契約（Components Found / Flow / Files Read / Boundaries / Non-Obvious Things / Open Questions）であり、「コード読み込みにおいて推測を禁じる」と「ブレークポイントを正直に認める」ことを厳格な要件としています。

pstack/skills/how/references/explorer-prompt.md

Start by finding the relevant code. Use Glob to find directories and files, Grep to find key symbols, Read to understand the actual implementation. Don't guess from names. Read the code.

テンプレートの末尾には「Return your findings in this structure…Reference exact file paths, function names, type names, and line numbers where relevant.」および「"I couldn't determine how X connects to Y" is better than making something up.」とあり、出力を構造化することで explainer が取り繕いのない事実をクロスチェックできるようにしています。

explainer は調停と再検証を担当：複数ルートの explorer の発見に重複や矛盾がある場合、explainer は解説を書く前に自身でコードを確認して解消し、最初から探索し直すことなく読み取り専用の再調査権限（Read/Grep/Glob）を行使します。

pstack/skills/how/references/explainer-prompt.md

Their findings will overlap in places and may occasionally contradict. Reconcile them. Merge overlapping descriptions, resolve contradictions by checking the code yourself, and combine the separate slices into a unified picture.

これは「並列スライス→統合」を2段階パイプラインにしたものです。explorer は深さを追求し、explainer は統合を追求し、矛盾はソースコードを基準に解決されます。

出力形式と提示規律：解説は固定セクション（Overview/Key Concepts/How It Works/Where Things Live/Gotchas、省略可）に従い、複雑なフローでは mermaid/ASCII 図を許可するものの装飾的な図は禁止します。フロントエンドは軽度の推敲のみを行い、大幅な書き換えは禁止します。

pstack/skills/how/SKILL.md

Present the explainer's output to the user. Light edits for clarity or context from the conversation are fine. Do not substantially rewrite it.

セクション一覧は SKILL.md の Output Format セクションに原文のまま記載されています。図の使用規則は explainer-prompt.md にあり、「Use mermaid (```mermaid) for structured flows…A diagram should clarify, not decorate.」と明記されています。

トリガー面はユーザーの明示的な呼び出しに限定され、モデルロールは設定可能：frontmatter で disable-model-invocation: true を宣言し、モデルのデフォルト値は pstack の常駐モデルルールによってオーバーライド可能です。

pstack/skills/how/SKILL.md

disable-model-invocation: true

「your configured how-explorer model」の設定ソースは pstack ファミリーの他のスキルで明示されています（setup-pstack/SKILL.md の「Write `~/.cursor/rules/pstack-models.mdc`, an always-applied rule that sets pstack's model per role.」や interrogate/SKILL.md でも同パスを参照）。how 自体はデフォルト値とフォールバックセマンティクスを宣言するのみで、ファイル書き込みは行いません。

2コア機能

01コードウォークスルー型の解説（how does X work / サブシステムアーキテクチャ / ランタイムフロー）

02配置／所有権／レイヤリングの判断（where should this live / which package owns this / is this the right layer）

03単純な質問に対する1パスでの直接回答（サブエージェント非起動）

04複雑な質問に対する2〜4系統の並列読み取り専用探索と統一的な集約・合成

05全チェーンにわたる読み取り専用規律の徹底（explorer と explainer の双方が readonly: true）

06捏造防止の検証：explorer は実際にコードを読み Files Read を列挙することが必須、explainer には矛盾解消のための独自再調査を許可

07オンデマンドな図解：mermaid（構造化フロー）または ASCII（単純な関係性）、装飾目的の図は禁止

4推奨統制措置と判定根拠

安全運用のための推奨統制措置

Agent 向け

作業ディレクトリを限定

管理者向け

操作ログを保持

判定根拠（ファイルパスと抜粋）

本地文件: ローカルプロジェクトファイルまたはワークスペース成果物の操作

監査ノート： 。接触面＝ホスト Task 配下の readonly サブエージェントによるローカルコードベースへの読み取り専用アクセス、および常駐ルール経由で注入されるローカルモデル設定（~/.cursor/rules/pstack-models.mdc、モデル名のみ、認証情報なし）。スクリプト実行なし、外部ネットワーク送信なし、認証情報読み取りなし、ローカル書き込みなし。disable-model-invocation: true によりユーザーの明示的呼び出し（/how）のみでトリガー。注意点：readonly はプロンプトレベルの制約であり、サブエージェントの読み取り範囲はホストの認可範囲に準拠します。

5二重目の独立検証

[ok] 纯 prompt、无脚本资产 — 技能目录仅 SKILL.md + references/explorer-prompt.md + references/explainer-prompt.md 三个 markdown，无 scripts/data/模板之外文件。
[ok] 复杂度路由与默认简单路径 — SKILL.md 原文 'When in doubt, take the simple path.' 存在；Simple→2b、Complex→2a→3 的流程编号自洽。
[ok] 2-4 路并行 explorer + 单一 explainer 合成 — 原文 'Decompose the question into 2 to 4 exploration angles'、'Spawn all explorers in a single message'、'synthesize their findings into one explanation' 逐字在。
[ok] readonly 贯穿 — Step 2a/2b/3 三处均列 '- `readonly`: `true`'；模板无任何写盘/执行指令。
[ok] explorer 输出契约与反编造要求 — explorer-prompt.md 含完整小节标题（Components Found 等六个）、'Don't guess from names. Read the code.'、以及 'is better than making something up' 原文。
[ok] explainer 调停矛盾 + 只读复查 — 原文 'resolve contradictions by checking the code yourself' 与 'You have read-only access to the codebase' 均在。
[ok] 输出格式/呈现纪律 — SKILL.md 列出的五章节与模板 Output Format 一致；'Light edits for clarity…do not substantially rewrite it.' 逐字存在。
[ok] 模型可配置（how-explorer/how-explainer） — how 内仅声明默认值；配置写入/读取路径在 setup-pstack（写 ~/.cursor/rules/pstack-models.mdc）与 interrogate/arena/swarm（读同文件）一致，机制真实存在；角色键 how-explorer/how-explainer 的逐键映射未在 pstack 内单点列出，属『规则文件按角色键注入』的通用机制 [INFERENCE]，已在正文限定表述。

6結論

読み取り専用委任により、「コードを読む」コストとリスクを readonly サブエージェント内に隔離。メインセッションが大量のソースコードで埋もれるのを防ぎ、出力は1つの統合された解説のみとなります。

「並列スライス→単一合成者」の2段階構造は、複雑なサブシステムに対して真の高速化と深掘りのメリットをもたらし、矛盾も多数決ではなくソースコードの再調査を基準に解決されます。

出力の契約化：固定セクション＋捏造防止＋ブレークポイントの正直な明記により、解説は読者や他のエージェントが具体的な file/function 単位で再検証可能です。

依存関係ゼロかつ書き込みゼロのため、ホストをまたいでディレクトリごと移行可能。pstack ファミリー（why/teach/poteto-mode）とは description とモデルルールを通じて自然に連携します。

最適な用途： 不慣れなコードを変更する前にメンタルモデルを構築するシナリオに最適です：サービス間／モジュール間のサブシステム立ち上げ、「このロジックがなぜこのように流れるのか」、新メンバーのオンボーディング、アーキテクチャを次のエージェントや人間に説明する場面。また、他のエンジニアリングスキルの読み取り専用探索プリミティブとしての再利用にも適しています（teach で既に採用済み）。

不向きな用途： 動機／トレードオフ／歴史的背景に関する質問には不向き（description で明確に why に委任：'Use why for motivation.'）。ドキュメント成果物を残す必要があるシナリオには不向き（回答のみで書き込みは行わないため、ディスク保存が必要なら teach やドキュメント作成スキルを選択すべき）。極めて小規模な単発の疑問には不向き（単純パスでサブエージェントを省いてもなお重め）。コードを実行して挙動を検証する必要があるシナリオには不向き（純粋な静的コード読解のため、動的挙動には検証系スキルを使用してください）。

Install Agent-Ready

① Verified Mirror 2026-09-09

Option A · Direct DownloadDownload how.tar.gz

sha256: ee70ff35028506ef…

Option B · Copy Guide for Agent

install.json

Agent はこの JSON ガイドから自動的にダウンロードして検証します。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit df3fb154fb.