microsoft/skills

Microsoft / skills – 面向 Azure 驱动的 AI 编码代理的代理技能

是什么 – 一个精心挑选的 “技能” 集合，包含即用型代码片段、配置模板和小型插件，用于教导 AI 编码代理（例如 GitHub Copilot CLI、VS Code 中的 Copilot）如何流畅地使用 Microsoft Azure 服务、Microsoft Foundry 平台以及众多其他 Microsoft SDK。每个技能都位于独立的文件夹中（例如 azure-cosmos-db-py/），可安装到代理的 .github/skills/ 目录中，使代理能够调用相应的 SDK、生成样板代码或执行常见操作，而无需您手动编写底层代码。

为何重要

为代理提供领域知识 – 大型语言模型代理已经了解 Azure SDK 的结构，但需要正确的 激活上下文 才能浮现正确的模式。技能提供了这种上下文，将通用 LLM 转变为专业的 Azure 开发者。
即插即用 – 超过 170 个技能覆盖 Azure 核心服务（Cosmos DB、Storage、Event Grid 等）、AI 服务（OpenAI、Vision、Speech）、Microsoft 365 以及新的 Foundry 代理平台。仅安装您需要的技能，保持代理的提示大小较小，token 预算高效。
一致的工具链 – 技能还附带 MCP（Model-Control-Plane）服务器模板、自定义代理和 AGENTS.md 配置文件，为您提供可重复的方式，为后端、前端、基础设施或规划角色创建代理。

快速入门（一行命令）

npx skills add microsoft/skills   # 启动向导以选择您想要的技能

向导会将选定的技能文件夹复制到您的项目中（例如 .github/skills/azure-cosmos-db-py/），并在多个代理共享相同技能时创建符号链接。

替代方案：克隆仓库并手动复制所需文件夹，或在多项目设置中创建符号链接。

仓库的核心组件

组件	提供的内容
技能目录（约 175 个技能）	针对 Azure SDK、Foundry API 和其他 Microsoft 服务的即用型、语言特定的封装。每个技能包含示例代码、`skill.md` 描述和可选的 MCP 服务器骨架。
插件	小型 npm/py/nuget 包（例如 `deep-wiki`、`azure‑skills`），可添加到代理运行时以暴露额外工具。
自定义代理	面向角色的代理模板（后端、前端、基础设施、规划者），包含预填充的 `AGENTS.md` 文件，告诉代理如何行为。
MCP 配置	针对文档查找、网络搜索、代码解释器和 A2A 工具编排等的预配置 Model-Control-Plane 服务器。
文档与技能探索器	一个 Web UI（`https://microsoft.github.io/skills/`），列出所有技能，提供一键安装按钮，并链接到详细使用文档。

典型使用场景

加速 Azure SDK 开发 – 添加 azure-storage-blob-py，让 Copilot 立即生成正确的 Blob 存储 CRUD 代码。
构建 Foundry 托管代理 – 使用 foundry-hosted-agents 技能，搭建一个容器化代理，注册到 Foundry MCP，获取自己的 Entra 身份，并可通过 Foundry API 调用。
为代理创建长期记忆 – 安装 foundry-memory，为代理提供一个跨会话持久存在的知识存储。
强制执行治理 – 部署 foundry-governance，为一整套代理设置 RBAC、路由策略和负责任的 AI 检查。
生成生产就绪的骨架 – 将 fastapi-router-py 与存储技能结合，快速启动一个完全类型化的 FastAPI 服务，具备认证和数据持久化功能。

适合谁使用

在 Azure 上构建 AI 辅助工具的开发者，希望其 Copilot/Foundry 代理能开箱即用地理解 Azure 特定模式。
DevOps / 平台工程师，需要在多个仓库或团队间重复使用、版本控制的技能集。
机器学习工程师，利用 Azure AI 服务（OpenAI、Vision、Speech），希望代理能生成正确的 SDK 调用。
产品团队，希望通过 cloud-solution-architect 技能强制执行一致的架构（例如，符合良好架构的云解决方案）。

获取帮助 / 贡献

测试与 CI – README 顶部的徽章显示每个技能都经过测试框架和 Copilot-SDK 评估工作流的验证。
贡献 – 仓库标记为 进行中；您可以提交 PR 来添加新技能、改进文档或扩展测试覆盖率。
文档 – 完整文档位于 https://microsoft.github.io/skills/（安装指南、技能目录、API 参考）。

TL;DR

microsoft/skills 是一个 真实且积极维护 的工具箱，通过提供数百个即插即用的“技能”（代码模板、MCP 服务器、配置文件），将通用 AI 编码代理转变为精通 Azure 的助手。仅安装您需要的技能，保持代理上下文简洁，并让代理立即生成正确的 Azure SDK 代码。

链接

仓库： https://github.com/microsoft/skills
技能探索器 UI： https://microsoft.github.io/skills/
博客文章（上下文驱动开发）： https://devblogs.microsoft.com/all-things-azure/context-driven-development-agent-skills-for-microsoft-foundry-and-azure/

microsoft/skills