| name | feishu-cli-messaging |
| description | 飞书即时消息统一入口，覆盖发送、回复、转发、合并转发、加急和资源下载，读取聊天历史、 Reaction、Pin 和群成员管理，构造 V2 交互卡片，以及 WebSocket 事件订阅。用户要求发消息或通知、 查看或导出群聊、管理群成员、制作告警/审批/报告/dashboard/营销宣传/节日贺卡/品牌展示/ 手绘或深色创意/带按钮或图表的飞书卡片、监听消息或审批实时事件、处理消息附件时必须使用本 Skill。只要目标载体是飞书聊天或群消息，或者请求出现 msg/chat/card/event、post/interactive、 oc_/om_、Reaction、Pin、加急或消息内本地图片，即使用户没明确说 CLI，也必须触发本 Skill。 不要用于邮件读取/回复/草稿，也不要用于会议录制、妙记或逐字稿；这些分别使用 feishu-cli-mail 和 feishu-cli-meetings。全局消息搜索使用 feishu-cli-platform。 |
| argument-hint | <msg|chat|card|event> [args] |
| user-invocable | true |
| allowed-tools | Bash(feishu-cli:*), Bash(./feishu-cli:*), Bash(jq:*), Bash(python3:*), Read, Write |
飞书即时消息
加载工作流后，将其中 references/、scripts/、templates/、examples/ 相对路径按该
workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。
路由
| 意图 | 读取文件 |
|---|
| 发送、回复、转发、加急、flag、资源下载 | references/workflows/msg/workflow.md |
| 历史消息、详情、Reaction、Pin、撤回、群和成员 | references/workflows/chat/workflow.md |
| 设计和生成 V2 interactive 卡片 JSON | references/workflows/card/workflow.md |
| 订阅和消费实时事件 | references/workflows/event/workflow.md |
发送交互卡片时先读取 card 构造 JSON，再读取 msg 发送。搜索历史消息关键词时读取
../feishu-cli-platform/references/workflows/search/workflow.md。
执行规则
- 发送前确认接收者类型和 ID；不要把 email、open_id、chat_id 混用。
- 群发、加急和删除消息有外部影响，先展示目标和数量。
msg send 与 msg reply 共用内容快捷参数；本地图片、文件、Opus 音频、MP4 视频会先上传，
任一文件缺失、格式非法或上传失败都会阻止提交消息。--upload-images 同时适用于两条命令。- 进入既有话题必须使用
msg reply <om_xxx>；omt_xxx 仅用于话题查询/转发，不能作为
msg send 的接收者。普通消息群开启新话题时才加 --reply-in-thread。
- 发送与回复重试都使用同一
--idempotency-key；媒体上传可能重做，但服务端幂等键防止
可见消息重复。只有命令返回非空 message_id 才判定成功。
- 外部群 232033 的排错读取
references/workflows/chat/references/external-chat.md。
- 卡片草稿与发送候选分开校验；发送前必须运行 card workflow 的
lint_card.py --strict，不得发送含占位符、示例 ID、假链接或未接通回调按钮的卡片。
- 用户点名卡片风格时使用 card workflow 内置的 19 个预设；使用本地头图或图标素材时，
lint 与实际的
msg send / msg reply 都传 --upload-images，不要固化跨租户 img_key。
