azure-resource-manager-cosmosdb-dotnet

azure-resource-manager-cosmosdb-dotnet 技能概览

azure-resource-manager-cosmosdb-dotnet 是 Azure Cosmos DB 的 .NET 管理平面技能。它适用于你需要通过 Azure Resource Manager 来创建或修改 Cosmos DB account、SQL database、container、throughput 和 RBAC，而不是读写文档的场景。它非常适合自动化云端搭建的后端开发团队、平台工程师，以及需要用合适的 Azure SDK 生成基础设施代码的 agents。

这个技能适合做什么

azure-resource-manager-cosmosdb-dotnet 主要面向 control-plane 任务：创建 account、配置 region 和 failover、管理 database 和 container，以及设置 throughput。
如果你的任务是对 item 做 CRUD、执行 query，或者调用 stored procedure，那就不是这个 SDK 的用武之地；这个技能有意不覆盖 data-plane 工作。

什么时候该选它

当你的提示词里出现“create Cosmos account”“provision Cosmos DB”“manage Cosmos resources”或“configure Cosmos throughput”这类表述时，就应该选这个技能。它的核心价值，是减少 Cosmos DB 管理 API 和应用数据 API 之间的混淆——这正是最常见的采用阻力。

关键区别点

azure-resource-manager-cosmosdb-dotnet 最强的信号，是 management plane 和 data plane 的边界。这条边界之所以重要，是因为生成的代码、认证模型和资源对象，都和常规的 Microsoft.Azure.Cosmos SDK 不一样。
当你想要的是 Azure SDK for .NET，而不是一份泛泛的 Azure Portal 操作指南时，这个技能最有用。

如何使用 azure-resource-manager-cosmosdb-dotnet 技能

安装并确认包

如果你是在本地 .NET 项目里使用，先安装底层 SDK：

dotnet add package Azure.ResourceManager.CosmosDB
dotnet add package Azure.Identity

如果你的环境使用 skills manager，先安装 azure-resource-manager-cosmosdb-dotnet skill，然后再用它来梳理代码和 resource model，最后再写正式实现。

先提供正确的输入

一条高质量的 azure-resource-manager-cosmosdb-dotnet 使用请求，应该写清 resource type、API surface、部署目标和约束。例如：
“Create a .NET 8 service that provisions a Cosmos DB SQL database with autoscale throughput, two regions, and managed identity.”
这比“帮我处理 Cosmos DB”好得多，因为技能可以直接映射到正确的 ARM resources。

最值得先看的文件

先读 SKILL.md，然后再看 references/account-management.md、references/sql-resources.md 和 references/throughput.md。这些文件覆盖了会直接影响输出质量的实际选择：account 创建、SQL resource 操作，以及 RU/s 规格配置。
如果你只打算粗看一个 reference，优先看 throughput，因为它往往决定成本和架构。

效果最好的提示词模式

一条有用的 azure-resource-manager-cosmosdb-dotnet 指导性提示，应该包含：

• 目标资源：account、database、container 或 RBAC
• 是否需要手动 throughput 还是 autoscale
• region 数量和 failover 预期
• 认证方式：DefaultAzureCredential、service principal，还是 managed identity
• 你需要的是仅 provisioning code，还是还要包含 update/delete 流程

例如：
“Generate backend setup code for Azure.ResourceManager.CosmosDB that creates a Cosmos DB account in East US and West US, enables automatic failover, creates a SQL database, and uses autoscale at 4000 RU/s.”

azure-resource-manager-cosmosdb-dotnet 技能常见问题

这和 Cosmos DB 数据 SDK 是一回事吗？

不是。azure-resource-manager-cosmosdb-dotnet 只用于 management-plane 操作。它适合做 account 和 resource 管理；而 Microsoft.Azure.Cosmos 才用于应用数据操作，比如 insert、read、query 和 delete。

azure-resource-manager-cosmosdb-dotnet 对后端开发有用吗？

有，尤其适合那些同时负责云端 provisioning、环境初始化或租户创建的后端服务。它能帮助后端代码生成可预测的 Cosmos DB 基础设施，而不是依赖人工在 Portal 里一步步点。

使用它之前需要很强的 Azure 经验吗？

不需要太多，但你至少要知道自己到底要 provision 什么。这个技能能减少 SDK 选择上的猜测，不过你仍然需要决定是 shared throughput、autoscale、multi-region failover，还是 RBAC。

什么时候不该用它？

如果你的工作是文档 CRUD、应用内部的 query 性能调优，或者你要的是 Cosmos DB client library 的示例代码，就不要用 azure-resource-manager-cosmosdb-dotnet。那种情况下，选错 SDK 可能会生成一段能编译、却解决了错误问题的代码。

如何改进 azure-resource-manager-cosmosdb-dotnet 技能

把缺失的设计决策补齐

最好的 azure-resource-manager-cosmosdb-dotnet 输出，来自那些不仅说明目标资源、还说明 account 形态的提示词。要明确写出是否只用 SQL API、需要多少个 region、写入是 single-region 还是 multi-region，以及 throughput 应该是 fixed 还是 autoscale。

先把运行约束说清楚

常见失败模式包括认证信息不完整、缺少 subscription 上下文，以及对 throughput 的要求过于笼统。更好的输入像这样：
“Use managed identity in Azure, target subscription ID provided at runtime, create a SQL database with shared throughput, and avoid preview features.”
这样可以避免技能自己猜。

优先按 resource 迭代，不要整套应用重写

如果第一次结果已经接近目标，改进 azure-resource-manager-cosmosdb-dotnet 的方式，通常是要求它做一个更小的调整：account redundancy、SQL container indexing、throughput migration，或者 RBAC assignment。
这种针对单个 resource 的小改动，通常比要求整套重写更容易产出更好的代码。

在修改默认值之前先读参考文件

改进路径通常是选对 Cosmos DB settings，而不是单纯增加更多代码。需要查看 references/account-management.md 了解 account flags，查看 references/sql-resources.md 了解 database/container 操作；如果你关心成本或扩缩容行为，再看 references/throughput.md。