Azure 技能创建指南
帮助编码代理创建结构清晰、精简且可验证的 Azure SDK 技能。
内容强调禁止硬编码凭据、优先使用受约束的 DefaultAzureCredential，并要求显式参考官方文档，降低了凭据暴露和错误配置风险；但未定义用户确认、权限最小化、数据流披露、外部副作用审批或回滚机制，因此扣分。
文档结构较一致，提供初始化、校验和打包脚本及失败提示；但脚本未配套测试，依赖可用性、关键路径复现、异常输入覆盖和部分示例的可运行性未被静态证实，因此按静态上限保守扣分。
目标读者和主要场景是为 Azure SDK 与 Microsoft Foundry 创建或更新 Agent Skill，触发条件较清楚；但对非 Azure 技能、不同编码代理环境、中文使用和中国大陆网络可达性说明不足，适用边界与误触发条件不完整。
具备 frontmatter、渐进式披露、目录结构、参考资料、脚本说明、命名和验证规范；仓库提供 MIT 元数据及 Microsoft 官方组织来源，但该技能自身没有版本号、变更日志、维护责任人或明确更新路径，且包含较多强制性规则和占位式假设，因此扣分。
能提供较系统的技能设计原则、Azure SDK 认证模式、结构模板和基础工具，核心指导具有直接参考价值；但初始化脚本生成大量占位文件，校验器仅做基础格式检查，未证明能端到端产出高质量、可直接使用的技能，因此不超过静态上限并扣分。
文档引用 Azure SDK 官方资料并给出可审计的脚本和 CI/评估命令；但选定技能没有提交的测试套件、实际执行结果或覆盖关键路径的独立证据，主要结论仍来自作者指导，故仅给有限分数。
- 不要把文档中的 Vally、CI 或示例命令视为已执行的测试证据；应在目标环境中单独验证脚本依赖、打包路径和认证示例。
- 初始化脚本会创建占位目录和文件，使用前应审查生成内容，并确认删除未使用资源的操作范围。
- 对中国大陆用户应预先确认 Microsoft 文档、MCP 服务、Azure 端点和 npx 安装链路的网络可达性。
这个 Skill 能做什么，适合哪些场景？
这是一个面向 AI 编码代理的技能作者指南，重点覆盖 Azure SDK 与 Microsoft Foundry。它规定了技能的元数据、内容结构、渐进式披露、令牌预算、身份验证和客户端生命周期写法。指南还要求作者基于用户提供的 SDK 包名、文档 URL 或代码仓库，并在适用时验证文档、测试和技能效率。适合需要新增或维护 SDK/API 技能的团队，不适合直接提供某个 Azure 服务的业务开发代码。
指导作者收集 SDK/API 上下文，编写带 YAML frontmatter 的 SKILL.md，设计核心工作流，并将高级内容拆分到 references/。它定义 Azure SDK 技能的安装、环境变量、身份验证、客户端生命周期、示例、功能表、最佳实践和参考链接结构；还提供反模式清单、令牌预算、凭据指导、前置资料要求以及可选的 Vally 和测试验证流程。
- 负责 Azure SDK 的工程师需要从官方包和文档创建一项新的编码代理技能。
- 维护者需要更新已有技能，以反映新的 SDK 模式、身份验证方式或重命名迁移。
- 技能作者需要控制 SKILL.md 长度，并把批处理、错误处理和高级身份验证拆分为参考文件。
- 团队需要在发布前检查技能的 frontmatter、示例、凭据使用和可运行性。
这个 Skill 有哪些优点和局限？
- 提供明确的技能目录、章节顺序和 frontmatter 规范。
- 包含 Azure SDK 的令牌预算、身份验证、客户端生命周期和参考文件拆分规则。
- 提供反模式清单、检查表和可选验证流程，便于发布前审查。
- MIT 许可，仓库持续维护并通过工作流更新文档和测试。
- 指南高度聚焦 Azure SDK 与 Microsoft Foundry，通用领域技能需要自行判断组织方式。
- 创建 SDK/API 技能必须先提供 SDK 包名、文档 URL 或代码仓库，否则无法按要求开始。
- 部分验证依赖 microsoft-docs MCP、Vally 或测试环境；来源未证明这些工具在所有代理中都可用。
- 提供的 SKILL.md 内容被明确截断，未展示部分只能视为未知。
如何安装这个 Skill？
从整个仓库安装技能集合：npx skills add microsoft/skills，在向导中选择需要的技能。也可以克隆仓库后复制 .github/skills/skill-creator/ 到目标代理目录，例如 GitHub Copilot 使用的 .github/skills/。来源没有说明单独安装此技能时的专用命令。
如何使用这个 Skill？
在已安装该技能的编码代理中提出类似请求：Create or update an Azure SDK skill for <SDK package>, using <documentation URL or repository reference>. 之后按指南提供 SDK 包名、文档 URL 或仓库引用。具体的自动触发机制和运行时命令未在该技能内容中完整说明。