GitHub Copilot CLI Skills系统完全教程：用SKILL.md自动化你的团队最佳实践

GitHub Copilot CLI Skills系统完全教程用SKILL.md自动化你的团队最佳实践【免费下载链接】copilot-cli-for-beginnersLearn how to get started using the GitHub Copilot CLI!项目地址: https://gitcode.com/gh_mirrors/co/copilot-cli-for-beginnersGitHub Copilot CLI SkillsAgent Skills是一套自动加载团队最佳实践的机制当你的提示词匹配某个 Skill 的描述时Copilot 会自动加载对应的SKILL.md指令无需每次重复粘贴冗长提示。本文基于开源教程仓库 copilot-cli-for-beginners 的第 5 章 05-skills/README.md带你从零学会创建、管理与分享 Skills。什么是 Skills 系统Copilot 的电钻与钻嘴一台通用电钻很有用但换上专用钻嘴后才能真正干好不同的活——Skills 之于 Copilot 也是如此。每个 Skill 都是一个专用附件负责一类具体任务Skill用途commit生成统一的提交信息security-audit检查 OWASP 安全漏洞generate-tests生成全面的 pytest 测试code-checklist应用团队代码质量标准Agent Skills 本质上是存放指令的文件夹Copilot 读取你的提示词检查是否有匹配的 Skill相关时自动加载并应用其中的指令。自动触发原理只需自然提问Skills 最强大的地方在于无需手动激活。它的触发流程只有 4 步你自然地提问例如 Review books.py for code quality issuesCopilot 将提示词与各 Skill 的description匹配命中code-checklistSkill自动加载团队质量清单按清单逐项检查输出 PASS/FAIL 结果下面是 Skill 在会话中被自动触发的实际演示当然你也可以用斜杠命令直接指定 Skill获得显式控制 /code-checklist Check books.py for code quality issues /generate-tests Create tests for the user authentication module甚至可以在一条消息中组合多个 Skill Check samples/book-app-project/book_app.py with /code-checklist and also run /generate-tests for it不确定某个回答用了哪些 Skill直接问它What skills did you use for that response?创建第一个 SKILL.md三步完成第一步放对位置位置作用域.github/skills/项目级随 Git 与团队共享~/.copilot/skills/用户级个人专用第二步按结构组织每个 Skill 独占一个文件夹必须包含名为SKILL.md的文件区分大小写.github/skills/ └── my-skill/ ├── SKILL.md # 必需技能定义与指令 ├── examples/ # 可选可引用的示例文件 └── scripts/ # 可选技能可执行的脚本第三步编写 SKILL.md格式非常简单YAML 前置元数据 Markdown 指令。仓库里提供了四个可直接抄作业的模板都在 samples/skills/ 目录--- name: commit-message description: Generate conventional commit messages - use when creating commits, writing commit messages, or asking for git commit help --- # Commit Message Skill Generate commit messages following the Conventional Commits specification. ## Format type(scope): description ## Rules 1. Subject line maximum 72 characters 2. Use imperative mood (add not added) ...YAML 字段说明字段必填说明name是唯一标识小写连字符建议与文件夹名一致description是技能做什么、何时被使用自动触发的依据license否技能适用的许可证argument-hint否斜杠调用时的参数占位提示更多现成模板可参考hello-world/SKILL.md学习格式的最简示例、commit-message/SKILL.md规范化提交信息、pytest-gen/SKILL.md结构化测试生成。description 怎么写自动触发的关键description是 Copilot 决定是否加载 Skill 的首要依据请像触发词清单一样来写# ❌ 太模糊技能永远不会被自动加载 description: Reviews code # ✅ 包含触发词贴近你提问的真实措辞 description: Use for code reviews, checking code quality, finding bugs, security issues, and best practice violations 技巧把你平时自然提问时会说的词security review、generate tests都写进 description 里。两种管理方式copilot skill 与 /skillsCopilot CLI 提供两种管理入口无需激活操作——它们只负责管理哪些技能可用触发依旧全自动。终端命令copilot skill不进交互会话copilot skill list # 查看所有已装技能 copilot skill add path/to/SKILL.md # 从本地文件、URL 或目录添加 copilot skill remove security-audit # 按名称移除会话内斜杠命令/skills可简写/skill命令作用/skills list列出所有已安装技能/skills info name查看某个技能详情/skills add name启用技能来自仓库或市场/skills remove name禁用或卸载技能/skills reload编辑 SKILL.md 后重新加载 新建或修改SKILL.md后记得执行/skills reload无需重启 Copilot。此外CLI 还内置了一批预装技能如云端 Agent 环境定制指南开箱即用运行/skills list即可查看。Skills vs Agents vs MCP什么时候用哪个Skills 只是 Copilot 可扩展体系的三块拼图之一特性做什么何时使用Agents改变 AI 如何思考跨多类任务的专业能力Skills提供任务专属指令具体、可重复、有详细步骤的任务MCP连接外部服务需要 API 的实时数据三者可以叠加一个 code-reviewer Agent 在对话中会自动应用security-audit和code-checklist等多个 Skills。用 code-checklist 落地团队最佳实践仓库内置的 code-checklist/SKILL.md 是团队规范自动化的完整范本。安装后你只需自然地问 Check the book collection code for quality issuesCopilot 会自动加载团队清单输出形如## Code Checklist: books.py ### Code Quality - [PASS] All functions have type hints - [PASS] No bare except clauses ### Input Validation - [FAIL] User input is not validated - add_book() accepts any year value ### Summary 3 items need attention before merge规模化的价值如果团队有 10 条 PR 审查清单没有 Skill 时每人靠记忆、总有遗漏有了pr-reviewSkill每位成员包括新同事执行的都是同一套标准新人无需死记清单。常见坑与排错清单坑现象解决文件名不叫SKILL.md技能不被识别文件必须精确命名为SKILL.mddescription太模糊永远不会自动加载写入具体触发词缺少name/description技能加载失败补齐 YAML 前置元数据放错文件夹技能找不到项目级用.github/skills/个人用~/.copilot/skills/排查技能没生效的顺序检查 description 措辞 → 确认文件位置ls .github/skills/→ 核对 SKILL.md 格式 → 执行/skills reload→ 直接询问 Copilot 可用了哪些技能。⚠️ 安全提醒安装社区 Skill 前务必先阅读其SKILL.md——Skill 控制 Copilot 的行为恶意技能可能引导它执行危险命令。总结Skills 系统 5 个要点自动触发提示词匹配description时Skill 自动加载无需手动激活显式调用也可用/skill-name斜杠命令精确指定甚至一条消息组合多个格式极简YAML 前置元数据name、description 必填 Markdown 指令位置决定作用域.github/skills/团队共享~/.copilot/skills/个人专用管理双入口终端copilot skill 会话内/skills改完记得 reload想继续深入完整章节内容、练习题构建book-summary技能挑战与更多故障排查见 05-skills/README.md更多现成技能模板见 samples/skills/ 与 .github/skills/。【免费下载链接】copilot-cli-for-beginnersLearn how to get started using the GitHub Copilot CLI!项目地址: https://gitcode.com/gh_mirrors/co/copilot-cli-for-beginners创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考