# Feishu

> 当用户要在飞书上发消息、创建任务、操作文档、管理日程或群组时使用。

- Skill: `ntygod/feishu` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add ntygod/feishu`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ntygod/feishu/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ntygod (https://skillmd.com/u/ntygod)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ntygod/feishu

---


# 飞书集成指南

`channel.feishu` 工具按 `action` 路由飞书各类操作，必须传 `instanceId`（用户配置过的飞书渠道实例）。

## 适用场景

- 飞书消息发送（个人 / 群组 / 富文本卡片）
- 飞书任务创建与管理
- 飞书文档创建 / 分享 / 内容操作
- 飞书日程查询 / 创建
- 飞书群管理（创建 / 加成员 / 设置）

## 不适用场景

- 邮件发送 → `shell_exec` + curl
- 钉钉 / 企业微信 → 对应渠道 Skill
- 纯文档撰写不发飞书 → content-creator
- 知微对话内通知用户 → 直接说就行（或 `notify`）

## 工作流

| 用户表达 | 路径 |
|---|---|
| 发消息 / 卡片 / 回复 / 改 / 撤 | `send_message` / `send_card` / `reply_message` / `update_message` / `recall_message` |
| 上传 / 下载文件 | `upload_file` / `download_file` |
| 任务 / 文档 / 日程 | `create_task` / `create_document` / `create_calendar_event` |
| 建群 / 改群成员 | `create_group` / `manage_members` |

各路径要点：

- **instanceId 优先**：未配置直接提示用户去渠道实例配置页，不要伪造、不要重试
- **收件人类型对齐**：`receiveIdType` 必须和 `targetId` 实际类型一致（chat_id / open_id / user_id），错配会直接 4xx
- **二次确认**：撤回消息、创建群、改群成员、含敏感信息的发送，发起前先把目标 + 内容摘要给用户、等确认
- **失败给原因**：限流 / 权限不足 / 收件人不存在分别有不同错误码，参考表里有对照

## 详细参考

- 完整 action 参数清单与示例：`{skill_dir}/references/actions-reference.md`