Azure 通信服务 SMS Java 技能
帮助 Java 应用通过 Azure 通信服务发送短信并处理投递结果。
文档提供 Entra ID、托管身份、连接字符串和访问密钥方案，并提示通过环境变量配置凭据；但发送短信和 Event Grid 回调会产生外部副作用，未要求用户确认、未说明授权/退订/合规边界，也没有回滚机制。OTP 示例把手机号放入 tag，可能扩大敏感数据暴露，因此未接近满分。
覆盖单收件人、批量、异步、错误处理和限流重试，失败结果与请求级异常均有说明；但示例存在缺少导入、环境变量要求与连接字符串用法不完全一致、重试策略简化且未处理幂等/重复发送等问题。仅静态阅读且没有该技能专属测试，因此不超过静态上限。
触发短语、Java SDK、短信通知、OTP、批量发送和投递报告场景较明确；但未声明不适用范围、资费/地区/运营商限制、合规要求或输入输出契约，也未说明中文内容、短信分段及中国大陆网络可达性。核心功能依赖 Azure Communication Services，环境适配证据不足。
具备 YAML 元数据、MIT 许可证、版本号、安装说明、分层示例、错误处理、最佳实践和 references/examples.md；但没有技能级 changelog、维护责任人、更新路径、兼容矩阵或已知限制清单，且版本与依赖更新策略不明确，因此扣分。
内容可直接支持常见 Java ACS SMS 集成，涵盖发送、批量、异步、投递报告和 OTP；但代码未被本次评审执行验证，部分示例需要补导入、配置和生产级安全/重试处理，实际结果仍需较多审查，故按静态评审上限保守给分。
源文件包含具体 Maven 坐标、API 调用、错误分支和完整示例，具备一定可审计性；但没有该技能路径的提交测试、CI 覆盖或第三方执行证据，仓库通用测试材料不能证明此技能关键路径，无法获得更高静态分数。
- 发送短信前应明确用户授权、退订、地区合规、资费和运营商限制，并在应用层增加人工确认或业务审批。
- 不要将手机号、OTP 或其他敏感信息放入 tag、日志或错误消息；优先使用托管身份/短期凭据，避免在代码或日志中暴露连接字符串和访问密钥。
- 在采用示例前核对 azure-communication-sms 1.2.0 的实际 API、补齐导入，并为 429、网络失败、超时和幂等重试建立可恢复策略。
- 确认 Azure Communication Services、Event Grid 以及短信发送能力在目标地区（尤其中国大陆）的可达性与合规性。
它能做什么 & 适用场景
该技能面向使用 Azure Communication Services SMS Java SDK 的开发者。它涵盖单收件人和多收件人短信、同步与异步调用、投递报告、标签以及逐收件人的错误处理。示例展示了 DefaultAzureCredential、托管身份、连接字符串和 AzureKeyCredential 等客户端认证方式。适合需要短信通知、验证码、告警或批量发送的 Java 项目，但内容主要是代码模式，未提供完整应用或部署方案。
指导开发者添加 Maven 依赖，创建 SmsClient 或 SmsAsyncClient，调用 Azure Communication Services SMS API 向一个或多个 E.164 格式号码发送短信，并读取消息 ID、收件人、成功状态、HTTP 状态和错误信息。它还说明如何启用投递报告、添加业务标签、处理 429 限流，以及通过 Azure Event Grid 接收投递状态。
- Java 应用需要向单个用户发送登录验证码或一次性密码。
- 订单系统需要发送确认、状态变化或安全告警短信。
- 营销或运营服务需要向多个电话号码批量发送消息并逐一检查结果。
- 关键通知需要通过 Event Grid 接收 Delivered 或 Failed 等投递状态。
- 团队希望在本地开发使用 DefaultAzureCredential、生产环境使用托管身份。
优缺点一览
- 覆盖同步、异步、单收件人和批量发送模式。
- 提供逐收件人的成功、状态码和错误信息处理示例。
- 包含 Event Grid 投递报告、业务标签和 429 重试建议。
- 同时展示 Entra ID、托管身份、连接字符串和 AzureKeyCredential 认证方式。
- 只针对 Java SDK，不能直接用于其他语言。
- 未提供完整项目、部署配置或 Event Grid webhook 的可运行实现。
- 来源没有给出该单项技能的独立测试覆盖信息。
- 短信发送需要已配置的 Azure Communication Services 资源和发送方号码。
如何安装
安装整个仓库中的技能集合：运行 npx skills add microsoft/skills，然后在向导中选择所需技能。仓库 README 还记录了通过 git clone 后复制特定技能目录的手动方式；针对该技能的独立安装命令未在来源中说明。Java 项目还需添加 com.azure:azure-communication-sms:1.2.0 Maven 依赖。
如何使用
可用触发语句包括“send SMS Java”“SMS notification”“OTP SMS”“bulk SMS”或“delivery report SMS”。使用时提供发送方 ACS 电话号码、收件人号码和短信内容；需要时启用 delivery reports 并设置 tag。根据来源示例，可使用 DefaultAzureCredential、连接字符串或 AzureKeyCredential 创建客户端，再调用 send 或 sendWithResponse；异步场景使用 SmsAsyncClient。生产环境使用 DefaultAzureCredential 时，来源要求设置 AZURE_TOKEN_CREDENTIALS=prod 或指定凭据配置。