Azure API Center Python 管理技能
用 Python 管理 Azure API 清单、元数据与治理。
文档推荐 DefaultAzureCredential、避免密钥，并说明 Azure 订阅 ID 与凭据环境变量；数据流和外部 Azure 资源变更是可见的。但创建、更新和导入操作没有用户确认、最小 RBAC 权限、敏感输入处理、删除/回滚路径或失败后的恢复说明，因此扣分。
主路径示例覆盖服务、API、版本和定义等操作，且强调同步/异步一致性与上下文管理；但未固定依赖版本，未提供错误处理、分页、轮询细节或输入边界。列表示例还存在 api.title/kind 与引用文件中 api.properties.title/kind 的不一致，且认证说明与 require_envvar=True 可能矛盾，因此仅给有限分数。
名称、描述和触发词明确，覆盖 API inventory、metadata 和 governance 场景；但未清楚声明非适用范围、输入输出契约、权限前提、异步使用方式或中文支持。核心功能依赖 Azure 网络可达性，未说明中国大陆网络和区域可用性，因此扣分。
具备 front matter、MIT 许可、作者和 1.0.0 版本，文档分为主技能与 references，并有仓库级维护和 CI 线索；但缺少依赖版本、变更日志、明确维护责任、FAQ、故障排查、已知限制及删除示例，因此未满分。
提供多个可直接改写的 Azure API Center 管理示例，包含幂等风格的 create_or_update 和导入操作，能覆盖核心任务；但示例未证明可运行，缺少完整资源生命周期、错误恢复、权限配置和生产级分页/长操作处理，静态审查下只能接近中等分数。
源文件包含具体 API 调用、引用文档、仓库许可证和 CI/测试基础设施，提供一定审计线索；但没有该技能路径对应的提交测试、真实执行结果或第三方交叉验证，且仓库级测试不能证明本技能正确，因此分数受静态上限和证据缺口限制。
- 认证说明需澄清：DefaultAzureCredential(require_envvar=True) 通常要求 AZURE_TOKEN_CREDENTIALS，但文档同时称本地开发可直接使用且该变量仅生产需要。
- 创建、更新和导入示例会产生外部 Azure 资源变更；使用前应确认订阅、资源组、RBAC 权限和成本，并补充删除或回滚方案。
- 应核对当前 azure-mgmt-apicenter SDK 的模型属性、方法名称、分页和长操作行为；列表示例中的属性访问方式目前不一致。
- 未说明 Azure 中国区域、网络连通性或服务差异；中国大陆用户可能需要额外验证。
它能做什么 & 适用场景
这是一个面向 Azure API Center Management SDK for Python 的 Agent Skill。它指导开发者使用 ApiCenterMgmtClient 管理 API Center、工作区、API、版本、定义、环境和部署。技能还涵盖 API 规范导入、自定义元数据架构以及生命周期管理。它适合已经使用 Azure 和 Python SDK、需要集中管理组织 API 资产的团队。
指导安装 azure-mgmt-apicenter 和 azure-identity，设置 AZURE_SUBSCRIPTION_ID 及生产环境凭据变量；使用 DefaultAzureCredential 或指定凭据创建 ApiCenterMgmtClient；创建和列出 API Center；注册 API、创建版本和定义；从内联内容导入 API 规范；管理环境、部署和自定义元数据架构；建议使用上下文管理器释放客户端、传输、套接字和令牌缓存。
- Azure Python 开发者需要创建或列出组织中的 API Center 服务时。
- API 平台团队需要登记 API、版本和 OpenAPI 定义时。
- 治理团队需要通过自定义元数据架构统一数据分类等 API 属性时。
- 运维或平台团队需要记录 API 部署环境、运行地址和部署状态时。
- 团队需要使用生命周期阶段、联系人和工作区组织 API 资产时。
优缺点一览
- 覆盖 API Center 的主要管理对象，包括 API、版本、定义、环境、部署和元数据架构。
- 提供同步客户端示例，并明确 DefaultAzureCredential、生产凭据约束和上下文管理器用法。
- 包含从内联内容导入 API 规范的具体示例。
- MIT 许可，且仓库说明其处于持续开发和测试扩展阶段。
- 内容聚焦 Azure API Center Management SDK，不是通用 API 网关或 API 运行时开发指南。
- 示例主要展示同步用法；虽然说明了异步规则，但没有给出完整异步操作示例。
- 源材料没有提供该单项技能的独立测试覆盖或失败处理示例。
- 使用前需要 Azure 订阅、凭据配置以及 Python SDK 依赖。
如何安装
安装整个仓库的技能集合：运行 npx skills add microsoft/skills，在向导中选择需要的技能。集合会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/，并可在多个 Agent 间建立符号链接。该技能位于 .github/plugins/azure-sdk-python/skills/azure-mgmt-apicenter-py/SKILL.md。运行项目代码前，安装依赖：pip install azure-mgmt-apicenter 和 pip install azure-identity。
如何使用
在支持该技能的编码 Agent 中提出包含触发词的请求，例如：“使用 azure-mgmt-apicenter 和 ApiCenterMgmtClient 注册一个 API，并创建 v1 版本。”确保设置 AZURE_SUBSCRIPTION_ID；若使用生产环境的 DefaultAzureCredential，设置 AZURE_TOKEN_CREDENTIALS=prod 或指定凭据。技能没有规定独立的命令行调用方式。