适用于 VS Code 中的 Copilot agent mode;官方页面未说明统一最低客户端版本。Agent Customizations 编辑器标为 Preview。未安装或实机测试;技能脚本与外部依赖须单独审查。
Préparation
- 已安装 VS Code,并能在其中使用 GitHub Copilot Chat 的 Agent mode;官方指南未列出统一的最低 VS Code 版本号。
- 准备 Skills-SI 市场中目标技能的条目;下载前确认作者、许可证、来源及其引用的脚本和外部依赖。
- 决定安装范围:只对当前仓库生效,或放入用户目录供多个项目共用。
Installation et usage
- 01
准备:确认 Agent mode 与安装范围
确认 Copilot Chat 可用,并选择 Agent mode;Skills 的官方支持范围包含 VS Code agent mode。决定采用项目级或用户级目录。VS Code 的 Agent Customizations 编辑器目前标为 Preview,但它不是使用技能的唯一方式。MCP 服务器、提示词或自定义指令不等同于 Agent Skill。
Sources et preuvesSKILL.md + resourcesVérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 02
从 Skills-SI 本站下载目标包
从本站对应技能条目的下载入口获取其 ZIP 包。核对条目所示作者、许可及来源;本站下载不代表 GitHub 或上游作者背书,也不能替代安全审查。
Sources et preuvesSKILL.md + resourcesVérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 03
解压并检查完整目录
解压 ZIP 后找到技能自己的完整文件夹,不能只拷贝 SKILL.md。检查 SKILL.md 的 YAML 元数据和说明,并阅读其中引用的脚本、示例、资源及外部依赖;对来历不明或行为不清的脚本不要运行。
解压后的完整技能目录(保留 SKILL.md 及包内配套文件)Sources et preuves解压后的完整技能目录(保留 SKILL.md 及包内配套文件)Vérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 04
复制到 VS Code 支持的位置
将完整技能文件夹放入所选位置:仓库内的 .github/skills/,或用户主目录下的 ~/.copilot/skills/。每项技能应有独立子目录;SKILL.md 的 name 必须与父目录名相同,名称只用小写字母、数字和连字符。不要把旧的 chat.agentSkillsLocations 自定义位置误当作通用发现路径;官方说明该设置已弃用且仅供 Local agent 使用。
项目级:<仓库>/.github/skills/<技能名>/;用户级:~/.copilot/skills/<技能名>/Sources et preuves项目级:<仓库>/.github/skills/<技能名>/;用户级:~/.copilot/skills/<技能名>/Vérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 05
调用并完成首次练习
在 Copilot Chat 输入 /skills 打开技能配置菜单;默认情况下,技能可作为斜杠命令使用,也可由 Copilot 按描述自动选择。若该技能设置 user-invocable: false,则不会出现在斜杠菜单,应以与其 description 匹配的请求测试自动加载。可用虚构的 15 分钟项目协调会纪要,要求适用的会议整理技能提取决定、行动项和负责人;不要输入真实客户资料。
目标技能目录内的 SKILL.md/skills;如技能允许用户调用,则用 /<技能名> 调用Sources et preuves目标技能目录内的 SKILL.mdVérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 06
验证加载与输出
确认配置菜单或斜杠菜单能发现技能,检查其名称和说明,再用匹配技能描述的虚构请求观察回答是否遵循说明。若技能依赖其他文件,确认 SKILL.md 使用相对路径引用它们。对生成内容及任何建议执行的脚本仍需人工检查;单次回答不能证明技能在所有情境下都会自动触发。
项目级:<仓库>/.github/skills/<技能名>/SKILL.md;或用户级:~/.copilot/skills/<技能名>/SKILL.md/skillsSources et preuves项目级:<仓库>/.github/skills/<技能名>/SKILL.md;或用户级:~/.copilot/skills/<技能名>/SKILL.mdVérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle. - 07
禁用或卸载
卸载时关闭 Copilot Chat 对目标技能的使用,并从其原安装位置移除该技能的整个子目录;项目级只影响该仓库,用户级影响使用该用户目录的项目。删除前确认路径和备份需要保留的本地改动;不要删除父级 skills 目录或其他技能。
删除目标技能子目录:<仓库>/.github/skills/<技能名>/ 或 ~/.copilot/skills/<技能名>/Sources et preuves删除目标技能子目录:<仓库>/.github/skills/<技能名>/ 或 ~/.copilot/skills/<技能名>/Vérifier le fonctionnementSchéma de processus/dossiers, pas une capture officielle.
Exercice et validation
对虚构的 15 分钟项目协调会纪要使用适用的会议整理技能,要求输出决定、行动项和负责人;检查是否依据技能说明组织内容。
- 输入 /skills 查看技能配置菜单;默认可调用技能也可在聊天输入 /<技能名>,但 user-invocable: false 的技能不显示在斜杠菜单。
- 检查 SKILL.md 的 name 与技能父目录同名,且 description 描述了能力和适用场景。
- 用符合技能用途的虚构输入检查输出;复核其是否遵循说明及是否正确引用配套资源。
- 人工审阅技能所含脚本及 Copilot 提出的操作;不要仅凭技能被发现或一次输出判断安全、正确或始终自动触发。
Désactiver et désinstaller
- 确认技能实际装在项目级还是用户级目录。
- 备份需保留的修改,然后移除对应的整个技能子目录,而不是只删 SKILL.md。
- 回到 VS Code 的 /skills 菜单或以聊天确认不再发现该技能;若仍在其他支持目录存在,检查并移除那一份。
Dépannage
技能未出现在 / 菜单或配置菜单。
确认它位于官方支持的项目级或用户级目录,技能文件名为 SKILL.md;再核对 YAML frontmatter、必需的 name/description,以及 name 与父目录是否匹配。检查 user-invocable 是否设为 false;该设置会隐藏斜杠命令。
Copilot 没有自动使用技能。
让请求与 description 中的能力和触发情境相符;确认 disable-model-invocation 未设为 true。需要手动调用时,检查 user-invocable 设置及技能名。
技能读取不到附带模板或资源。
确保完整目录已复制,而不只是 SKILL.md;检查说明里的相对路径是否正确,并确认所引用文件确实在该目录中。
技能建议运行脚本,或执行步骤出现权限提示。
先人工阅读脚本及其依赖,只在理解并信任后才考虑运行;不要为省去确认而预先批准 shell/bash。可跳过脚本,并手动完成安全的说明性步骤。
旧配置位置的技能未被发现。
迁移到官方文档列出的支持位置;VS Code 文档注明 chat.agentSkillsLocations 已弃用且仅用于 Local agent,不能据此假定其他 agent 会发现该目录。
Sources et preuves
- https://code.visualstudio.com/docs/copilot/customization/agent-skills
VS Code 官方正文:Agent Skills 的支持范围、项目级与用户级目录、SKILL.md 格式、/skills 与斜杠调用、自动加载、资源引用、设置限制及安全注意事项。
- https://docs.github.com/en/copilot/concepts/agents/about-agent-skills
GitHub 官方正文:Agent Skills 在 VS Code agent mode 等产品中的支持,以及项目技能和个人技能的目录范围。
- https://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/add-skills
GitHub 官方正文:技能目录与 SKILL.md 结构、完整目录及附带资源、脚本授权风险;用于交叉核验,不将 GitHub CLI 或 MCP 当作技能本身。