vscode-ext-commands について
vscode-ext-commands は、VS Code 拡張機能のコマンドを追加・更新する貢献者向けのスキルです。タイトル、カテゴリ、サイドバーでの命名や表示条件、アイコン、配置について説明します。
主な機能
- 01コマンドの追加・更新ガイド
- 02コマンドタイトルの必須要件
- 03コマンドパレットのカテゴリ規則
- 04サイドバーの命名とアイコン規則
- 05ビュー内の配置と表示条件
活用シーン
- 01コマンドパレットへのコマンド追加
- 02サイドバー専用コマンドの追加
- 03ビュー内でのコマンド配置
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ github/ awesome-copilot --skill vscode-ext-commandsインストール後、Claude Code で/vscode-ext-commandsを入力して読み込まれたか確認します。
詳細
VS Code 拡張機能のコマンドコントリビューション
このスキルは、VS Code 拡張機能でコマンドをコントリビュートする際に役立ちます
このスキルを使用する場面
次のような場合にこのスキルを使用します:
- VS Code 拡張機能にコマンドを追加または更新する場合
手順
VS Code のコマンドは、そのカテゴリ、可視性、配置場所に関係なく、常に title を定義する必要があります。コマンドの「種類」ごとにいくつかのパターンを使用しており、それぞれの特徴を以下に説明します:
-
通常のコマンド: デフォルトでは、すべてのコマンドはコマンドパレットからアクセスできる必要があり、
categoryを定義する必要があり、サイドバーで使用される場合を除いてiconは必要ありません。 -
サイドバーのコマンド: その名前は特別なパターンに従い、アンダースコア (
_) で始まり、#sideBarが付加されます。たとえば_extensionId.someCommand#sideBarのようになります。iconを定義する必要があり、enablementに関するルールがある場合とない場合があります。サイドバー専用のコマンドは、コマンドパレットに表示されるべきではありません。これをview/titleまたはview/item/contextにコントリビュートする場合、表示される 順序/位置 を指定する必要があり、適切なgroupを特定するために「他のコマンド/ボタンとの相対位置」という表現を使用できます。また、新しいコマンドが表示される条件 (when) を定義することは良いプラクティスです。