将代理技能与GitHub Copilot配合使用

代理技能是可重用的指令集，可教Copilot代理如何执行特定任务，例如运行生成管道、生成样板或遵循团队的编码标准。 通过定义一次技能，可以节省时间并确保工作流中的一致行为。

技能补充 自定义代理 和 自定义说明。 虽然自定义代理定义了角色和工具集，以及自定义说明设置常规编码首选项，但技能提供了特定于任务的集中指导，任何代理都可以自动发现和使用。

Prerequisites

代理技能的工作原理

使用智能体模式时，Copilot 会自动发现存储库和用户配置文件中的技能。 代理决定技能何时与你的请求相关并激活它。 激活技能后，它会显示在聊天中，让你知道它正在应用。

&&&&显示在聊天中使用的Copilot代理技能的截图。&&&&

技能位置

技能从以下位置获取：

技能类型 位置
工作区或项目技能（存储在存储库中） .github/skills/、.claude/skills/、.agents/skills/
个人技能（存储在用户配置文件中） ~/.copilot/skills/、~/.claude/skills/、~/.agents/skills/

工作区技能通过源代码管理与团队共享。 个人技能适用于所有项目，不会提交到任何存储库。

创建技能

可以在文件系统中手动创建技能。

手动创建技能

每个技能都是一个目录，其中包含遵循 SKILL.mdagentskills.io 规范的文件。

  1. 创建技能目录。 对于工作区技能，请在存储库的根目录中使用 .github/skills/。 对于个人技能，请使用 ~/.copilot/skills/。

  2. 为技能创建子目录。 每个技能都应有自己的目录（例如 .github/skills/github-issues/）。

  3. 在技能目录中创建SKILL.md文件。 该文件包含一个 YAML 前置参数部分，其中含有元数据，接着是 Markdown 说明。

  4. （可选）将脚本、示例或其他资源添加到技能的目录中。

技能目录结构

your-repo/
└── .github/
    └── skills/
        └── github-issues/
            ├── SKILL.md          # Required: metadata + instructions
            ├── scripts/          # Optional: executable code
            ├── references/       # Optional: documentation
            └── assets/           # Optional: templates, resources

SKILL.md 格式

SKILL.md 文件必须包含 YAML 前页，后跟 Markdown 内容：

---
name: github-issues
description: Creates and manages GitHub issues following team conventions. Use when working with issue tracking, bug reports, or feature requests.
---

When creating GitHub issues:

- Use the standard title format: [Component] Brief description
- Add appropriate labels based on issue type
- Include reproduction steps for bug reports
- Link related issues and PRs

Frontmatter 属性

财产 必需 说明
name 是的 仅小写字母、数字和连字符。 必须与父目录名称匹配。 最多 64 个字符。
description 是的 描述技能的作用以及何时使用它。 最多 1,024 个字符。
license 否 许可证名称或对捆绑许可证文件的引用。
compatibility 否 环境要求，如预期的产品或所需的系统包。
metadata 否 其他元数据的任意键值映射。
allowed-tools 否 技能可使用的预先批准工具的由空格分隔的字符串。

编写有效技能的提示

  • 使主线 SKILL.md 保持在 500 行以下。 将详细参考资料移动到 references/ 目录中的单独文件中。
  • 编写一个清晰的 description，其中包含特定关键词，以帮助代理识别技能何时相关。
  • 包括分步说明、示例和常见边缘案例。

从技能面板管理技能

选择Copilot 对话助手右下角的 Tools 图标以打开技能面板，这是每个已发现的技能的专用视图。 “技能”面板仅在 Visual Studio 2026 预览体验成员中可用。

显示可在其中编辑和打开技能的技能面板的屏幕截图。

您可以在面板中：

  • 编辑：从 SKILL.md菜单中直接在编辑器中打开任何技能。
  • 打开文件位置：跳转到磁盘上的技能目录。
  • 搜索：按名称或关键字筛选技能。

该面板还会显示任何技能配置错误的诊断，以便快速发现和修复问题。

社区技能

请查看 awesome-copilot 存储库，以了解由社区分享的技能。

相关内容

  • Last updated on