用途:这是一个 Claude 技能,用于通过 Poke 的入站 webhook API 向你的 Poke 助手发送消息。Poke 是支持 iMessage、SMS 和 WhatsApp 的对话式 AI 助手,本技能让 Claude 把通知、告警和更新直接推送到你的 Poke。适用场景包括:长时间任务完成提醒、需要关注的错误或警告、构建/测试/部署进度状态、提醒与摘要,以及 CI 失败、安全问题等重要事件告警。
前提条件:拥有 poke.com 账号,并配置 POKE_API_KEY 环境变量。获取 API Key 的步骤:访问 poke.com/settings,进入 Advanced 区域,生成或复制 API key,然后写入 shell 配置:echo 'export POKE_API_KEY="your-api-key"' >> ~/.zshrc && source ~/.zshrc。
主要用法:核心脚本为 python scripts/send_message.py,选项包括 -m/--message TEXT(消息内容)、-v/--verbose(详细输出)、-h/--help。消息可通过 -m 提供,也可通过 stdin 管道传入;若两者同时提供,-m 优先。退出码:0 成功,1 缺少消息或 API key,2 API 错误(认证、限流等),3 网络错误。
示例:直接发送 python scripts/send_message.py -m "Hello from Claude Code!";管道输入 echo "Build completed successfully" | python scripts/send_message.py;构建后通知 npm run build && python scripts/send_message.py -m "Build finished successfully" || python scripts/send_message.py -m "Build failed!";测试失败告警 npm test || python scripts/send_message.py -m "Tests failed! Check the output."。
最佳实践:建议在耗时超过 2-3 分钟的任务、需要用户关注的错误、重要里程碑(部署、发布)及安全相关告警时发送;避免对快速完成的常规操作和每个小步骤都发送,以免通知疲劳;不要发送凭据、令牌等敏感信息。消息应简洁但信息完整,包含可操作的上下文,多行消息使用清晰格式。
排错:出现 POKE_API_KEY environment variable not set 时设置该变量或写入 ~/.zshrc;API 返回 401 表示 key 无效或过期,需在 poke.com/settings 重新生成;返回 429 表示被限流,需等待几分钟;Network error: Connection refused 需检查网络。若消息未出现在 Poke,请确认 API key 正确、Poke 设置中已启用消息功能,且已配置 iMessage/SMS/WhatsApp 通道。
限制:需要 Poke 账号与网络访问;受 API 限流约束;具体速率限制数值、可用平台版本等资料暂未提供。