一、基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | copilot-sdk（合集仓库子目录名） | 目录名 |
| 所属合集仓库 | microsoft/skills（微软官方维护的 Agent Skills 仓库，为 Azure SDK、Microsoft Foundry 及 GitHub Copilot SDK 提供结构化技能） | GitHub API |
| 作者/维护者 | Microsoft 官方 | GitHub 组织账号 |
| 来源链接 | https://github.com/microsoft/skills/tree/main/.github/skills/copilot-sdk | — |
| 许可证 | MIT（仓库根 README 明确声明） | README 实测 |
| 所属合集仓库整体 Stars/Forks | 2,761 / 311（注：该数字属整个 133+ 技能的合集仓库，不代表本技能自身热度，仅供了解所属仓库规模） | GitHub API |
| 该技能自身活跃度 | 该目录下共 4 次实质性提交，最近一次 2026-04-20（补充测试用例与验收标准）；所属仓库整体近一天内仍有提交，非弃置 | GitHub Commits API（路径限定查询） |
| 最新版本 | 无独立版本号（随仓库整体迭代） | 仓库结构实测 |
| 安装方式 | 见第十章 | 仓库根 README |
二、功能介绍与亮点
copilot-sdk 是微软官方为 AI 编程 Agent 编写的技能，教会 Agent 如何用 GitHub Copilot SDK（2026 年 6 月随 Microsoft Build 正式 GA、支持 Node.js/Python/Go/.NET 四种语言）把 Copilot 的智能体运行时嵌入到自己开发的应用或服务里，核心能力：
- 标准调用范式：创建客户端 → 创建会话 → 发送消息的三步固定模式，四种语言均给出对齐示例
- 流式响应与自定义工具：支持
streaming增量事件订阅，可用defineTool()以 JSON Schema 定义自定义工具扩展 Agent 能力 - 生命周期钩子：
onPreToolUse、onPostToolUse、onUserPromptSubmitted、onPermissionRequest等钩子可拦截并干预 Agent 行为 - MCP 服务器接入：支持本地 stdio 与远程 HTTP 两种 MCP 服务器接入方式
- 多种鉴权路径：既可用 GitHub Copilot 订阅，也支持 BYOK（自带密钥）接入 OpenAI、Azure、Anthropic、Ollama 等供应商
亮点：官方出品、文档详尽（四语言对齐示例、部署模式、已知限制均有说明）；所属仓库采用“验收标准 + 测试场景”的工程化流程（129 个技能配 1169 条测试场景），技能质量有工程化把关，不是简单堆文档。
三、适用场景
固定分类：集成与工作流自动化
适用于已经在用 Claude Code、Codex 等编程 Agent、想把可编程 AI 智能体能力嵌入自己产品（而不是从零造一个 Agent 运行时）的初中级开发者：例如给内部工具接一个可对话的助手、把 Copilot 的自动化能力包装进自己的 CLI 或服务后端。不适合单纯想在编辑器里用 Copilot 自动补全的用户——那是 Copilot 本身的功能，与本技能无关。
四、跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 需适配 | SKILL.md 是通用格式，理论上可手动复制进 .claude/skills/；但仓库官方安装向导（npx skills add）与全部文档均面向 GitHub Copilot CLI/VS Code，未见 Claude Code 官方支持说明 |
| Codex | 未验证 | 已抓取材料未提及，未为此单独搜索 |
| OpenClaw | 未验证 | 已抓取材料未提及，未为此单独搜索 |
| Hermes Agent | 未验证 | 已抓取材料未提及，未为此单独搜索 |
五、推荐理由
官方出品，手把手教AI编程助手用GitHub Copilot SDK构建可编程的智能体应用
六、评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 微软官方出品且仓库持续活跃（近一天内仍有提交）；但作为 133+ 技能合集仓库中的一个子目录，其自身独立讨论热度未见于公开渠道，故不套用合集整体星数 |
| 可用性 | 8 | 四语言对齐示例、部署模式与已知限制文档齐全，安装为“git clone 后复制目标目录”或官方 CLI 向导，步骤清晰但非一条命令直接可用；实际使用需 GitHub Copilot 订阅或 BYOK 供应商密钥，存在依赖成本 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行及权限范围 | 技能本身不含可执行脚本，是指导 Agent 生成调用 SDK 的代码；SDK 运行时会在本地拉起 Copilot CLI 子进程（JSON-RPC over stdio），范围在文档中明确说明 |
| ② 运行时联网外发数据 | 会联网：本地 CLI 进程与 GitHub/Copilot 后端或 BYOK 供应商 API 通信，属核心功能且文档透明说明，非隐藏行为 |
| ③ API Key/凭据要求及存储方式 | 需要 GitHub Copilot 订阅令牌，或 BYOK 场景下的第三方供应商 API Key；文档给出显式环境变量与 OAuth 两种存储/传递方式 |
| ④ 可疑指令/Prompt Injection 迹象 | 已抓取的 SKILL.md 全文为标准 SDK 使用文档与代码示例，未发现诱导执行额外操作或外发数据的文字 |
| ⑤ 作者/组织信誉 | Microsoft 官方 GitHub 组织账号，仓库为公司级维护 |
| ⑥ License 是否明确 | MIT，仓库根 README 明确声明 |
| ⑦ 最近维护时间 | 所属仓库近一天内仍有提交；该技能目录自身最近一次实质性提交约 3 个月前，非弃置 |
七、跟同类 Skills 相比的优势
| 方案 | 核心定位 | 覆盖范围 | 与 copilot-sdk 的差异 |
|---|---|---|---|
| copilot-sdk（本推荐） | 微软官方出品，教 Agent 用 GitHub Copilot SDK 构建可编程智能体应用 | Node.js / Python / Go / .NET 四语言 SDK 集成 | — |
| gmail（openai/plugins） | OpenAI 官方 Codex 插件市场中的 Gmail 集成条目 | 单一第三方服务（邮件）的读写操作 | 面向具体办公应用的收发信自动化，与 copilot-sdk“把智能体运行时嵌入自己应用”的开发者向定位不同 |
| google-drive（openai/plugins） | OpenAI 官方 Codex 插件市场中的 Google Drive 集成条目 | 单一第三方服务（文件存储）的读写操作 | 同为办公应用集成，服务对象是最终用户的文件管理需求，而非 SDK 级二次开发 |
| atlassian-rovo（openai/plugins） | OpenAI 官方 Codex 插件市场中的 Atlassian 集成条目 | 项目管理/知识库（Jira、Confluence 一类场景） | 面向团队协作场景，不涉及把智能体运行时嵌入自有应用的 SDK 开发工作 |
| hubspot（openai/plugins） | OpenAI 官方 Codex 插件市场中的 HubSpot 集成条目 | CRM/营销自动化 | 面向销售与市场团队的业务系统对接，技术受众与 copilot-sdk 的开发者定位不同 |
差异化核心：openai/plugins 系列条目大多是“把某个现成 SaaS 服务接进 Agent 对话”的应用层集成；copilot-sdk 则是反过来——教开发者把一整套智能体运行时（会话管理、工具调用、钩子、MCP）嵌入自己正在构建的应用，属于 SDK 级、更偏底层的开发者能力。
八、用户评价
该技能目前在第三方平台尚无具名用户评价。其教学对象——GitHub Copilot SDK 本身——已获得 GitHub 官方博客、InfoWorld、InfoQ 等多家科技媒体在 2026 年上半年正式 GA 时的报道，但这些报道针对 SDK 产品本身，不构成对本技能条目的评价。
九、其他补充
- 多语言支持：技能覆盖的 SDK 本身支持 Node.js、Python、Go、.NET 四种运行时，示例代码逐一对齐
- 工程化质量把关：所属仓库对技能采用“验收标准 + 测试场景”的自动化评估流程（“Ralph Loop”式生成-评估-再生成迭代），而非仅靠文档自证
十、安装使用方式
方式一：官方 CLI 向导（面向 GitHub Copilot）
npx skills add microsoft/skills运行后按交互提示勾选 copilot-sdk 即可安装到 .github/skills/ 目录。
方式二：手动复制（可用于尝试接入其他 Agent）
git clone https://github.com/microsoft/skills.git
cp -r skills/.github/skills/copilot-sdk your-project/.claude/skills/安装后注意事项：
- 技能本身只是指导文档，实际调用 SDK 前需按对应语言执行
npm install @github/copilot-sdk（或pip install github-copilot-sdk/go get github.com/github/copilot-sdk/go/dotnet add package GitHub.Copilot.SDK） - 需提前安装并登录 GitHub Copilot CLI，或准备好 BYOK 供应商 API Key
- 复制进 Claude Code 等非官方目标目录后建议先用一个最简示例验证连通性，仓库文档未对此路径做过官方测试
十一、注意事项
- 仓库官方文档与安装向导仅面向 GitHub Copilot CLI/VS Code，未提及对 Claude Code、Codex、OpenClaw、Hermes Agent 的官方支持，跨 Agent 使用需自行验证
- 实际调用 SDK 需要 GitHub Copilot 订阅，或改用 BYOK 方式接入其他供应商并自行承担相应费用，并非零成本
- 该技能所属仓库体量大（133+ 技能），官方明确建议“按需选用而非全量加载”，避免上下文稀释；使用者应只复制自己需要的这一个子目录，而非整仓库导入