1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | twilio-sms-send-message（隶属 Twilio 官方技能合集 twilio/ai） |
| 作者/维护者 | Twilio, Inc.（官方仓库） |
| 来源链接 | https://github.com/twilio/ai/tree/main/skills/twilio/twilio-sms-send-message |
| 许可证 | MIT（数据来自 GitHub API，并核对仓库根目录 LICENSE 原文） |
| GitHub Stars | 合集仓库 twilio/ai 整体 29★／Forks 7（数据来自 GitHub API；该数字属整个官方技能合集，不代表本技能个体热度） |
| 最新版本 | 未标注独立版本号，随合集仓库持续滚动更新（该技能路径最近一次实质性提交为 2026-05-06，仓库整体最近一次提交为 2026-08-14） |
| 安装方式 | Claude Code 插件市场一键安装，或手动复制到 agent 的 skills/ 目录（见第 10 章） |
2. 功能介绍与亮点
twilio-sms-send-message 是 SMS/MMS 渠道的深度参考技能，聚焦“消息发出去了但没送达”这一类排障场景，而不是基础发送操作本身。核心能力：
- 7 类常见错误码对照表：
21211（号码格式非法）、21408（目的地区域权限未开启）、21610（收件人已退订）、30003（运营商无法送达）、30007（内容被判定为垃圾信息）、30034（美国 A2P 10DLC 发送方未注册）、30450（触发 SMS 刷量防护），每条都配对应修复动作与关联技能指引。 - “消息被过滤或拦截？“六步诊断清单：按可能性从高到低给出排查顺序——未注册发送方、内容被运营商标记、收件人已退订、目的地区域权限未开、SMS 刷量拦截、账号被暂停，每一步都指向具体的 Console 操作路径或配套技能。
- MMS 地域限制与消息分段规则：明确 MMS 仅支持美国/加拿大/澳大利亚号码、单条消息超过 1600 字符会被自动拆分为多条计费短信、试用账号只能发送到已验证号码等容易被忽略的硬限制。
- Messaging Service 与直接号码发送的取舍说明：解释生产环境为何应改用
messagingServiceSid而非裸from号码（发送方池管理、合规工具、SMS 刷量防护、链接短化、消息排程）。 - “CANNOT”限制清单：五条硬性约束（E.164 格式强制、试用账号收件人限制、MMS 地域限制、单条字符上限、刷量防护依赖 Messaging Service）提前挡掉常见返工。
- 与同仓库
twilio-account-setup、twilio-iam-auth-setup、twilio-compliance-onboarding、twilio-messaging-services、twilio-debugging-observability等技能交叉引用，形成可组合的技能网络。
3. 适用场景
固定分类：集成与工作流自动化
- 已经在用 Twilio 发送 SMS、但遇到消息未送达、被运营商拦截或收不到预期状态回执的开发者；
- 需要理解 30034（A2P 10DLC 未注册）、30450（SMS 刷量拦截）等特定错误码具体含义与修复路径的团队；
- 计划发送 MMS 但不清楚地域限制（仅美加澳）、需要提前规划渠道降级方案的产品团队；
- 已读过通用发送技能仍需要 SMS 专属细节（字符分段计费、试用账号收件人限制等）的初中级开发者。
4. 跨 Agent 兼容性
- Claude Code：原生支持——官方提供插件市场安装命令（
/plugin marketplace add twilio/ai+/plugin install twilio-developer-kit@twilio），仓库根目录带.claude-plugin清单。 - Codex：原生支持——README 给出专门的
codex mcp add文档检索接入 +git clone复制到~/.agents/skills/的安装步骤。 - OpenClaw：未验证——官方材料未点名提及，仅声明遵循开放的 Agent Skills 标准，理论上兼容。
- Hermes Agent：未验证——同上，缺乏专门证据。
5. 推荐理由
SMS 投递失败是集成 Twilio 时最常见的返工来源之一——同一个 API 调用返回 queued 之后消息却石沉大海，开发者往往不知道该从哪个方向排查。这个技能把 Twilio 官方沉淀的 7 类错误码、六步诊断清单与 MMS/字符分段等容易踩的硬限制整理成可直接执行的参考，帮开发者按可能性从高到低快速定位问题（是发送方未注册、内容被判定垃圾、收件人已退订，还是刷量防护误拦），而不是逐个 Google 错误码。技能与账号设置、凭据配置、合规注册等同仓库技能形成引用网络，排障时能顺着链路一路找到根因。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Twilio 为通信云领域官方厂商出品（第一方，即该消息发送能力本身的所有者发布）；所属合集仓库仅 29★，规模较小，除官方博客与文档站外暂无独立第三方评价或活跃讨论 |
| 可用性 | 8 | 只需已有 Twilio 账号与标准环境变量（TWILIO_ACCOUNT_SID/TWILIO_AUTH_TOKEN），Python/Node 双语言代码均可直接复制运行；错误码对照表与诊断清单结构清晰、可操作性强；该技能路径最近一次实质更新距今约 3 个月，仓库整体持续活跃维护；无付费依赖 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① Shell 命令执行——SKILL.md 本身不执行任何命令，全部为 Python/Node SDK 调用示例，由开发者在自己的环境中运行；
② 联网外发——技能本身不联网，示例代码调用对象仅为开发者自有 Twilio 账号的官方 API；
③ API Key/凭据处理——要求 TWILIO_ACCOUNT_SID/TWILIO_AUTH_TOKEN 存为环境变量，代码示例均从 os.environ/process.env 读取，无硬编码，并指向专门的凭据设置技能；
④ 可疑指令——通读全文未见提示词注入、混淆代码或隐蔽外发迹象；
⑤ 作者信誉——Twilio 官方仓库，通信云领域上市公司；
⑥ License——MIT，已核对仓库 LICENSE 原文；
⑦ 维护时间——仓库整体最近一次提交为 2026-08-14，近期活跃；本技能所在路径最近一次实质更新为 2026-05-06。
综合评分（三项均值）：8.0
7. 跟同类 Skills 相比的优势
| 同类 Skill | 定位 | 与本 skill 的差异 |
|---|---|---|
| twilio-send-message | 覆盖 SMS/MMS/RCS/WhatsApp 全渠道的统一发送操作与基础用法 | 是通用发送入口，聚焦“怎么把消息发出去”；本技能是它明确指向的 SMS 专属深度参考，聚焦“发出去之后为什么没送达”，两者官方文档互相交叉引用、定位不重叠 |
| twilio-whatsapp-send-message | WhatsApp 渠道的发送与 24 小时服务窗口规则 | 服务另一个独立消息渠道，审核体系（Meta Business Manager）与错误码集合与 SMS 完全不同，是同一“渠道深度参考”系列的另一个成员 |
| twilio-messaging-services | 发送方池管理、SMS 刷量防护开关、合规工具箱等生产级特性配置 | 是本技能诊断出“需要 Messaging Service 才能解决”类问题（如刷量防护）后的下一步配置环节，两者衔接但不重叠 |
| MessageBird / Vonage 等第三方 CPaaS 平台的 SMS API 文档 | 同类短信发送与错误排查能力 | 通用云通信文档多为平台无关的错误码说明，需要开发者自行对照映射；本技能针对 Twilio 自家错误码逐条给出修复路径与技能级联动，排查路径更短 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。所属仓库 twilio/ai 近期提交记录显示团队仍在持续为多个技能补充适配元数据与文档修订，但暂无专门针对本技能的外部评价记录。
9. 安装使用方式
Claude Code：
/plugin marketplace add twilio/ai
/plugin install twilio-developer-kit@twilio安装后技能会在提示词匹配相关场景（如“我的短信一直发不出去”“收到 30034 错误码怎么办”）时自动激活，也可直接输入 /twilio-sms-send-message 手动调用。
Codex：
codex mcp add twilio-docs --url https://mcp.twilio.com/docs
git clone https://github.com/twilio/ai.git
cp -r ai/skills/ ~/.agents/skills/Cursor / 其他遵循 Agent Skills 标准的工具：
git clone https://github.com/twilio/ai.git .twilio-ai
cp -r .twilio-ai/skills/ .agents/skills/安装后无需重启会话；使用前需在环境变量中配置 TWILIO_ACCOUNT_SID 与 TWILIO_AUTH_TOKEN（参见同仓库 twilio-iam-auth-setup）。
10. 注意事项
- 技能所属的 Twilio Skills 与配套 MCP 均为 Public Beta，官方声明部分功能尚未完全实现、后续可能变更，且不受 Twilio Support Terms 或 SLA 保障；
- MMS 仅支持美国、加拿大、澳大利亚号码，其他地区需改用 WhatsApp 或 RCS 发送富媒体内容；
- 单条消息超过 1600 字符会被自动拆分为多条短信并分别计费，需提前评估长文本场景的实际成本；
- 试用账号只能发送到已验证的收件人号码，正式上线前需升级为付费账号；
- SMS 刷量防护（错误码 30450）只能通过 Messaging Service 开启，裸号码发送无法启用该防护。