Azure API Center .NET 技能
用 .NET 管理 Azure API 清单、治理、版本和部署发现。
技能仅展示 Azure SDK 身份认证、资源创建和规格导入等预期操作，未见恶意行为、凭据窃取或隐蔽外传；但未说明最小 RBAC 权限、用户确认、敏感 API 规格处理、变更影响、回滚或恢复，因此扣分。
覆盖服务、工作区、API、版本、定义、环境、部署、元数据和列表流程，并提供有限的 Azure 异常处理；但没有该技能专属测试、重试/幂等指导，且若干 C# 示例的可编译性存在疑问，因此静态评分保持在 10 分以下。
触发词、.NET 目标 SDK 和主要使用场景较明确；但未声明非适用范围、前置 Azure 资源/RBAC 条件、输入输出边界，也未提供中文支持或中国大陆网络可达性说明，因此扣分。
具备清晰章节、安装命令、环境变量、资源层级、工作流、类型表、最佳实践、错误处理、许可证、作者和版本元数据；但缺少变更日志、维护责任人/更新路径、兼容性说明和已知限制，因此扣分。
内容覆盖 API Center 常见管理任务，示例对熟悉 Azure 的 .NET 开发者有直接参考价值；但示例可能需要修正，缺少端到端验证、权限配置、现有资源处理和完整项目上下文，因此只能评为部分有效。
提供 NuGet、API、产品文档和 GitHub 源码链接，并声明 API/包版本；但本次仅有静态材料，未见该技能专属 CI、提交测试或第三方执行证据，核心示例无法在材料内独立复现，因此分数较低。
- 创建、更新和导入操作可能产生外部 Azure 资源变更或写入 API 规格；使用前应确认目标订阅、资源组、RBAC 权限和回滚方案。
- 示例未提供完整可编译项目，尤其应核验 DefaultAzureCredential 用法、集合初始化语法、包版本与 API 模型。
- 未说明 API 规格、联系人和自定义元数据中的敏感信息如何保护，也未说明中国大陆网络环境下相关文档和 Azure 服务的可达性。
这个 Skill 能做什么，适合哪些场景？
该技能为 Azure.ResourceManager.ApiCenter .NET SDK 提供面向编码代理的操作指南和代码模式。它覆盖 API Center 服务、工作区、API、版本、定义、环境、部署和元数据架构的创建与管理。内容还包括 DefaultAzureCredential 认证、OpenAPI 规范导入导出、API 列表查询及 Azure 异常处理。适合使用 Azure API Center 维护组织级 API 清单和治理流程的 .NET 开发者。
指导代理安装 Azure.ResourceManager.ApiCenter 与 Azure.Identity，读取 Azure 订阅、资源组和 API Center 服务配置，并生成 C# 代码。代码可创建或更新 API Center 服务、工作区、API、API 版本、API 定义、环境、部署和元数据架构；导入或导出 OpenAPI 等 API 规范；遍历工作区中的 API、版本、环境和部署；并处理 400、409 及其他 RequestFailedException 错误。
- 平台团队为组织创建 API Center 服务，并按团队或产品建立工作区。
- .NET 开发者将 API、生命周期阶段、联系人、外部文档和自定义属性登记到 API 清单。
- 治理团队为 API 定义元数据架构，并要求 API 填写团队、成本中心或数据分类。
- 开发团队上传 OpenAPI 规范、管理 API 版本，并导出规范供其他流程使用。
- 运维或平台团队记录开发、测试、预发布和生产环境，并将 API 定义关联到部署。
这个 Skill 有哪些优点和局限？
- 覆盖 API Center 资源层级和主要生命周期操作。
- 提供可复制的 C# 异步示例，包括规范导入导出、部署关联和元数据治理。
- 明确使用 Azure API 版本 2024-03-01、SDK v1.0.0 GA 和 MIT 许可证。
- 包含认证、环境变量、资源类型、最佳实践和常见 Azure 错误处理。
- 内容聚焦 Azure.ResourceManager.ApiCenter .NET，不是通用 API 管理或网关技能。
- 示例依赖 Azure 订阅、资源组和 API Center 服务；源材料未提供本地模拟环境或完整测试套件。
- 源材料未说明除列出的代理安装方式外的其他客户端安装细节。
如何安装这个 Skill？
在支持该集合的环境中运行 npx skills add microsoft/skills，通过向导选择需要的技能。技能会安装到所选代理的目录，例如 GitHub Copilot 使用 .github/skills/；也可以从仓库复制或链接对应技能目录。该技能的源文件位于 .github/plugins/azure-sdk-dotnet/skills/azure-mgmt-apicenter-dotnet/SKILL.md。使用 SDK 时安装：dotnet add package Azure.ResourceManager.ApiCenter 和 dotnet add package Azure.Identity。
如何使用这个 Skill？
在编码代理中提出包含 “API Center”、ApiCenterService、ApiCenterWorkspace、ApiCenterApi、API inventory、API governance、API versioning、API catalog 或 API discovery 的任务。提供 Azure 订阅 ID、资源组名和 API Center 服务名；若使用 DefaultAzureCredential 进行生产认证，还需设置 AZURE_TOKEN_CREDENTIALS=prod 或指定凭据。代理可据此生成使用 ArmClient 的 C# 管理代码。
这个 Skill 与同类方案有什么区别？
与 Azure.ResourceManager.ApiManagement 不同，本技能面向 API Center 的 API 清单、治理、版本、定义、环境和部署登记；源材料将 API Management SDK 定位为 API 网关和策略管理。