Feishu automation

飞书自动化

这个 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

使用前提

1. 当前会话必须已经加载 mcp__lark-mcp_*。
2. 如果工具不存在，先运行：

node .agents/skills/feishu-automation/feishu-mcp-setup.js <app_id> <app_secret>

3. 脚本会优先写入 ~/.codex/config.toml，仅在 Codex 配置不存在时回退到 ~/.claude.json。
4. 配置完成后必须重启 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、文档导入、消息发送等动作上。