mcpField
F
feishu-cli-messaging

feishu-cli-messaging

github.com/riba2534生産性1.4k133 回インストール3 週間前に更新
リポジトリ

feishu-cli-messaging について

feishu-cli-messagingは、Feishuのメッセージ操作向けスキルです。メッセージ、チャット、カード、イベントの作業を専用ワークフローに振り分け、宛先確認、送信前確認、冪等な再試行、カード検証の手順を示します。

主な機能

  1. 01意図に応じたワークフロー選択
  2. 02メッセージの送信・返信・転送
  3. 03チャット履歴とメンバーの確認
  4. 04インタラクティブカードの作成と検証
  5. 05リアルタイムイベントの購読と処理

活用シーン

  1. 01Feishuメッセージの送信や返信
  2. 02メッセージ履歴の検索とリアクション管理
  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。

コメント