Azure App Configuration Java 技能
指导 Java 应用集中管理配置、功能开关与发布快照。
文档推荐 Entra ID、展示环境变量认证方式，并提及将敏感值放入 Key Vault；但示例直接打印配置值，且连接字符串、更新、删除、只读状态变更和快照操作没有用户确认、权限最小化、影响范围、审计或回滚说明，因此扣分。
覆盖客户端创建、CRUD、条件请求、异步、错误处理和快照等主要路径，且有状态码处理示例；但未提供该技能专属的可执行测试或编译验证，示例存在导入缺失、版本不一致和截断的完整应用示例，异常处理也有吞错返回 null 的做法，因此扣分。
触发词、Java SDK目标、App Configuration场景和主要能力较清楚；但未明确非适用范围、输入输出边界、版本兼容矩阵或语义误触发条件，也没有中文使用指导。Azure端点可达性和中国大陆网络适配未提供证据，因此扣分。
SKILL.md结构清晰，包含安装、先决条件、环境变量、概念、示例、最佳实践、引用链接，并声明MIT、作者和1.0.0版本；但缺少变更日志、维护责任人和更新路径，引用文档未固定版本，依赖版本在不同文件中不一致，限制与故障排查说明不完整，因此扣分。
提供了大量可直接改写的Java代码，覆盖配置、功能标志、密钥引用、快照和异步操作，能支持核心开发任务；但代码未静态编译验证，完整应用示例被截断，部分片段依赖未声明或导入不全，安全和生产边界仍需较多人工审查，因此扣分。
存在版本元数据、Maven/GitHub/API参考链接，以及仓库级CI和测试材料；但提供材料不是该技能关键路径的专属测试，未见提交的针对性验收套件或第三方执行结果，结论主要依赖文档静态内容，因此扣分。
- 不要将示例中的配置值、连接字符串或密钥引用直接打印到日志；生产环境应确认权限范围并优先使用最小权限的 Entra ID。
- 执行 set、delete、setReadOnly 或快照归档等有外部影响的操作前，应明确确认目标、标签和恢复方案。
- 使用前应核对 azure-data-appconfiguration、azure-identity 与 BOM 的实际兼容版本，并补充编译和集成测试。
- 示例文档未证明其对中国大陆网络、中文工作流或当前服务可达性的适配。
它能做什么 & 适用场景
该技能为使用 Azure App Configuration Java SDK 的编码代理提供操作指引。它覆盖 Maven 依赖、连接字符串与 Entra ID 认证，以及同步和异步客户端创建。开发者可以据此管理带标签的键值设置、功能标志、Key Vault 秘密引用和只读设置。它还涵盖条件请求、修订列表、不可变快照、错误处理与配置发布实践。
提供 com.azure:azure-data-appconfiguration 的 Maven 安装示例；展示使用连接字符串或 Entra ID 创建同步、异步客户端；指导创建、读取、更新、删除和筛选配置设置，使用标签、ETag 条件请求和修订查询；指导管理功能标志、Key Vault 秘密引用、只读设置与配置快照；提供列表、归档、恢复、错误处理和异步订阅示例。
- Java 应用需要按开发、预发布和生产环境使用带标签的集中式配置时。
- 团队需要通过功能标志进行灰度发布或 A/B 测试时。
- 发布流程需要创建不可变配置快照并在必要时归档或恢复时。
- 应用希望使用 Entra ID 替代连接字符串访问 App Configuration 时。
- 系统需要借助 ETag 条件请求避免并发修改覆盖时。
优缺点一览
- 覆盖配置设置、标签、功能标志、秘密引用、快照和并发控制等完整操作面。
- 同时提供同步和异步 Java 客户端示例。
- 包含连接字符串与 Entra ID 两种认证方式，并明确推荐 Entra ID。
- 示例直接使用 Maven 坐标、Azure SDK 类型和常见环境变量。
- 内容聚焦 Azure App Configuration Java SDK，不涵盖其他语言或 Azure 服务的完整实现。
- 来源未说明最低 Java 版本、运行时版本或详细权限角色要求。
- 来源未提供该单个技能的独立测试结果或故障排查案例。
- 示例依赖可访问的 Azure App Configuration store；仅阅读代码不会完成实际配置管理。
如何安装
在项目中运行 npx skills add microsoft/skills，在安装向导中选择 azure-appconfiguration-java。技能会安装到所选编码代理的目录；README 说明也支持手动复制或使用符号链接，但未给出该技能专属的单独安装命令。Java SDK 依赖使用 Maven 坐标 com.azure:azure-data-appconfiguration:1.8.0，或通过 Azure SDK BOM 管理版本。
如何使用
向编码代理提出明确的 Java App Configuration 请求，例如：用 ConfigurationClient Java 创建一个连接到 AZURE_APPCONFIG_ENDPOINT 的 Entra ID 客户端，并读取 Production 标签下的 app/database/connection 设置。也可以请求生成功能标志、条件更新、快照创建或异步列表代码。使用 Entra ID 时，技能示例要求设置 AZURE_APPCONFIG_ENDPOINT；使用 DefaultAzureCredential 的生产环境还需设置 AZURE_TOKEN_CREDENTIALS=prod，连接字符串认证则使用 AZURE_APPCONFIG_CONNECTION_STRING。