GitHub 对外放出 Copilot 智能体技能官方指南，把 Agent Skills 这套能力的定义、目录规范、编写格式、触发逻辑、调试方法一次性讲清楚，开发者可以把项目里固定的流程，比如代码评审、打包发布、自动化测试、故障排查，打包成独立技能，存放在仓库里，Copilot 智能体识别到对应任务的时候自动加载执行，不用每次重复写一大段提示词。之所以要推出这套 Copilot 智能体技能指南，是之前大家只能用全局自定义指令，所有任务都共用一套规则，很容易互相干扰；技能是按场景拆分的，只在匹配场景才激活，还能附带脚本、示例文件，团队可以跟着版本控制一起沉淀内部开发规范，换同事、换仓库都能复用同一套流程。完整使用流程是，开发者先在仓库根目录新建.github/skills 目录，每个技能单独建子文件夹，里面写 SKILL.md，定义技能名称、触发条件、执行步骤，还可以放配套脚本、样例；提交到 Git 仓库之后，VS Code 或者 GitHub 云端的 Copilot Agent 会自动扫描识别，用户提相关需求时智能体自动匹配加载技能，执行完成之后聊天界面会提示当前启用了哪一项技能，不合适的话开发者还能修改 SKILL.md 迭代优化，技能还支持个人用户本地技能和项目仓库技能两套隔离位置。
一、Copilot 智能体技能和自定义指令对比
| 类型 | 存放位置 | 生效逻辑 | 适合场景 |
|---|---|---|---|
| Copilot 智能体技能 | .github/skills（项目）、~/.copilot/skills（个人） | 任务匹配时按需加载，不匹配就不启用 | 专项流程：CI 检查、代码评审、发布流程、故障定位 |
| 自定义指令 | Copilot 配置面板全局设置 | 所有对话、所有任务全程生效 | 通用编码规范、默认输出格式、全局偏好 |
二、标准技能目录结构清单
.github/skills/
└── release-check/ 技能名称，小写+短横线
├── SKILL.md 必须文件，技能入口，包含元信息、执行指令
├── scripts/ 可选，配套Shell/Python脚本
└── examples/ 可选，样例、模板、报错案例
- SKILL.md 头部固定 YAML 元信息：name、description，用来给 Copilot 判断什么时候触发
- description 写清楚触发场景，描述越精准，误触发越少
- 技能文件夹名称只能小写、数字、短横线，不能用中文和空格
三、指南里推荐的高频技能场景
- 代码质量检查：自动调用 lint、单元测试，汇总报错，给出修复建议
- 版本发布流程：核对版本号、生成更新日志、打包、触发 CI 流水线
- PR 评审技能：按照团队规范检查 PR 改动、注释、测试用例、安全风险
- 故障排查技能：解析报错日志、定位依赖问题、提供排查步骤
- 文档生成技能：读取代码接口，自动生成接口文档、注释模板
四、Copilot 智能体技能运行机制
- 扫描：Copilot Agent 启动后自动扫描项目目录、用户本地目录的 skills 文件夹
- 匹配：读取每个 SKILL.md 的 description，判断用户当前需求是否匹配
- 加载：匹配成功，自动把技能内全部指令、脚本上下文注入到本次对话
- 执行：按技能里的步骤执行任务，聊天窗口展示
- 结束：本次任务结束，技能上下文自动释放，不会影响下一次无关对话
【已启用 XX 技能】
五、优势与现存局限
✅ 优势
- 跟着 Git 版本管理，团队共享、同步规范，新人上手直接继承流程
- 拆分独立，不会像全局指令那样互相冲突、冗余
- 跨环境兼容：VS Code、Copilot CLI、云端 Copilot Agent 都能用
- 遵循 Agent Skills 开放标准，做好的技能可以迁移到其他兼容智能体
⚠️ 局限
- 技能描述写得不好容易误触发，不该加载的时候被调用
- 配套脚本执行权限受本地 IDE、环境权限管控
- 技能数量太多会增加智能体检索开销，建议一个场景只保留一个技能
- 私有仓库技能只能仓库内使用，不会自动公开到社区
六、调试和排错要点
- 看 Copilot 聊天弹窗提示，确认有没有成功加载目标技能
- 优先修改 SKILL.md 的 description，优化触发判断
- 复杂脚本单独测试，不要直接把大量未验证脚本放进技能
- 区分 Workspace 项目技能和 User 个人技能，避免覆盖冲突
【常见问题】
问题 1：GitHub 发布 Copilot 智能体技能指南，Copilot 智能体技能和普通自定义提示词有什么不一样？
回答 1：根据 GitHub 这份 Copilot 智能体技能指南，智能体技能是存放在仓库目录、可版本管理的独立流程包，带触发条件，按需加载；自定义提示词大多是全局固定规则，全程生效，没法按任务自动切换。
问题 2：GitHub 发布 Copilot 智能体技能指南，Copilot 智能体技能默认放在哪个文件夹？
回答 2：GitHub Copilot 智能体技能指南里规定，项目共享技能放在仓库根目录.github/skills，个人本地技能放在～/.copilot/skills，每个技能单独一个子文件夹。
问题 3：GitHub 发布 Copilot 智能体技能指南，SKILL.md 文件是干什么的？
回答 3：SKILL.md 是 Copilot 智能体技能的核心入口文件，在 GitHub Copilot 智能体技能指南里要求写入技能名称、触发描述、详细执行步骤，是 Copilot 智能体识别、加载这项技能的依据。
问题 4：GitHub 发布 Copilot 智能体技能指南，写好的 Copilot 智能体技能可以给别的 AI 智能体用吗？
回答 4：可以，这套 Copilot 智能体技能遵循 Agent Skills 开放标准，按照 GitHub Copilot 智能体技能指南规范制作的技能包，也能在其他兼容该标准的代码智能体上加载使用。
问题 5：GitHub 发布 Copilot 智能体技能指南，团队使用 Copilot 智能体技能有什么好处？
回答 5：团队可以把代码评审、发布、测试流程做成 Copilot 智能体技能，提交到 Git 仓库，所有人共用一套标准流程，新人不用反复沟通团队规范，Copilot 智能体自动按流程执行，减少人为疏漏。
【参考资料】
[2026-10-12]（GitHub Copilot App 入门指南：如何让 Copilot 了解你的代码库）GitHub 博客
[2026-10-13]（GitHub Copilot 智能体技能指南发布，项目级技能落地）搜狐科技
[2026-10-12]（Use Agent Skills in VS Code）VS Code 官方文档
[2026-09-05]（Use Agent Skills with GitHub Copilot）Microsoft Learn
[2026-10-14]（Copilot Agent Skills 实操：把重复开发流程封装成技能）掘金
免责声明
本文内容仅为 GitHub Copilot 智能体技能指南资讯解读，不构成开发、采购建议，Copilot 智能体技能属于测试中的功能，不同版本 VS Code、Copilot 客户端支持程度存在差异，技能规范、能力边界请以 GitHub 官方文档更新为准。