Azure Batch Java 作业编排技能
帮助 Java 开发者在 Azure 上编排大规模并行与 HPC 批处理作业。
技能推荐 Entra ID，并将共享密钥放在环境变量中，未见凭据硬编码、恶意行为或隐蔽外传；但示例包含池/作业/节点删除、管理员任务、远程登录和 SAS URL，却没有用户确认、最小权限、数据流、成本影响或回滚说明，因此扣分。
结构清晰，涵盖同步、异步、长轮询和错误处理；但依赖使用 beta.5，部分示例的 API 签名、导入和模型用法未由文件内测试复现，且 references/examples.md 明显在完整示例中截断，异常输入和失败后的诊断指导有限；静态评估不超过 10 分。
名称、受众、Azure Batch 场景、触发短语和基本前置条件较明确，覆盖池、作业、任务、节点与计划；但没有明确非适用范围、输入输出契约、版本兼容边界或中文支持，且依赖 Azure 服务可达性，需考虑中国大陆网络与区域可用性。
SKILL.md 有 front matter、MIT、作者和 1.0.0 版本，按安装、认证、概念和操作分层，并提供引用链接；但缺少变更日志、维护责任与更新流程、兼容性矩阵、常见问题和已知限制，引用与主文档之间也存在重复。
示例覆盖常见 Batch 生命周期和 Java 代码模式，可能帮助完成基础客户端集成；但代码未在文件内被执行验证，存在 beta 依赖、平台命令差异、云资源成本与权限风险，输出仍需较多人工核对，因此按静态上限保守评分。
提供 Maven、GitHub、API、产品文档和样例链接，仓库上下文还显示有通用 CI 与测试；但未提供该技能路径的专门验收测试、成功运行结果或第三方交叉验证，且本次未执行代码，因此只能给予有限证据分。
- 将删除池、删除作业、终止任务、管理员任务、自动扩缩容和远程登录示例视为需要明确用户确认的高影响操作。
- 在采用 beta.5 及示例 API 前，应针对目标 Java SDK 版本编译验证，并补充失败诊断、权限范围、成本和回滚说明。
- 涉及 SAS URL、任务输入输出和 stdout/stderr 时，应说明敏感数据处理、存储访问范围和凭据生命周期。
- 中国大陆用户需单独确认 Azure Batch 区域、身份认证端点、Maven 仓库和文档链接的网络可达性。
它能做什么 & 适用场景
该技能面向使用 Azure Batch Java SDK 的开发者，提供从客户端创建到批处理作业运行的完整操作示例。内容覆盖池、作业、任务、计算节点和作业计划，并同时展示同步与异步客户端用法。它还说明 Microsoft Entra ID 与共享密钥认证、环境变量配置、长时间运行操作和错误处理。适合已经拥有 Azure Batch 账户并需要通过 Java 扩展并行计算任务的团队。
指导开发者安装 azure-compute-batch Maven 依赖，配置 Batch 端点和认证环境变量，创建同步或异步 Batch 客户端；创建、查询、列出、扩缩容、自动缩放和删除计算池；创建、查询、批量提交、终止和删除作业与任务；读取任务输出，列出或重启计算节点，获取远程登录设置，创建和查询作业计划；通过 BatchErrorException 读取错误代码和消息。
- Java 团队需要在 Azure Batch 计算池中运行大量独立任务时，使用任务批量提交接口提高提交效率。
- HPC 应用需要根据待处理任务数量动态调整节点规模时，使用池自动缩放公式。
- 需要跟踪批处理进度的服务，可通过作业任务计数读取活动、运行中和已完成任务数量。
- 希望避免在生产环境中管理共享密钥的团队，可使用 DefaultAzureCredential 或托管身份连接 Batch。
- 需要对失败任务设置最长运行时间、重试次数或退出码行为的开发者，可使用作业约束和任务退出条件。
优缺点一览
- 覆盖池、作业、任务、节点和作业计划等核心 Batch 操作。
- 同时提供 Entra ID、托管身份、共享密钥、同步客户端和异步客户端示例。
- 包含批量任务提交、自动缩放、长时间运行操作、任务计数和错误处理模式。
- 明确给出 Maven 坐标、环境变量和关键 Java 类型，便于直接开始开发。
- 依赖版本为 1.0.0-beta.5，源材料未说明其稳定性或升级兼容性。
- 必须已有 Azure Batch 账户、订阅和计算池，技能本身不负责完整基础设施创建。
- 示例主要覆盖 Batch 数据面操作；内容建议使用管理 SDK 管理池，但未提供该 SDK 的具体代码。
- 源材料没有提供该单个技能的独立测试结果、成本估算或性能基准。
如何安装
在项目的 Maven 配置中加入：<dependency><groupId>com.azure</groupId><artifactId>azure-compute-batch</artifactId><version>1.0.0-beta.5</version></dependency>。作为 Agent Skill，README 提供的集合安装命令是：npx skills add microsoft/skills；在向导中选择需要的技能，并将其安装到目标 Agent 的目录。源材料未提供该单个技能的独立安装命令。
如何使用
安装后，在编码请求中使用明确触发语句，例如“Use the Azure Batch SDK for Java to create a pool and submit parallel tasks”或“Help me configure BatchClient Java authentication”。准备 Azure Batch 账户、已配置计算节点的池和 Azure 订阅，并设置 AZURE_BATCH_ENDPOINT；共享密钥认证还需设置 AZURE_BATCH_ACCOUNT 和 AZURE_BATCH_ACCESS_KEY。
对比同类
认证方面，技能将 Microsoft Entra ID 作为推荐方案，并将共享密钥作为替代方案；池管理方面，它建议使用 azure-resourcemanager-batch 管理 SDK 来支持托管身份。