twilio-send-message-twilio-ai

1. 基本信息

项目	内容
名称	twilio-send-message
作者/维护者	Twilio（官方）
来源链接	https://github.com/twilio/ai/tree/main/skills/twilio/twilio-send-message
许可证	MIT（数据来自 GitHub API）
GitHub Stars / Forks	29 / 7（数据来自 GitHub API；该数字属所属合集仓库 twilio/ai 整体，不代表本技能自身热度）
最新版本	无独立版本号；所属插件清单版本 0.3.2，仓库无 Release 体系，持续滚动更新
安装方式	Claude Code 插件市场一键安装；Cursor / Codex 等手动复制 SKILL.md 到 agent 的 skills 目录

2. 功能介绍与亮点

这份技能是 Twilio 消息发送的统一入口——用一个 messages.create() 调用覆盖 SMS、MMS、RCS、WhatsApp 四条渠道，渠道由发送地址格式与收件人能力自动决定：

双语言可直接运行的代码示例：Python 与 Node.js 各给出四种渠道（SMS、强制 RCS、WhatsApp、经 Messaging Service 发送）的完整 messages.create() 调用片段，复制即可跑通。
生产环境的正确用法讲得很直白：明确建议生产场景改用 messagingServiceSid 而非裸 from，因为只有前者支持发送方池管理、RCS→SMS 自动降级、SMS 群发防护、短链接与合规工具箱。
常见错误码对照表：列出 10 个高频错误码（如收件人已退订的 21610、品牌/活动未在美国 A2P 10DLC 注册的 30034、Validity Period 过期的 30036），每条都配具体修复动作，而不是只贴官方文档链接。
“CANNOT”诚实清单：明确列出五项做不到的事——单次调用不能跨渠道群发、WhatsApp 24 小时窗口外无法自由发送、MMS 仅限美加地区、未挂 Messaging Service 时无法配置 RCS 降级、任何渠道都无法保证送达——降低 agent 给出不可行方案的概率。
多技能协同网络：正文多处指向同仓库的 twilio-messaging-channel-advisor（渠道选型）、twilio-content-template-builder（构建富卡片模板）、twilio-messaging-services（发送方池与降级配置）、twilio-verify-send-otp（验证码场景），形成可组合的技能网络而非孤立文档。

3. 适用场景

所属固定分类：集成与工作流自动化。

适用于需要在自有应用或客服系统中集成消息通知能力的开发者：典型场景包括电商物流状态提醒（发货、派送）、验证码与账户安全提醒的补充发送渠道、客服/营销消息的跨渠道触达（先尝试 RCS 富媒体、自动降级到 SMS 兜底），以及需要用一套代码同时支持 SMS 与 WhatsApp 两类用户群体的产品。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持。仓库提供官方插件市场安装命令（/plugin marketplace add twilio/ai + /plugin install twilio-developer-kit@twilio），安装后技能按提示词自动匹配触发。
Codex：✅ 原生支持。README 提供专门的 Codex 安装步骤（codex mcp add 接入文档检索 + 克隆仓库复制技能目录到 ~/.agents/skills/）。
OpenClaw：❓ 未验证。仓库声明遵循开放的 Agent Skills 标准（SKILL.md 格式），理论上任何支持该标准的工具均可加载，但未见针对 OpenClaw 的专门说明。
Hermes Agent：❓ 未验证。同上，无直接材料佐证。

5. 推荐理由

发消息看似简单，但一旦要同时支持 SMS、WhatsApp、RCS 三条渠道，开发者很容易在“用哪个字段传收件人”“生产环境该用 from 还是 messagingServiceSid”“降级失败该怎么办”这些细节上反复踩坑。这份技能把 Twilio 官方统一消息 API 的完整用法、双语言可运行示例、10 个高频错误码的具体修复方法整理成一份可直接照做的参考，并与同仓库的渠道选型、模板构建、发送方池管理等技能形成组合，是这套 Messaging 技能网络里其他技能反复引用、但此前始终缺失的核心发送环节。

6. 评分

维度	分数	说明
受欢迎程度	7	Twilio 官方出品（第一方，即 Programmable Messaging 服务本身的所有者发布）；所属合集仓库 twilio/ai 规模较小（29 stars），不构成独立热度证据
可用性	8	Python 与 Node.js 双语言示例覆盖四种典型调用场景，复制即可运行；错误码表逐条给出修复动作，CANNOT 清单降低试错成本；该子目录最近一次实质性提交为 2026-05-06，仓库整体最近一次提交为 2026-08-13，持续活跃
安全性	9	全部为官方 SDK 示例代码与错误处理说明，无 shell 命令执行，联网对象仅 Twilio 官方 API；凭据（Account SID / Auth Token）配置方式已文档化并指向专门的凭据设置技能；许可证明确（MIT）；未见可疑指令或混淆代码

综合评分：8.0（三项均值）

7. 跟同类 Skills 相比的优势

同类项目	定位	与本技能的差异
twilio-messaging-channel-advisor	帮助在 SMS/WhatsApp/RCS 等渠道之间做选型决策的规划类技能	只给出“该选哪个渠道”的决策框架，不涉及具体的 API 调用参数、错误码处理或代码示例，是本技能的上游决策环节
twilio-whatsapp-send-message	WhatsApp 专项发送与 24 小时服务窗口规则深度指南	聚焦单一渠道的细节（服务窗口、模板要求），本技能覆盖四条渠道的统一入口与跨渠道共性问题（如生产环境该用哪个发送参数）
twilio-sms-send-message	SMS/MMS 专项调试深度指南，聚焦过滤拦截、SMS 群发识别等疑难问题排查	定位是本技能的调试伴侣，专注单一渠道疑难杂症，不覆盖 RCS/WhatsApp 或整体渠道选型
Sinch / Vonage / MessageBird 等第三方 CPaaS 平台的统一消息 API	同类跨渠道消息发送能力	产品生态规模不同：Twilio 是市场份额最大的 CPaaS 厂商之一，本技能把官方错误码表与生产环境最佳实践整理为结构化参考，多数第三方平台的对应文档更分散

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。所属仓库 twilio/ai 的近期提交记录显示团队仍在持续维护与修订技能内容（如统一为多个技能补充 Codex 元数据、修复已知问题），但暂无专门针对本技能的外部评价记录。

9. 安装使用方式

Claude Code

/plugin marketplace add twilio/ai
/plugin install twilio-developer-kit@twilio

安装后技能会在提示词匹配“发短信/发消息/发 WhatsApp”等相关任务时自动触发。

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），安装后需重启或重新加载 agent 会话以识别新技能。

10. 注意事项

仓库 README 明确标注 Twilio Skills 与 Twilio MCP 目前处于 Public Beta，内容可能变更，且不受 Twilio 标准支持条款与 SLA 覆盖。
生产环境务必改用 messagingServiceSid 而非裸 from 字段，否则无法启用 RCS→SMS 自动降级、SMS 群发防护等能力，技能正文对此有明确提醒。
WhatsApp 渠道在 24 小时服务窗口外发送自由格式消息会失败，必须改用预先审批的模板（content_sid）。
MMS 富媒体仅支持美国/加拿大地区，其他地区需改用 WhatsApp 或 RCS 承载富媒体内容。
该子目录内容最后一次实质更新为 2026-05-06（约 3 个月前），后续如需了解 API 细节变化建议对照 Twilio 官方文档做二次核实。