mcpField
H
how

how

github.com/cursor開発14.6k6.2k 回インストール今日更新
リポジトリ

how について

howは、コードベースを調査し、機能やサブシステムの仕組みを説明するClaude Codeスキルです。質問の範囲に応じて単独または複数の観点から調査し、オンボーディングに役立つアーキテクチャ解説を作成します。

主な機能

  1. 01質問の範囲に応じたコード調査
  2. 02複雑な領域の並行調査
  3. 03サブエージェントのモデル選択指針
  4. 04構造化されたアーキテクチャ解説

活用シーン

  1. 01不慣れなモジュールの理解
  2. 02サービス横断機能の追跡
  3. 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 で定義されているセクションを使用し、該当しないものは省略してください。セクションは次のとおりです:概要、主要な概念、仕組み、ファイルの配置、注意点。

コメント