飞书协作自动化

它解决什么问题

在飞书上做协作自动化，常见卡点不是某个具体 API 怎么写，而是权限范围、应用发布状态、凭证管理和调用链路没有统一入口。多维表格、消息、云文档和日历又分属不同业务域，手动拼调用很容易出现 scope 未开通、应用未发布、token 过期或频控触发等失败，排查成本很高。

这个技能面向办公效率场景，把飞书协作自动化收敛成一条可复用的工作路径：先确认目标对象，再检查应用与 MCP 配置，最后通过 MCP 工具或开放 API 执行动作。它的价值在于给出稳定的调用骨架和失败分类，而不是替用户保管凭证去调真实接口。

技能能做什么

核心能力覆盖飞书办公协作中的高频对象：

• 多维表格：把结构化数据写入 Bitable、整理记录、承接表格自动记录类诉求
• 消息通知：通过飞书机器人发送消息，或把结果推送到飞书群
• 云文档：生成、整理飞书云文档，减少手工创建和格式搬运
• 日历同步：把日程写入或同步到飞书日历
• 接入与排查：配置飞书自建应用、接入飞书官方 MCP，并按错误类别排查 API 报错

调用时建议遵循以下流程：

1. 明确用户目标：是表格、消息、文档，还是日历
2. 检查飞书应用凭证与 MCP 是否已配置；未配置时先引导完成 FEISHU_APP_ID、FEISHU_APP_SECRET 等前置步骤
3. 优先通过飞书官方 MCP 工具执行动作；在合适场景也可按开放 API 路径调用，例如获取 tenant_access_token 后访问 https://open.feishu.cn/open-apis/
4. 返回结果摘要；失败时给出错误码与排查方向

适用边界与注意点

该技能只操作用户自有应用和授权范围内的数据，不越权读取他人空间。App Secret 不应被存储、回传或泄露，只应放在用户本地的 mcp.json、环境变量或等价的本地配置中。

批量写入、群消息推送、日历批量创建等动作需要提前做节流，避免触发飞书频控。工具本身提供方法指引与调用骨架，不代替用户持有凭证访问真实接口；权限未开、应用未发布、token 过期和频控限流都需要按飞书官方文档的最新规则复核。