EthanYoQ 飞书自动化
这个 Skill 以飞书官方文档与官方仓库为准，不再把 Skill 自己当作事实源。
官方来源
- OpenAPI MCP 官方仓库: https://github.com/larksuite/lark-openapi-mcp
- MCP 概览: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/mcp_integration/mcp_introduction
- 自建应用开发流程: https://open.feishu.cn/document/home/introduction-to-custom-app-development/self-built-application-development-process
- 官方配置指南: https://github.com/larksuite/lark-openapi-mcp/blob/main/docs/usage/configuration/configuration.md
- 官方 CLI 参考: https://github.com/larksuite/lark-openapi-mcp/blob/main/docs/reference/cli/cli.md
使用前提
- 当前会话必须已经加载
mcp__lark-mcp_*。 - 如果工具不存在，先运行：
node .agents/skills/feishu-automation/feishu-mcp-setup.js <app_id> <app_secret>
- 脚本会优先写入
~/.codex/config.toml，仅在 Codex 配置不存在时回退到~/.claude.json。 - 配置完成后必须重启 Codex，新 MCP server 才会生效。
官方 MCP 配置原则
- 使用官方包：
@larksuiteoapi/lark-mcp - 默认使用应用身份，不启用 OAuth
- 默认使用飞书中国区，不额外传
--domain - 工具命名固定为
camel
对应官方 MCP 命令形态为：
npx -y @larksuiteoapi/lark-mcp mcp \
-a <app_id> \
-s <app_secret> \
-t preset.light,preset.default,preset.im.default,preset.base.default,preset.base.batch,preset.doc.default,preset.task.default,preset.calendar.default,docx.v1.documentBlock.patch,docx.v1.documentBlockChildren.create,docx.v1.documentBlockChildren.batchDelete \
-c camel \
-l zh \
--token-mode tenant_access_token
如果后续必须访问用户私有资源，再执行官方登录命令：
npx -y @larksuiteoapi/lark-mcp login -a <app_id> -s <app_secret>
然后在 MCP 配置里追加：
--oauth --token-mode user_access_token
适合交给 MCP 的能力
- 消息发送与查询
- 群组创建、搜索、成员管理
- Base 创建、表结构与记录读写
- 文档查询、导入、权限设置
- 任务、日历等开放接口能力
不适合交给 MCP 的能力
以下动作属于飞书开放平台控制台，不应假设能由这个 Skill 自动完成：
- 事件订阅配置
- 权限开关勾选
- 机器人“仅接收被 @ 消息”等后场范围设置
- 发布新版本
另外，基于官方仓库当前说明，以下能力仍有限制：
- 文件上传/下载暂不支持
- 飞书云文档直接编辑暂不支持
因此，本项目的 PDF/DOCX 下载与解析继续保留在后端实现，不迁移到 MCP。
使用规则
- 用户要求“飞书自动化”时，优先确认
mcp__lark-mcp_*是否可用。 - 如果工具不可用，先补 MCP，再继续自动化，不要把 Skill 本身假装成 MCP。
- 若任务涉及开放平台后台发布或权限切换，明确说明这是控制台动作，再把 MCP 用于后续 OpenAPI 验证或数据同步。
- 对当前仓库，优先把 MCP 用在 Bot、群、Base、文档导入、消息发送等动作上。