vscode-ext-commands

作者: github

VS Code扩展命令贡献模式与命名规范。定义两种命令类型:常规命令(可在命令面板中访问,需指定类别和标题)和侧边栏命令(以下划线开头并以#sideBar结尾,需包含图标)。侧边栏命令通过enablement和when条件支持可见性规则,并通过group和order属性控制定位。所有命令必须定义标题;常规命令的图标为可选...

npx skills add https://github.com/github/awesome-copilot --skill vscode-ext-commands

VS Code extension command contribution

This skill helps you to contribute commands in VS Code extensions

When to use this skill

Use this skill when you need to:

  • Add or update commands to your VS Code extension

Instructions

VS Code commands must always define a title, independent of its category, visibility or location. We use a few patterns for each "kind" of command, with some characteristics, described below:

  • Regular commands: By default, all commands should be accessible in the Command Palette, must define a category, and don't need an icon, unless the command will be used in the Side Bar.

  • Side Bar commands: Its name follows a special pattern, starting with underscore (_) and suffixed with #sideBar, like _extensionId.someCommand#sideBar for instance. Must define an icon, and may or may not have some rule for enablement. Side Bar exclusive commands should not be visible in the Command Palette. Contributing it to the view/title or view/item/context, we must inform order/position that it will be displayed, and we can use terms "relative to other command/button" in order to you identify the correct group to be used. Also, it's a good practice to define the condition (when) for the new command is visible.