Microsoft Agent Skills（微软智能体技能库）

# Microsoft Agent Skills：安装说明

这个工具包里是 Mindket 写的安装说明，不包含技能、自定义智能体、提示词、AGENTS.md 模板或 MCP 配置。这些要从微软的仓库安装：https://github.com/microsoft/skills

许可证：MIT，Copyright (c) Microsoft Corporation。全文见 https://github.com/microsoft/skills/blob/main/LICENSE

Microsoft Agent Skills 由微软制作。Mindket 只是收录它，并不是微软。README 开头有一条说明：这个仓库仍在积极开发中，还在添加更多技能，并更新已有的技能。

这些说明的来源：README（https://github.com/microsoft/skills/blob/main/README.md），AGENTS.md 模板（https://github.com/microsoft/skills/blob/main/Agents.md），Claude Code 插件市场文件（https://github.com/microsoft/skills/blob/main/.claude-plugin/marketplace.json），https://github.com/microsoft/skills/tree/main/.github/plugins/azure-skills 下 azure 插件的 README 和钩子文件，以及大约二十个 SKILL.md 文件，其中有 azure-prepare、azure-validate、azure-deploy、microsoft-foundry、microsoft-docs、mcp-builder 和 skill-creator。仓库里的技能远比 Mindket 读过的多。所有命令都由 Mindket 照抄，一条也没有运行过。

## 它是什么

一个技能、自定义智能体、提示词和 MCP 配置的库，给使用 Azure SDK 和 Microsoft Foundry（微软的 AI 智能体平台）的编程智能体用。README 对技能总数给出了不止一个数字，所以 Mindket 不给数字。技能是一个带 SKILL.md 说明文件的文件夹，你的请求和它对得上时，智能体就会读取它。

README 把它们分成这几类：

- 核心技能，用于不限语言的工具和基础设施：cloud-solution-architect、copilot-sdk、debugview、entra-agent-id、frontend-design-review、github-issue-creator、github-primer-brand、mcp-builder、podcast-generation 和 skill-creator。
- Foundry 技能，通过 azd 和 az 命令行工具以及 Foundry MCP 服务器工作：一个名叫 microsoft-foundry 的路由技能，以及管项目、模型、托管智能体、工具箱、工作流、知识库、托管技能、记忆、可观测性和治理的技能。
- 五种语言里每个 Azure SDK 包一个技能，名字带后缀：-py 代表 Python，-dotnet 代表 .NET，-ts 代表 TypeScript，-java 代表 Java，-rust 代表 Rust。例如 azure-identity-py、azure-cosmos-db-py 和 azure-ai-projects-py。
- 五个按角色划分的智能体（backend、frontend、infrastructure、planner、presenter），四个提示词模板，一个 AGENTS.md 模板，以及一个 MCP 服务器参考文件。

README 自己的提醒：“Use skills selectively. Loading all skills causes context rot: diluted attention, wasted tokens, conflated patterns. Only copy skills essential for your current project.”（有选择地使用技能。全部加载会导致上下文腐化：注意力被稀释、浪费 token、写法混在一起。只复制当前项目必需的技能。）

## Claude Code 插件市场文件里的 13 个插件

| 插件 | 内容（插件市场文件的原话，有删节） |
|---|---|
| deep-wiki | 为代码仓库生成 wiki，带 Mermaid 图和源码引用 |
| azure | 用于云资源、部署和 Azure 服务的 Azure MCP 与技能。README 说它复制自 microsoft/github-copilot-for-azure |
| azure-sdk-python | Python 的 Azure SDK 写法 |
| azure-sdk-dotnet | .NET 的 Azure SDK 写法 |
| azure-sdk-typescript | TypeScript 和 Node.js 的 Azure SDK 写法 |
| azure-sdk-java | Java 的 Azure SDK 写法 |
| azure-sdk-rust | Rust 的 Azure SDK 写法 |
| azure-kusto-graph-skills | 面向 Azure Data Explorer 的 Kusto 图分析、IRQL 安全狩猎和图可视化 |
| azure-local-skills | Azure Local 部署，包括标准部署和多机架部署 |
| foundry-iq-skills | 创建 Foundry IQ 知识库并从中检索，再接上一个智能体 |
| azure-cost | Azure 成本分析、估算、优化和治理 |
| aks-skills | AKS 故障排查、成本、已知问题、GPU 推理和抓包 |
| azure-advisor | Azure Advisor 建议、服务停用影响和修复指导 |

来源：.claude-plugin/marketplace.json。这个插件市场的名字是 skills。Copilot CLI 的插件市场文件 .github/plugin/marketplace.json 列出了这 13 个，外加第十四个 microsoft-foundry。

## 工具包里的文件

- setup/claude-code.md：插件命令，以及 Claude Code 的技能文件夹
- setup/github-copilot.md：Copilot CLI 命令和 .github/skills 文件夹
- setup/other-agents.md：npx skills 向导，以及 README 的复制和链接命令
- setup/azure-plugin.md：azure 插件需要什么、安装什么、记录什么
- setup/first-run.md：少挑几个技能、文档优先的规则，以及三个 Azure 部署技能

## 你先要准备的

- 一个编程智能体。README 点名的是 GitHub Copilot CLI 和 VS Code 里的 GitHub Copilot，它的复制命令也照顾到了 Claude Code 和 OpenCode。
- Node.js，npx skills 命令要用。azure 插件需要 Node.js 22 或更高版本。
- Git，手动路线要用。
- azure 插件需要：一个 Azure 账号，以及用 az login 登录好的 Azure CLI。它的钩子用 bash 运行。
- 部署技能需要：Azure Developer CLI（azd），因为 azure-deploy 会运行 azd up 或 azd deploy。azure-validate 用 pwsh（PowerShell）运行检查脚本，在 macOS 和 Linux 上用 bash。
- Foundry 技能需要：Microsoft Foundry 的访问权限。README 称 Foundry 智能体平台为预览版。

## 什么装到哪里

- npx skills：你挑的技能，装进你的智能体的技能文件夹。
- 插件：插件的文件由智能体自己保管。13 个里有 7 个还带 Claude Code 钩子和一个 .mcp.json 文件，不过 aks-skills 和 foundry-iq-skills 的这个文件没有列出服务器（见 setup/azure-plugin.md）。
- 手动复制：只有你复制的技能文件夹，别的都没有。

## 你的数据

技能是文本，本身不会发送任何东西。插件就不一样了：

- 七个插件（azure、aks-skills、azure-advisor、azure-cost、azure-kusto-graph-skills、azure-local-skills 和 foundry-iq-skills）带有一个 Claude Code 钩子文件，会在会话开始时和每次使用工具后运行 track-telemetry 脚本。azure 插件的 README 写了退出方式（见 setup/azure-plugin.md）。Mindket 只读过 azure 插件的脚本。
- azure 插件通过 npx 启动 Azure MCP 服务器，它的 README 提醒 npx 会沿用你的 .npmrc 设置，所以只在可信的设备上安装。
- 语言插件 azure-sdk-python、azure-sdk-dotnet、azure-sdk-typescript、azure-sdk-java 和 azure-sdk-rust，以及 deep-wiki，在仓库里没有钩子文件，也没有 MCP 配置。
- microsoft-foundry 只列在 Copilot 的插件市场文件里，没有钩子文件。它的 .mcp.json 通过 npx 启动 Azure MCP 服务器，并连接两个远程服务器：https://mcp.ai.azure.com 和 https://learn.microsoft.com/api/mcp。
- 你交给智能体的东西，比如代码和日志，会像其他会话一样发到智能体自己的服务。

## 更新和删除

README 没有给出更新或删除的步骤。setup/claude-code.md 写了 Claude Code 自己的文档对插件给出的做法。

README.md  7 KB
setup/azure-plugin.md  4 KB
setup/claude-code.md  3 KB
setup/first-run.md  4 KB
setup/github-copilot.md  2 KB
setup/other-agents.md  3 KB