用途：为 Azure Cosmos DB 应用的编写、审查与重构提供性能优化准则。资料称包含 12 个类别、100+ 条规则，按影响优先级排序，供自动化重构和代码生成参考。
主要能力与规则分类：数据建模（CRITICAL，model-）、分区键设计（CRITICAL，partition-）、查询优化（HIGH，query-）、SDK 最佳实践（HIGH，sdk-）、索引策略（MEDIUM-HIGH，index-）、吞吐与扩展（MEDIUM，throughput-）、全局分发（MEDIUM，global-）、监控与诊断（LOW-MEDIUM，monitoring-）、设计模式（HIGH，pattern-）、开发工具（MEDIUM，tooling-）、向量搜索（HIGH，vector-）、全文检索（HIGH，fts-）。
规则示例：数据建模要求将一起读取的数据内嵌、控制项目在 2MB 限制内、遵守 ID 与 128 层嵌套限制、注意 IEEE 754 数值精度、做反规范化与模式版本化；分区键要求高基数、避免热点、可用分层分区键、长度限制、20GB 逻辑分区规划，并提到可用 Change partition key 功能重新分区。
查询方面：减少跨分区查询、只投影所需字段、用 continuation token 分页、避免全容器扫描、使用参数化查询、TOP 用字面量整数而非参数、已知 id 与分区键时用点读 ReadItem。SDK 方面：CosmosClient 复用为单例、使用异步 API、429 按 retry-after 重试、生产用 Direct 模式、配置首选与排除区域、用 ETag 乐观并发、用 CosmosPatchOperations.increment() 原子自增、.NET 使用 Microsoft.Azure.Cosmos 包等。
使用方式：资料建议直接引用上列规则文件，规则文件含原因说明、错误与正确代码示例及参考。适用场景：设计数据模型与分区键、优化查询、实现 SDK 模式、使用模拟器、向量搜索与 RAG、代码性能审查、吞吐配置与全局分发。限制：具体阈值、配置细节与代码示例须以各规则文件为准；本条资料未提供安装命令与收费信息。