mcpField
F
feishu-cli-messaging

feishu-cli-messaging

github.com/riba2534Productivity1.4k133 installsUpdated 3w ago
Repository

About feishu-cli-messaging

feishu-cli-messaging is a skill for Feishu messaging tasks, routing message, chat, card, and event operations to dedicated workflows. It includes guidance for recipient checks, send confirmation, idempotent retries, and card validation.

Key features

  1. 01Intent-based workflow routing
  2. 02Send, reply to, and forward messages
  3. 03Inspect chat history and members
  4. 04Build and validate interactive cards
  5. 05Subscribe to and consume live events

Use cases

  1. 01Send or reply to a Feishu message
  2. 02Search message history and manage reactions
  3. 03Create and send an interactive card
  4. 04Subscribe to real-time message events

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-messaging

After installing, type/feishu-cli-messagingin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/
evals.json
references/workflows/card/assets/
README.md
references/workflows/card/assets/headers/modern-minimal/
manifest.json
references/workflows/card/assets/icons/doodle/
manifest.jsonl
references/workflows/card/assets/icons/phosphor/
manifest.jsonl
references/workflows/card/assets/themes/
custom-visual-palettes.json
modern-minimal-tokens.json
references/workflows/card/references/
components.md
content-quality.md
design.md
styles.md
v2-vs-v1.md
vchart-quickref.md
references/workflows/card/references/styles/
dashboard.md
references/workflows/card/references/styles/custom-visual/
design.md
index.md
references/workflows/card/references/styles/modern-minimal/
basic.md
components.md
design.md
index.md
references/workflows/card/scripts/
lint_card.py
style_assets.py
test_lint_card.py
test_style_assets.py
references/workflows/card/templates/
alert.json
approval.json
article-summary.json
data-dashboard.json
llm-streaming.json
notification.json

Details

From the project README

飞书即时消息

加载工作流后，将其中 references/、scripts/、templates/、examples/ 相对路径按该 workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

路由

意图读取文件
发送、回复、转发、加急、flag、资源下载references/workflows/msg/workflow.md
历史消息、详情、Reaction、Pin、撤回、群和成员references/workflows/chat/workflow.md
设计和生成 V2 interactive 卡片 JSONreferences/workflows/card/workflow.md
订阅和消费实时事件references/workflows/event/workflow.md

发送交互卡片时先读取 card 构造 JSON，再读取 msg 发送。搜索历史消息关键词时读取 ../feishu-cli-platform/references/workflows/search/workflow.md。

执行规则

  1. 发送前确认接收者类型和 ID；不要把 email、open_id、chat_id 混用。
  2. 群发、加急和删除消息有外部影响，先展示目标和数量。
  3. msg send 与 msg reply 共用内容快捷参数；本地图片、文件、Opus 音频、MP4 视频会先上传， 任一文件缺失、格式非法或上传失败都会阻止提交消息。--upload-images 同时适用于两条命令。
  4. 进入既有话题必须使用 msg reply <om_xxx>；omt_xxx 仅用于话题查询/转发，不能作为 msg send 的接收者。普通消息群开启新话题时才加 --reply-in-thread。
  5. 发送与回复重试都使用同一 --idempotency-key；媒体上传可能重做，但服务端幂等键防止 可见消息重复。只有命令返回非空 message_id 才判定成功。
  6. 外部群 232033 的排错读取 references/workflows/chat/references/external-chat.md。
  7. 完整 Card JSON 2.0 的发送候选运行 card workflow 的 lint_card.py --strict； template_id/card_id 引用按 msg workflow 校验引用结构与实际 ID，不送入完整 JSON 的 linter。 接收者和卡片引用必须来自本次请求、已授权上下文或配置，不能把示例值当默认值。
  8. 用户点名卡片风格时使用 card workflow 内置的 19 个预设；使用本地头图或图标素材时， lint 与实际的 msg send / msg reply 都传 --upload-images，不要固化跨租户 img_key。

Comments

Markdown supported