1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Azure SQL Managed Instance（MicrosoftDocs/Agent-Skills） |
| 作者/维护者 | Microsoft（MicrosoftDocs 官方文档团队） |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-sql-managed-instance |
| 许可证 | 双许可：文档 CC-BY-4.0（Creative Commons 署名 4.0）、代码 MIT（GitHub API 确认） |
| GitHub Stars | 717（合集仓库整体数字，非本技能单独热度；GitHub API 获取） |
| Forks | 117（合集仓库整体，GitHub API 获取） |
| 最新版本 | 无独立版本号；SKILL.md 元数据标注 generated_at: 2026-08-16，目录最近一次提交 2026-08-17 |
| 安装方式 | Claude Code / Codex 插件市场一键安装，或手动复制到各 Agent 的 skills 目录 |
2. 功能介绍与亮点
该技能为 Azure SQL Managed Instance（微软托管的 SQL Server 引擎服务）提供结构化官方指导，正文按 Troubleshooting、Best Practices、Decision Making、Architecture & Design Patterns、Limits & Quotas、Security、Configuration、Integrations & Coding Patterns、Deployment 九大主题组织，无一缺项。内容覆盖容量/连接/性能/备份故障诊断、Entra Kerberos 认证问题排查，选型决策（Managed Instance 与其他 Azure SQL 方案的取舍、从 SQL Server/Oracle/Db2 迁移规划），网络架构（网关、终结点、防火墙、VNet 私有访问），备份不可变性、DTU 基准与内存/OLTP 上限等配额说明，身份认证、TDE 与 Key Vault、TLS、审计、威胁防护、Windows/Kerberos 认证等安全加固，故障转移组、维护窗口与可修改配置项，多语言客户端连接与代码示例，直至 Managed Instance Link 与规模伸缩、启停控制成本、跨区域迁移等部署运维全流程。
正文内嵌 184 条 Microsoft Learn 官方文档直链，内容体量（36,506 字节、254 行）在仓库内同类数据库技能中显著领先同仓库的 azure-database-mysql（22KB/112 链接）与 azure-sql-virtual-machines（23KB/98 链接）。目录最近一次提交为 2026-08-17，与仓库整体最近推送同步；技能同时支持通过 MCP microsoftdocs 工具或 fetch_webpage 兜底方式实时抓取最新版本的官方文档。
主要亮点：官方 Microsoft 出品、九大主题框架全覆盖无缺项、内容体量与文档直链数量在同仓库同类数据库技能中居首、按标题精确检索该仓库全部 open issue 未发现任何质量投诉。
3. 适用场景
所属分类：数据分析与可视化
面向使用 AI Agent 辅助运维 Azure SQL Managed Instance 的数据库工程师与平台工程师：在诊断连接/性能/备份故障，规划从本地 SQL Server、Oracle 或 Db2 迁移至 Managed Instance，配置网络终结点与 VNet 私有访问，设置 Entra/Kerberos 认证与 TDE 加密，或规划 Managed Instance Link 混合部署与跨区域灾备等场景中，可直接调用该技能获取结构化的官方最佳实践，减少在 Microsoft Learn 零散页面间来回查找的时间。
4. 跨 Agent 兼容性
- Claude Code：原生支持 ✅——仓库官方 README 列出一键命令
/plugin marketplace add MicrosoftDocs/agent-skills，随后/plugin install azure-agent-skills@microsoft-agent-skills - Codex：原生支持 ✅——官方提供
codex plugin marketplace add MicrosoftDocs/agent-skills命令，随后从插件列表安装 azure-agent-skills - OpenClaw：未验证 ❓——官方支持列表未列出该平台；技能遵循开放 Agent Skills 规范（纯 SKILL.md + Markdown），理论上可手动复制适配，但未获官方确认
- Hermes Agent：未验证 ❓——同上，官方列表未包含，需自行验证兼容性
（依据：仓库根目录 README.md 明确列出 Claude Code、GitHub Copilot、OpenAI Codex、Cursor、Gemini CLI、Antigravity IDE、OpenCode、AdaL CLI 共 8 款受支持平台。）
5. 推荐理由
官方 Microsoft 出品，内容严格对齐 Azure SQL Managed Instance 官方文档的九大知识类目，无一缺项；184 条官方文档直链与 36.5KB 正文体量在同仓库同类数据库技能中居首，覆盖故障诊断、选型决策、网络架构、安全加固与部署迁移全流程。适合正在评估或已运行 Managed Instance、需要快速定位配置/迁移/合规问题标准答案的数据库与平台团队接入 AI Agent 工作流。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 该技能由 Microsoft 官方发布（Microsoft 是 Azure SQL Managed Instance 所属产品的所有方）；除合集仓库整体的 717 星外，未检索到该子技能自身独立于合集仓库之外的第三方讨论或采用数据 |
| 可用性 | 9 | SKILL.md 正文九大官方主题类目全部覆盖（Troubleshooting 至 Deployment 无缺项），含 184 条 Microsoft Learn 官方文档直链，为同仓库同类数据库技能中体量最大者；目录最近一次提交 2026-08-17；插件市场一键安装或手动复制两种途径均可用，无付费依赖 |
| 安全性 | 9 | 详见下方检查清单，纯文档指引类技能，无代码执行与可疑外发行为 |
安全检查清单：
① Shell 命令执行：无——技能本身不含可执行脚本，仅为结构化文档索引与指引文本
② 联网外发：有条件外联——按需通过 MCP microsoftdocs 工具或 fetch_webpage 抓取 Microsoft Learn 官方文档页面以获取最新内容，目标域名透明（learn.microsoft.com），无第三方或不明域名
③ API key/凭据：不索取——技能本身不要求任何密钥或凭据；正文涉及的 Entra 身份认证、TDE/Key Vault 等内容是关于 Azure SQL Managed Instance 产品本身的安全配置说明，不是技能对使用者的索取
④ 可疑指令：无——正文“IMPORTANT for Agent”提示仅为过期提醒（建议内容超过 3 个月未更新时拉取新版本）与文档检索路径说明，不含品牌植入或越权指令
⑤ 作者信誉：MicrosoftDocs 为 Microsoft 官方文档发布账号，提交记录清晰，按标题精确检索仓库全部 open issue（当前仅 2 条，均与本技能无关）未见任何针对本技能的质量投诉
⑥ License：CC-BY-4.0（文档）/ MIT（代码），明确
⑦ 最近维护：仓库整体最近一次提交 2026-08-17，该技能自身目录最近一次提交同为 2026-08-17，处于活跃维护窗口内
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
| azure-database-mysql（同仓库同类技能，Microsoft 官方出品） | Azure Database for MySQL（托管 MySQL Flexible Server）九大主题官方指南 | 面向 MySQL 而非 SQL Server 引擎，产品复杂度与内容体量均小于 Managed Instance（22KB/112 链接 vs 36.5KB/184 链接）；两者服务不同数据库引擎、SKILL.md description 互相注明各自不适用场景以便路由 |
| azure-sql-virtual-machines（同仓库同类技能，Microsoft 官方出品） | 在 Azure 虚拟机上自建 SQL Server（IaaS 模式）的九大主题官方指南 | 面向完全自管的 IaaS 部署模式（Always On、FCI、SQL IaaS Agent），需要用户自行承担底层 VM 运维；Managed Instance 是介于自建 VM 与全托管 SQL Database 之间的 PaaS 折中方案，运维负担更低 |
| azure-database-postgresql（同仓库同类技能，Microsoft 官方出品） | Azure Database for PostgreSQL（托管 PostgreSQL Flexible Server）九大主题官方指南 | 面向 PostgreSQL 而非 SQL Server 引擎，两者数据库语法、迁移路径与生态工具链均不同；SKILL.md description 互相注明各自不适用场景以便路由 |
8. 用户评价
Azure SQL Managed Instance 技能包本身目前在第三方平台尚无可核实的具名用户评价：按标题与正文精确检索 MicrosoftDocs/Agent-Skills 仓库全部 open issue 未见任何提及该技能（仓库当前仅 2 个 open issue，均与本技能无关）；公开检索到的内容均为 Azure SQL Managed Instance 底层产品本身的功能讨论，非对该技能包的独立评价，未采用。
9. 其他补充
该仓库整体按 Compute、集成、数据与分析、AI/ML、安全与身份、网络、基础设施、管理、专项等类别组织了 200 余个同结构技能，覆盖 Azure 几乎全部主流服务。SKILL.md 的 description 字段中明确注明本技能不适用于 Azure SQL Database（应改用 azure-sql-database）、SQL Server on Azure Virtual Machines（azure-sql-virtual-machines）、Azure Cosmos DB（azure-cosmos-db）、Azure Data Factory（azure-data-factory）等相邻技能，便于 agent 按目标服务在几个相近技能间正确路由，避免误用。
10. 安装使用方式
- Claude Code：运行
/plugin marketplace add MicrosoftDocs/agent-skills，再运行/plugin install azure-agent-skills@microsoft-agent-skills，安装后插件市场会拉取仓库内全部 Azure 技能，随后可按需触发azure-sql-managed-instance（安装后无需重启，立即可用） - Codex：运行
codex plugin marketplace add MicrosoftDocs/agent-skills，同样从/plugins安装 azure-agent-skills 后按需调用 - 其他 Agent（Cursor / Gemini CLI / Antigravity IDE / OpenCode / AdaL CLI）：手动克隆仓库，将
skills/azure-sql-managed-instance目录复制到各自的技能目录（如.cursor/skills/、.gemini/skills/） - 完整获取最新文档内容需要网络访问权限，供 Agent 调用 MCP
microsoftdocs工具或fetch_webpage抓取最新 Microsoft Learn 页面；离线状态下仍可使用本地缓存的九大主题摘要内容
11. 注意事项
- 通过插件市场安装时会一次性拉入 MicrosoftDocs/Agent-Skills 仓库内全部 200 余个 Azure 技能；若只需要 Managed Instance 相关内容，可改用手动复制方式仅引入本技能目录
- 技能正文列出的具体文档链接需联网抓取才能获取完整内容，纯离线环境下只能使用九大类目的摘要级信息
- 技能明确不涵盖其他数据库引擎与部署模式（Azure SQL Database、Azure Virtual Machines 上的 SQL Server、Cosmos DB、Data Factory），误用场景需切换到仓库内对应的专用技能