为云端工作添加 Skills

Skill 是包含说明、脚本和资源的目录，Copilot 根据任务与 description 判断是否加载。适合较长、按需使用的专项流程；几乎所有任务都应遵循的短规则更适合 custom instructions。

项目目录

官方支持项目级 .github/skills/、.claude/skills/ 和 .agents/skills/。每个 Skill 占一个子目录，核心文件必须叫 SKILL.md，例如：

.github/skills/test-review/
├── SKILL.md
└── examples.md

目录名建议使用小写字母及连字符。通用添加教程要求 name 小写，空格用连字符；云端项目按这一规范编写即可，不把 CLI 更详细的名称兼容规则混入此处。

SKILL.md

---
name: test-review
description: "Reviews test coverage and identifies missing regression cases."
---

Read the changed behavior and the related tests.
Use examples.md for the review checklist.
Report uncovered behavior, expected assertions, and any test setup needed.

name 与 description 必填，license 可选。Description 应同时写明能力和使用时机；匹配任务后，Copilot 会把 SKILL.md 注入上下文，并可使用目录内引用的资源。

脚本与工具

可把脚本放进 Skill 目录，在正文说明从哪个目录运行、参数是什么、如何验证结果。allowed-tools 用于声明可预批准的工具，通用教程展示了 allowed-tools: shell。

这一教程同时面向多个客户端，不能将其“未列出工具时提示确认”的描述当作云端交互保证。云端 Hooks 参考明确运行环境是非交互、工具权限预授予；要限制云端工具，应结合角色工具范围和preToolUse等实际控制。

不要把未知来源脚本的工具预批准直接当成安全审核已完成。采用他人 Skill 前先读 SKILL.md、脚本与资源。

个人 Skill 与分发

通用文档还列出个人目录 ~/.copilot/skills/ 和 ~/.agents/skills/，供本地客户端跨项目共享。把文件放到自己电脑的个人目录，不代表它会自动上传到某个云端任务；云端项目流程应将所需 Skill 放进仓库支持的位置。

可以手动复制完整 Skill 目录，也可通过GitHub CLI 的 gh skill发现、预览和安装。

Code review 与客户端差异

Copilot code review 也可自动使用 .github/skills 内与评审相关的 Skill；官方建议需要评审使用时采用 code-review 一类面向评审的目录名。

Skills 概念页列出 JetBrains 支持，添加教程开头的客户端列表暂未列它。其他客户端的实际支持以各自文档为准，不把某一列表的遗漏解释为统一禁止。