用途:在本地 Claude Code 会话、脚本或定时任务中,当长时间无人值守的工作完成时,通过 Sendblue 向用户手机发送一次性外发通知,即“离开终端”模式:启动长任务,完成后收到 iMessage。适用触发条件包括用户说“完成后短信我”“通知我完成”“构建/部署/迁移结束时告诉我”,或要求为 Agent 停止、/loop 迭代、/schedule 完成配置钩子。短时交互任务不建议使用,否则会造成噪音。
主要能力与模式:1)一次性内联发送,适合单个临时任务,不更改配置,用 if/else 根据任务退出状态发送成功或失败消息,避免使用 &&/|| 链,因为成功发送本身非零也会触发失败分支。2)Claude Code Stop 钩子,需用户主动选择、限定于项目范围,按持续时间设阈值(例如 90 秒)过滤,并以 || true 结尾避免通知失败影响父任务。3)/loop 或 /schedule 结束时追加发送。
必要用法:需先安装并认证 CLI,可用 npx @sendblue/cli whoami 确认凭证,首次运行可用 npx @sendblue/cli setup。目标号码必须是账户中已验证的联系人;免费计划下联系人须先向 Sendblue 号码发送过一条消息,外发才能成功,可用 sendblue contacts 确认。目的地号码建议按项目缓存,如 NOTIFY_NUMBER 环境变量或 .notify-number 文件。发送命令示例:npx @sendblue/cli send +15551234567 "✅ done: $(date +%H:%M)"。
限制与安全:仅支持外发通知,手机发短信给 Claude 需使用 @textme 技能。本技能不负责凭证、账户设置或钩子配置文件格式,分别属于 @sendblue-cli 和 @update-config。锁屏预览可能泄露信息,不要嵌入密钥、客户数据或完整错误堆栈,应链接到日志、仪表盘或 PR。安装钩子前须向用户展示配置并获得确认,避免误配置导致每分钟发送数十条消息。相关技能包括 @sendblue-cli、@sendblue-api、@update-config、@textme。底层 CLI:https://github.com/sendblue-api/sendblue-cli;Sendblue:https://sendblue.com;API 文档:https://docs.sendblue.com。