Azure 应用配置 TypeScript 技能
帮助 TypeScript 应用集中管理配置、功能开关和动态刷新。
技能展示了端点认证、DefaultAzureCredential、Managed Identity、Key Vault 引用和只读 RBAC 建议，部分体现了最小权限与数据流；但包含连接字符串/Secret 环境变量示例，未说明敏感值保护、数据外传边界、用户确认、删除/写入操作的回滚或失败恢复，因此扣分。
CRUD、Provider、刷新、特性标志、快照和标签示例内部基本一致，且说明了若干认证模式；但未提供异常处理、输入校验、网络故障反馈、刷新失败行为或依赖版本约束。仓库存在通用测试与 CI，但没有该技能的专门覆盖，按静态校准不超过10分。
描述明确覆盖 TypeScript 应用中的集中配置、特性标志、Key Vault 引用和动态刷新，示例覆盖低级客户端与 Provider；但未明确不适用场景、触发排除条件、权限前提或生产环境边界，也未提供中文使用说明。核心依赖 Azure 服务，网络可达性和区域限制未说明，因此扣分。
SKILL.md 结构清晰，包含安装、环境变量、认证、功能示例、最佳实践，并声明 MIT、作者和1.0.0版本；但缺少变更记录、维护责任和更新路径、故障排查、兼容版本、已知限制及完整参数说明，因此扣分。
内容能为常见 App Configuration 集成提供可直接改写的代码片段，覆盖面较广；但示例缺少完整应用上下文、错误处理、部署/RBAC 配置和验证结果，部分代码依赖未说明，用户仍需进行较多审查和适配，因此未给高分。
源文件提供了可审阅的代码示例和仓库级 CI/测试线索，但没有该技能专属测试、验收标准、第三方执行结果或多来源交叉验证；结论主要依赖静态文档，故仅给有限分数。
- 不要将连接字符串、Secret 或解析后的 Key Vault 值硬编码、打印或提交到版本库；优先使用托管身份和明确的只读 RBAC。
- 写入、删除、锁定/解锁及快照归档操作会产生外部状态变化，使用前应增加用户确认、权限检查、审计和可恢复方案。
- 示例未经执行验证；应针对实际 SDK 版本、Azure 权限、网络条件和刷新/故障场景补充测试。
它能做什么 & 适用场景
该技能面向使用 Azure App Configuration JavaScript SDK 的 TypeScript 开发者。它涵盖配置项的增删改查、标签、只读锁定、快照和并发更新。它还介绍高层配置提供程序、动态刷新、Key Vault 引用以及功能开关评估。适合需要集中式运行时配置管理的 Azure 应用，但源材料没有提供独立测试套件或平台验证信息。
指导开发者安装 Azure App Configuration 相关 npm 包，配置终结点或连接字符串，并使用 DefaultAzureCredential、托管身份凭据或连接字符串创建客户端。它提供读取、创建、更新、删除和筛选配置项的 TypeScript 示例，包括标签、只读状态和乐观并发控制。它还展示如何加载配置对象、触发动态刷新、监听刷新事件、解析 Key Vault 引用、创建和评估功能开关，以及创建、读取、归档、恢复和加载快照。
- Azure 应用开发者需要按环境集中存储和筛选配置项时。
- TypeScript 服务需要在运行期间刷新配置，而不希望每次变更都重启应用时。
- 团队需要使用功能开关及用户或群组定向发布功能时。
- 应用需要从 Azure App Configuration 加载 Key Vault 引用并自动解析密钥时。
- 发布团队需要保存不可变的版本配置快照并支持归档或恢复时。
优缺点一览
- 覆盖低层 CRUD SDK 和面向应用的高层配置提供程序。
- 包含动态刷新、Key Vault 引用、功能开关和快照等常见配置场景。
- 示例包含标签筛选、乐观并发控制和 RBAC 读取角色建议。
- 采用 MIT 许可，来源仓库持续维护并处于积极开发中。
- 内容主要是代码片段和最佳实践，没有给出完整应用项目或端到端测试套件。
- 示例依赖 Azure 资源、凭据和网络连接；本地环境配置细节有限。
- 没有提供性能、成本或故障恢复方面的实测数据。
- 技能只针对 TypeScript/JavaScript SDK，不应替代其他语言技能。
如何安装
在技能安装向导中运行 npx skills add microsoft/skills，然后选择 azure-appconfiguration-ts。README 说明技能会安装到所选代理的目录，例如 GitHub Copilot 使用 .github/skills/；也可以手动获取仓库并复制目标技能目录。该技能所需的 npm 包为 @azure/app-configuration、@azure/app-configuration-provider、@azure/identity 和可选的 @microsoft/feature-management。
如何使用
将技能放入代理可发现的技能目录后，可使用类似“请用 TypeScript 和 Azure App Configuration 实现带 production 标签的配置加载、动态刷新和 Beta 功能开关评估”的请求触发它。应用侧需要设置 AZURE_APPCONFIG_ENDPOINT 或 AZURE_APPCONFIG_CONNECTION_STRING；若生产环境使用 DefaultAzureCredential，还需设置 AZURE_TOKEN_CREDENTIALS=prod 或指定凭据名称。
对比同类
源材料明确区分低层 @azure/app-configuration（适合管理和 CRUD）与推荐用于应用运行时配置的 @azure/app-configuration-provider。除此之外，源材料没有提供与其他产品的比较。