火山引擎短信（Volcengine SMS）

发短信、验证码和营销群发，支持创建资质、签名模板与回执

火山引擎短信

始终通过 python3 -B <skill目录>/scripts/sms_cli.py 执行业务，不绕过脚本调用写 Action。默认客户不会使用终端：Agent 负责安装、登录、命令和清理，客户只操作浏览器 并确认业务写入。除非客户询问，不展示命令、JSON、CLI、Profile、HOME、AK/SK 或沙箱。

入口流程

1. 首次调用或鉴权失败时读取 auth-setup.md，执行 auth-doctor 并严格跟随唯一 error.remediation；auth_ready 后恢复原任务。
2. 首次业务调用执行只读 list-message-groups。只有 RE:0001 才读取 service-onboarding.md；空列表和资源缺失不代表服务 未开通。
3. 按任务读取下面最小参考集合，再执行 CLI。

按任务读取

• 所有任务先读公共 Action 配置与错误规则：actions.md。
• 资质、签名、模板申请读 application-contracts.md。
• 资质材料和本机表单再读 qualification-materials.md；展示方式由其中链接的 qualification-display.md 决定。
• 单发、群发、回执和分析读 delivery-contracts.md。
• 需要完整编排顺序时读 workflows.md。
• 写操作授权、脱敏、重试和对账统一读 rules.md。

CLI 工作流

• 查询：list-message-groups、message-group-detail、list-qualifications、 list-signatures、list-templates。
• 资质：先尝试 MCP App 右侧面板；调用 open_qualification_application 后紧接着调用 ensure_qualification_application_visible。面板不可见时按 qualification-display.md 改用宿主内置浏览器， 宿主不支持时才使用系统浏览器。
• 申请：*-preview → 客户确认 → *-submit。
• 单发：match-template → send-preview → 客户授权 → send-submit → send-status。
• 群发：batch-template-demo / batch-precheck → batch-create → batch-launch-preview → 指定任务授权 → batch-launch-submit；管理使用 batch-detail、batch-list、batch-cancel。
• 分析：analytics；只有需要消息级证据时增加 --include-logs。

不可变边界

• 鉴权只执行 remediation；同一时间一个登录会话。其他登录方式不索取登录入口链接，AK/SK 只在客户主动选择时提示一套 VOLCENGINE_* 变量。
• 资质敏感材料只在本机向导填写。Agent 读取掩码后的 QUALIFICATION_EXCHANGE 和 QUALIFICATION_FAILURE 排查，不要求客户复制字段或上传到对话。
• 申请、发送和任务启动都基于当前预览授权；字段变化后重新预览。
• 可能已发出的写请求不重试、不切换调用路径，返回 outcome_unknown 并按契约对账。
• 创建或启动群发不代表送达；只有公开发送日志是消息级证据。
• 最终输出不包含完整个人信息、图片、文件地址、凭证、ticket、Authorization 或签名 URL 查询参数；保留公开 Request ID 和错误码，不推断内部原因。