Azure 应用配置 Python 技能
为 Python 应用集中管理配置、功能标志和动态设置。
文档推荐 DefaultAzureCredential、Entra ID、生产环境凭据限制，并提示上下文管理器和快照回滚，降低密钥暴露与资源泄漏风险；但写入、删除、只读锁定等外部变更没有用户确认、权限范围、敏感配置处理或恢复步骤，因此扣分。
主路径覆盖认证、读写、列表、特性标志、异步和快照，并给出部分生命周期指导；但两个快照示例使用不一致的类型名（ConfigurationSettingFilter 与 ConfigurationSettingsFilter），缺少异常、重试、分页和输入失败反馈，且未静态执行验证，因此不超过10分并明显扣分。
名称、包名、场景和触发词较明确，覆盖同步、异步、配置和特性标志；但非适用边界、SDK版本兼容范围、权限前置条件、中文支持及中国大陆网络可达性未说明，因此扣分。
具备前置元数据、安装说明、环境变量、分层参考文件、操作表、最佳实践和 MIT 许可；但缺少明确维护责任、变更日志、版本兼容策略、故障排查和完整清理示例，因此扣分。
可直接作为常见 App Configuration 代码生成的起点，包含认证、配置项、特性标志和快照示例；但 API 类型不一致、缺少完整错误处理与验证，输出仍需人工核对，边际收益和直接可用性有限，因此扣分。
技能文件包含具体代码和 API 名称，仓库还提供通用 CI、评估工作流及测试工具；但没有该技能专属的提交测试、真实执行结果或第三方交叉证据，结论仅能有限静态复核，因此扣分。
- 快照参考示例中的 ConfigurationSettingFilter 与 ConfigurationSettingsFilter 类型名不一致，编码前应核对当前 SDK API。
- 文档包含删除、写入和锁定配置等有外部影响的操作，但未规定确认、最小权限、审计和失败恢复流程。
- 未提供该技能专属测试或执行结果，示例代码需要人工验证；也未说明中国大陆网络可达性和中文使用边界。
它能做什么 & 适用场景
该技能为 Azure App Configuration Python SDK 提供可直接参考的开发模式。它涵盖配置项的读取、创建、更新、删除、筛选，以及功能标志、只读设置和配置快照。内容同时包含同步与异步客户端示例，并建议使用 DefaultAzureCredential、上下文管理器和 Entra ID。它适合需要将应用设置集中存储并支持环境隔离或渐进式发布的 Azure Python 项目。
指导安装 azure-appconfiguration，配置 Azure App Configuration 终结点和凭据，并调用 AzureAppConfigurationClient 读取、写入、删除和列出配置项。它演示按键前缀或标签筛选设置、创建和读取功能标志、锁定或解除只读状态、创建快照以及列出快照设置。它还展示同步客户端和 azure.appconfiguration.aio 异步客户端的生命周期管理。
- 为需要在开发、预发布和生产环境之间分离设置的 Python 团队使用标签管理配置值。
- 为需要集中存储应用消息、数据库或缓存设置的 Azure Python 服务使用键前缀组织配置。
- 为需要渐进式发布或 A/B 测试的团队创建和读取 Azure App Configuration 功能标志。
- 为需要在部署前保存回滚点的团队创建配置快照。
- 为希望使用 Entra ID 而不是连接字符串管理访问权限的生产应用提供凭据和客户端生命周期模式。
优缺点一览
- 覆盖配置项、标签、键前缀、功能标志、只读设置和快照等具体操作。
- 同时提供同步和异步客户端模式。
- 明确推荐 DefaultAzureCredential、Entra ID 和确定性资源释放。
- 包含适合部署和回滚流程的生产实践建议。
- 仅面向 Azure App Configuration Python SDK，不是通用配置系统指南。
- 示例依赖 Azure 终结点、凭据和网络连接。
- 源材料没有提供该单项技能的独立测试结果或完整错误处理示例。
- 高级内容部分放在未随提示提供的 references 文件中。
如何安装
安装技能集合：运行 npx skills add microsoft/skills，并在向导中选择所需技能。集合中的技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用的 .github/skills/，并可在多个 Agent 间建立符号链接。安装 Python SDK：运行 pip install azure-appconfiguration。源材料未说明单独安装 azure-identity 的命令。
如何使用
在支持 Agent Skills 的编码代理中提出类似“使用 azure-appconfiguration 为 Python 应用实现带 production 标签的配置读取和功能标志管理”的请求。代码中设置 AZURE_APPCONFIGURATION_ENDPOINT，并按需设置 AZURE_TOKEN_CREDENTIALS=prod；使用 DefaultAzureCredential 和 with AzureAppConfigurationClient(...) 管理客户端。异步代码使用 azure.appconfiguration.aio 的客户端和 azure.identity.aio 的 DefaultAzureCredential，并使用 async with。