Skip to content

Agent Skills 是一套可插拔的专项能力扩展——把技能文件夹安装到仓库或个人目录后,Copilot 在处理相关任务时会自动加载并调用这些技能。本页介绍 Skills 的基本概念、安装方式和适用场景。

GitHub Copilot Agent Skills:让 AI 代理掌握专项技能

什么是 Agent Skills

Skills(技能)是包含指令、脚本和资源文件的文件夹,当 Copilot 处理相关任务时会自动加载对应的技能。

可以把它理解成:"给 Copilot 安装专业工具包"。比如安装一个"数据库迁移技能",Copilot 在处理数据库相关任务时就会自动参考这个技能里的脚本和指令,而不需要每次手动说明。

Agent Skills 遵循开放标准,可以跨 AI 平台使用。

支持 Skills 的场景

  • Cloud Agent:GitHub.com 上的云端 Agent 任务
  • GitHub Copilot CLI:命令行 Agent 模式
  • VS Code Agent 模式:IDE 里的 Agent 操作

技能类型

项目技能(Project Skills)

存放在仓库内,随仓库共享给所有贡献者。适合放与特定项目相关的专项技能,例如:

  • 项目特定的代码生成模板
  • 与业务逻辑相关的操作脚本
  • 特定框架的最佳实践指令

个人技能(Personal Skills)

存放在个人主目录(~/.config/gh/copilot/skills/ 或类似路径),跨项目复用。适合放通用技能,例如:

  • 你常用的代码风格指南
  • 团队内部工具的操作指令
  • 个人编程偏好配置

组织级和企业级 Skills 目前正在开发中,尚未正式发布。

发现和安装 Skills

官方和社区技能库

  • anthropics/skills:Anthropic 维护的官方技能集
  • GitHub 社区集合:用户贡献的社区技能

通过 GitHub CLI 安装

bash
# 搜索可用技能
gh skill search <关键>

# 安装技能
gh skill install <技能名>

# 查看已安装的技能
gh skill list

gh skill 命令帮助你从 GitHub 上发现和管理技能,无需手动下载。

Skills 和 .github/copilot-instructions.md 的区别

特性Skillscopilot-instructions.md
包含脚本✅(可执行脚本)❌(纯文本指令)
按需加载✅(任务相关才加载)❌(每次对话都加载)
跨平台✅(开放标准)❌(仅 Copilot)
配置复杂度中(需要文件夹结构)低(单个 MD 文件)

两者可以配合使用:copilot-instructions.md 负责全局规范,Skills 负责特定专项操作。

Skills 和 Claude Code SKILL.md 的对比

如果你同时用 Claude Code,你可能注意到 Claude Code 也有 Skills 系统(SKILL.md)。两者设计理念类似,但不通用:

  • Claude Code Skills:存放在 .claude/skills/,只对 Claude Code 生效
  • Copilot Agent Skills:存放在标准目录,支持 Cloud Agent、CLI、VS Code Agent

如果同时使用两个工具,建议把通用技能逻辑在两套系统里分别配置。

常见问题

Q: Skills 需要多少技术背景才能创建?

A: 入门门槛不高——一个技能至少是一个包含 SKILL.md 指令文件的文件夹。如果需要可执行脚本,则需要基本的脚本编写能力。

Q: 安装了很多 Skills 会影响响应速度吗?

A: Skills 是按需加载的,只有与当前任务相关的 Skills 才会被加载。所以安装数量不直接影响性能,但相关 Skills 越多,Copilot 选择加载哪个的判断越复杂。

Q: 在 VS Code 里怎么知道 Copilot 使用了哪个 Skill?

A: 在 Agent 模式执行任务后,可以在工具调用日志中查看 Copilot 加载了哪些技能文件。