用途
该技能用于发送短信（SMS）或 WhatsApp 营销消息，渠道为 Twilio 或 Brevo。短信与 WhatsApp 属于高影响、高风险渠道，消息会即时到达个人设备，因此合规失败可能带来法律与声誉后果。该命令在消息发出前强制执行各项必要保障：美国 TCPA 同意、欧盟 GDPR 同意、加拿大 CASL、退订机制、静默时段与消息长度合规。未通过所有关卡并获得用户明确批准，不会发送任何消息。
执行关卡（强制，不可跳过）
在接触任何线上系统前，先以执行摘要形式展示完整预览：收件人 / 花费 / 变更 / 合规。用户必须输入 yes（或等效的明确批准）。任何其他输入——含糊、暗示、部分或缺失批准——都会取消本次运行。不得在含糊输入下继续。不得自动重试失败执行；失败需人工复核后才能重跑。
仅在用户输入 yes 后记录批准：先运行 approval-manager.py 的 create-approval 动作，再运行 approve 动作，命令中需带品牌 slug、类型 send-sms、平台、内容摘要与风险等级。若任一命令报错，停止并报告错误，不得用其他工具绕过。该记录证明批准步骤已运行，但不能证明是谁输入的 yes。
执行时，通过 connector_executor.py 的写入需要 --approval-id，且仅对匹配、未使用、未过期的记录生效。通过已连接 MCP 服务器工具的写入不在该代码检查范围内，依赖用户输入的 yes 与宿主权限提示。之后运行 mark-executed 记录成功或失败。
所需输入
用户必须提供（或被提示提供）：
消息内容：SMS 或 WhatsApp 消息正文，必须包含清晰的退订机制（如“Reply STOP to unsubscribe”）。WhatsApp 消息可包含富媒体（图片、文档、视频或位置），且企业发起的对话必须使用预先批准的模板。
收件人：E.164 格式电话号码（+1XXXXXXXXXX）、品牌受众数据中的具名联系人列表，或分群引用。批量发送需提供 CSV 文件路径或列表标识。每位收件人必须有存档的同意记录。
渠道：sms 或 whatsapp——决定消息长度限制（SMS 160 字符；WhatsApp 模板正文 1,024 字符，自由会话消息 4,096 字符）、媒体支持、模板要求与平台特定合规规则。
发送方 ID（可选）：发送方电话号码、短代码或字母数字发送方 ID，必须在平台上注册并验证。省略时使用消息 MCP 中配置的品牌默认发送方。字母数字发送方 ID 并非所有国家都支持。
发送时间：立即发送，或带时区的计划日期时间（ISO 8601）。计划发送必须遵守静默时段——收件人本地时间晚 9 点至早 8 点之间不得发送。
活动名称（可选）：用于跟踪与归因，将本次发送关联到品牌分析中的活动。省略时根据消息内容与日期自动生成。
个性化字段（可选）：合并到消息中的动态字段，如名字、订单号、预约时间、积分或自定义变量。每个字段需为缺失数据的收件人提供回退默认值。
WhatsApp 模板 ID（可选）：企业发起的 WhatsApp 消息需提供预批准模板标识及变量映射。Meta 要求在 24 小时客服窗口之外发送时必须使用模板。
优先级（可选）：normal（标准队列）或 urgent（时间敏感消息优先投递）。紧急发送跳过调度优化，但仍执行所有合规检查。
流程
加载品牌上下文：读取活动品牌 slug 与 profile.json，应用品牌语气、目标市场合规规则与行业上下文。检查品牌指南与机构 SOP。若无品牌，询问是否先设置品牌，或使用默认值。
验证同意合规：检查所有收件人是否对所选渠道有存档的选择加入同意。按司法辖区应用规则——美国 TCPA 明示书面同意、欧盟 GDPR 明确同意并记录合法依据、加拿大 CASL 明示或默示同意并跟踪过期。标记缺失同意的收件人并将其排除，附逐收件人合规报告。
执行静默时段：根据电话号码国家代码与区号（可确定时）或存储的受众资料确定每位收件人时区。阻止收件人本地时间晚 9 点至早 8 点之间的立即发送。计划发送需验证在所有收件人时区均遵守静默时段，标记冲突并建议最近合规发送窗口。
验证退订机制：扫描消息正文中的合规退订说明。WhatsApp 需验证企业账户设置中已配置退订流程。缺失或不合规则拒绝发送，要求用户添加退订语言。
检查消息长度：按渠道限制验证长度——SMS 每段 160 字符（拼接消息最多 1,600 字符，附段数与费用警告），WhatsApp 文本 1,024 字符。个性化消息按最长变量替换计算长度，确保无收件人收到截断消息。报告字符数、段数与每条费用。
验证消息 MCP 连接：检查已连接 Twilio 或 Brevo，确认支持所选渠道，验证发送方 ID 已注册、授权并符合目的地国家规定。未连接则引导集成设置。
品牌语气评分：对消息内容运行 brand-voice-scorer.py，验证与品牌语气指南一致。SMS 要求简洁直接，标记偏离品牌、过于正式或短文本中易误解的内容。
创建批准记录：通过 approval-manager.py 创建记录，风险等级置于 --data JSON 中（如 high）。SMS 与 WhatsApp 营销存在监管风险（TCPA 每条未经请求消息罚款最高 1,500 美元）与每条费用。生成完整发送摘要供审核。
展示发送摘要：显示完整摘要——含个性化令牌解析的样本消息预览、收件人总数（合规过滤后合格数、排除数及原因）、渠道、发送方 ID、发送时间与静默时段验证、合规清单、每条与总费用估算、SMS 段数、品牌语气评分。等待明确“send”确认。
通过 MCP 执行发送：批准后通过 Twilio 或 Brevo MCP 触发发送。处理逐收件人个性化令牌替换、批量发送的批处理与限流、WhatsApp 模板变量注入、平台特定 API 格式。监控即时投递失败与 API 错误。
跟踪投递：轮询平台 API 获取投递状态——delivered、failed、undelivered、queued 或 read（仅 WhatsApp）。批量发送跟踪逐收件人状态。投递失败率超过 5% 时告警，并按原因分类（无效号码、运营商拦截、已处理退订、网络超时）。
记录执行：运行 execution-tracker.py 记录发送事件，含时间戳、平台、渠道、活动名称、收件人数量、消息内容哈希、合规验证结果、投递指标、费用与失败。保存性能洞察供未来优化。
输出
结构化发送确认，包含：发送确认（消息 ID 或批次 ID、平台、渠道、状态、带时区时间戳）；收件人详情（提交总数、合规过滤后合格数、排除数及逐人原因、最终发送列表）；合规报告（TCPA、GDPR、CASL 同意、退订机制、静默时段、发送方验证、WhatsApp 模板的通过/失败）；消息详情（最终内容、字符数、SMS 段数与拼接状态、2-3 个样本收件人的个性化预览与回退默认值、退订机制位置确认）；费用报告（按目的地国家每条费用、拼接 SMS 每段费用、总费用、与活动预算对比）；投递报告（实时状态、失败分类、WhatsApp 已读回执）；品牌语气评分；执行日志条目。
使用的智能体
execution-coordinator——多司法辖区同意验证（TCPA、GDPR、CASL）与逐收件人合规过滤、基于电话号码与受众资料的时区解析与静默时段执行、按渠道要求的退订机制验证、HIGH 风险分类与费用感知摘要的批准工作流、通过 Twilio 或 Brevo MCP 的批量发送与限流、实时投递状态跟踪与失败分类及阈值告警、每条与每段费用计算、含完整合规审计轨迹的执行日志。