通过手机号给用户发飞书消息:把飞书 IM 通知塞进 Agent 的一次调用

前言

给一个用户发飞书消息,常见做法是自己翻飞书开放平台的文档,写一段调 API 的脚本:先拿 tenant_access_token,再按手机号查 user_id,再调发消息接口。问题在于,如果你的 Agent 里已经有”用户说一句话就帮他发”的链路,这段脚本得自己维护 token 刷新、错误码、字段名,且每次换环境都要重写一遍。

下面介绍的 Skill 把这个动作固化成了一个可调用的能力:你只需要给出手机号,它负责找用户、发文本消息。

这是什么

「通过手机号给用户发飞书消息」是一个基于通用 SKILL.md 格式的 Agent Skill,坐标 @user_44bc168a/feishu-send-message-by-mobile,发布者为社区账号 user_44bc168a,版本 1.0.0,分类 dev-programming,来源 community。

它解决的问题是:在 Agent 对话流程中,用手机号定位到飞书用户并发送文本消息,开发者不必自己写飞书 API 的调用细节。

按页面数据,该 Skill 评分 100000,下载 512 次,安装 6 次;标签为 requires_api_key=true。

核心功能

这是单用途 Skill,能力范围如下,均来自官方简介:

  1. 封装 lark_oapi 库,提供通过手机号查找用户和发送消息的完整功能。
  2. 支持配置 APP_ID 和 APP_SECRET(飞书开放平台应用凭证)。
  3. 支持发送文本消息。
  4. 使用前需要先配置飞书开放平台应用凭证,即它标注了 requires_api_key=true。

触发场景在简介里写得很明确:当用户提到通过手机号发送飞书消息、发送飞书通知、给手机用户发飞书、飞书消息推送、发送飞书文本消息,或需要集成飞书 IM 发送消息时使用此技能。

安装与启用

官方资料中没有提供 CLI 安装命令、目录路径或配置文件字段清单,因此这里不给出臆测的命令。可以确认的事实是:

  • 该 Skill 需要 API Key,使用前要先在飞书开放平台创建应用,拿到 APP_ID 和 APP_SECRET,并确认应用有通过手机号查询用户与发送消息的权限。
  • 凭证属于敏感配置,建议放在环境变量或密钥管理服务中,不要写进仓库。

关于不同宿主的差异:Cursor、Codex CLI、Claude Code 在 SKILL.md 格式下的加载方式不同,但官方资料没有分别说明,此处不展开。

典型用法

以下触发方式取自官方简介,属于”用户怎么说,Skill 就会被唤起”的用法,而非一段可直接复制的脚本:

  • “给 13800138000 发一条飞书消息,说明今晚的发布改到十点”
  • “给手机用户发飞书通知,提醒他审批还差一条”
  • “把这段文本用飞书发给这个手机号”

从流程上看,实际执行就是:Agent 从话术里提取手机号与正文 → 用 APP_ID/APP_SECRET 初始化 lark_oapi → 按手机号查用户 → 发送文本消息。

适用场景与注意

适合:已经在用 Agent 跑业务流,且需要按手机号通知单个飞书用户的场景,例如审批提醒、账号变动通知、定时提醒。

需要注意的几点:

  1. 只支持文本消息,图片、卡片、富文本不在能力范围内。
  2. 手机号必须能在飞书组织内匹配到唯一用户,匹配不到就发不出去,这个边界条件要由调用方处理。
  3. 凭证权限决定能不能用:手机号查用户和发消息是两个独立权限,缺一不可。
  4. 该 Skill 来自社区(community),发布者为 user_44bc168a,内部实现依赖 lark_oapi 与开放平台接口;上线前建议在测试环境验证一次完整链路。
  5. 页面显示安装数为 6,属于使用量很小的社区 Skill,团队引入时需自行承担维护风险。

结尾

这个 Skill 的价值在于把”按手机号发飞书文本消息”这条链路的重复工作收敛成一个可调用的技能,适合已经跑通 Agent 流程、只想补一个通知出口的开发者。如果你的需求涉及卡片、富文本或批量发送,它不覆盖,需要另找方案。

官方地址:https://api.skillhub.cn/user_44bc168a/feishu-send-message-by-mobile

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye