how について
howは、コードベースを調査し、機能やサブシステムの仕組みを説明するClaude Codeスキルです。質問の範囲に応じて単独または複数の観点から調査し、オンボーディングに役立つアーキテクチャ解説を作成します。
主な機能
- 01質問の範囲に応じたコード調査
- 02複雑な領域の並行調査
- 03サブエージェントのモデル選択指針
- 04構造化されたアーキテクチャ解説
活用シーン
- 01不慣れなモジュールの理解
- 02サービス横断機能の追跡
- 03サブシステムのオンボーディング資料作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ cursor/ plugins --skill howインストール後、Claude Code で/howを入力して読み込まれたか確認します。
同梱ファイルreferences/explainer-prompt.mdreferences/explorer-prompt.md
詳細
仕組み
Claude Code では、このスキルに従う前に、セッションごとに一度Claude Code アダプターを読んでください。これにより、pstack スキル内の Cursor の名前が Claude Code に対応付けられます。
コードベースを調べて、「X はどのように動作するのか?」という質問に答えてください。サブシステムに着任したシニアエンジニアがオンボーディングで把握できるレベルのアーキテクチャ解説を作成してください。注釈付きのソースコードのように読めるほど細かくせず、実際に役立つ全体像を構築できるだけの内容にしてください。
すべての起動先は、subagent_type: generalPurpose と readonly: true を指定した Task サブエージェントです。調査役は pstack-models.mdc ルールの how explorer 行(既定値は grok-4.7-xhigh-fast)を使い、すべての説明役は how explainer 行(既定値は claude-opus-5-5-xhigh)を使います。model には、その行の値を設定してください。ルールまたは行が存在しない場合は既定値を設定してください。値が auto または inherit-parent の場合は、model を未設定にしてください。Task ツールがスラッグを受け付けない場合は、既定値を使用してその旨を伝えてください。既定値も受け付けない場合は、エラーメッセージにある同じファミリーの有効なスラッグのうち、最も近いものを使ってください。各サブエージェントの推論レベルと高速または標準の速度は、poteto-mode スキルの Subagents セクションに従って作業に合わせて選んでください。
1. 複雑さを評価する
対象範囲が曖昧な場合は、解釈を示して調査してください。ユーザーは後から方向を修正できます。
- シンプル(単一のモジュール、小規模なユーティリティ、「関数 X はどのように動作するのか」といった範囲の狭い質問):調査役は不要です。
references/explainer-prompt.mdを基に、調査結果のセクションを含めずに、調査と説明を一度に行う説明役を 1 つ起動してください。ステップ 4 に進みます。 - 複雑(複数ファイルまたは複数サービスにまたがるサブシステム、横断的な機能、アーキテクチャ全体の概要):ステップ 2 に進みます。
迷った場合は、シンプルな方法を選んでください。
2. 調査する(複雑な場合のみ)
質問を 2~4 個の観点に分解し、それぞれサブシステムの異なる側面を扱うようにします。各観点を記入した references/explorer-prompt.md を使い、すべての調査役を 1 回のメッセージで起動してください。
3. 統合する(複雑な場合のみ)
すべての調査役から結果が返ってきたら、各調査役の調査結果を記入した references/explainer-prompt.md を使って、説明役を 1 つ起動してください。
4. 提示する
説明役の出力を提示してください。会話の文脈に合わせて、明瞭さや背景情報のために軽微な編集を加えてもかまいません。大幅な書き換えはしないでください。
出力形式
説明には references/explainer-prompt.md で定義されているセクションを使用し、該当しないものは省略してください。セクションは次のとおりです:概要、主要な概念、仕組み、ファイルの配置、注意点。