mcpField
F
feishu-cli-messaging

feishu-cli-messaging

github.com/riba2534生产力1.4k133 次安装3 周前更新
代码仓库

关于 feishu-cli-messaging

feishu-cli-messaging 是用于飞书即时消息操作的技能，将消息、聊天、卡片和实时事件任务路由到相应工作流。它包含接收者校验、发送确认、幂等重试及卡片检查规则。

主要功能

  1. 01按意图选择消息工作流
  2. 02发送、回复与转发消息
  3. 03查询聊天记录和成员
  4. 04构造并检查交互卡片
  5. 05订阅和消费实时事件

适用场景

  1. 01发送或回复飞书消息
  2. 02查询历史消息并管理 Reaction
  3. 03生成并发送交互卡片
  4. 04订阅实时消息事件

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/feishu-cli-messaging确认已加载。

包含的文件

除 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

详细介绍

来自项目 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。

评论

支持 Markdown