前言¶
在 Cursor、Claude Code 等环境里做办公自动化时，常见做法是手写飞书开放平台 HTTP 调用，或维护一长串脚本去拼 app_id、tenant_access_token 和各类 API 路径。文档、电子表格、多维表格、IM、通讯录、日程和任务分散在不同文档章节里，Agent 很难在一次对话里稳定串起来。
下面介绍 SkillHub 上的社区 Skill feishu-pro（坐标 @user_10930401/feishu-pro）。它把飞书侧能力整理成 Agent 可读的 SKILL.md 与一套 TypeScript 实现，用环境变量完成应用鉴权，适合把「在飞书里查、写、发」交给对话完成。
这是什么¶
feishu-pro 是面向 Agent 的飞书（Lark）集成套件。SkillHub 分类为 office-efficiency，来源为社区（发布者 user_10930401），当前商店页标注版本 v1.0.0。简介与 Skill 元数据一致：文档 / 表格 / 多维表格 / 消息 / 群聊 / 通讯录 / 日程 / 任务 / 翻译 / OCR / 语音。
Skill 声明需要 API 密钥（requires_api_key=true）。安装后 Agent 读取 SKILL.md 中的接口清单与协作注意事项，在具备 FEISHU_APP_ID、FEISHU_APP_SECRET 的前提下调用封装好的方法。
核心功能¶
以下能力均来自 Skill 自带的 SKILL.md API 总览，按模块划分。
文档 / 知识库 / 云空间（Docs）¶
支持创建与读取文档、拉取纯文本与块结构、追加文本或块、云空间文件与文件夹、Wiki 空间与节点查询，以及文档/节点的公开权限与成员权限管理（如 createDocument、getDocumentRawContent、uploadFile、listWikiSpaces 等）。
表格与多维表格（Data）¶
覆盖电子表格的读写与追加（getSheetValues、updateSheetValues、appendSheetValues 等），以及多维表格记录的增删改查与批量操作（listRecords、createRecord、batchUpdateRecords、copyBitable 等）。
IM 消息 / 话题 / 群聊（IM）¶
包括消息列表、撤回与更新、Pin、表情回复、附件发送、话题内回复、群信息与成员管理、建群与进退群（如 listMessages、replyInThread、react、createChat、addChatMembers）。
组织 / 通讯录 / 日程 / 任务（Org）¶
用户与部门查询、用户组、日历与日程创建删除、任务列表与完成（如 getUser、listDepartmentUsers、createCalendarEvent、createTask、completeTask）。
AI 能力（AI）¶
translateText、detectLanguage、ocrImage、speechToText，用于翻译、语种检测、图片 OCR 与语音转文字。
Skill 内还写了飞书协作上的实践说明：发文档前应先处理可读权限；若缺少 docs:permission.setting:write_only（错误码 99991672），可优先在已公开文件夹内创建文档、通过 IM 转发内容，或在已公开 Wiki 空间建页等。
权限范围由包内 feishu_base_permissions.json（当前可用）与 feishu_additional_permissions.json（可能需企业审批的扩展权限）描述；未获批时相关能力会降级关闭。
安装与启用¶
通过 SkillHub CLI 安装（推荐）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装说明执行（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 feishu-pro 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 下，Agent 可能识别不到。常用路径如下（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 环境下的示例：
skillhub install @user_10930401/feishu-pro --dir ~/.cursor/skills/
SkillHub 技能页也支持把下面提示交给 AI，由其按 SkillHub 安装说明 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_10930401/feishu-pro`。
安装完成后重启或重新加载 Agent，使新 Skill 生效。
飞书应用配置¶
在运行 Agent 的环境中设置：
export FEISHU_APP_ID="你的飞书应用 App ID"
export FEISHU_APP_SECRET="你的飞书应用 App Secret"
飞书开放平台需为应用开通 Skill 实际会调用的权限；与 feishu_base_permissions.json、feishu_additional_permissions.json 中声明的 scope 对齐，避免调用时报权限不足。
若你从 OpenClaw 源码树单独编译该 Skill，README 中另有 npm install && npm run build 的步骤；通过 SkillHub 安装的包通常已包含构建产物，一般无需再跑一遍 monorepo 路径下的编译命令。
典型用法¶
经过上面的步骤后，用法主要是：配置环境变量 → 在对话中说明飞书侧目标 → Agent 按 SKILL.md 选择对应 API。
- 确认
FEISHU_APP_ID、FEISHU_APP_SECRET已在当前 shell 或 Agent 运行环境中生效。 - 在 Cursor 等客户端开启新对话，确保已加载
feishu-pro。 - 用自然语言描述操作，并尽量给出飞书侧标识（如
documentId、chatId、appToken/tableId、文件夹folderToken等）。Agent 应映射到文档中的方法名，例如：
- 创建标题为「周报」的云文档 →createDocument
- 读取某表格区间 →getSheetValues
- 在多维表格新增一行 →createRecord
- 在群话题下回复 →replyInThread
- 对消息添加表情 →react
无需自行拼接 REST URL；具体参数形状以 Skill 源码与飞书开放平台文档为准，由 Agent 在调用前补全。
适用场景与注意¶
适合谁
- 已在用飞书做协同，希望 Agent 代劳文档写入、表格/多维表格维护、群消息与日程任务等重复操作的人。
- 愿意在飞书开放平台维护企业自建应用，并能按 JSON 权限清单申请 scope 的团队。
限制与注意
- 依赖有效的飞书应用凭证；SkillHub 标记
requires_api_key=true，未配置密钥时无法鉴权。 - 部分文档权限能力依赖企业是否批准扩展权限；Skill 文档明确写了 99991672 等场景下的降级与替代做法，部署前宜先在企业内验证权限模型。
- 商店统计（截至资料抓取）：评分 100000，下载约 1234 次；实际体验仍取决于你的租户权限与 Agent 对 Skill 的遵循程度。
- 社区来源 Skill，升级与问题反馈以 SkillHub 页面与包内 README 为准。
结尾¶
feishu-pro 把飞书文档、表格、IM、组织与 AI 辅助能力收敛到一份 Agent Skill 里，用统一环境变量和 API 清单降低对接成本。若你正在 SkillHub 上找办公类能力，可以从官方技能页入手核对版本与安装方式：
- SkillHub：https://www.skillhub.cn/skills/user_10930401/feishu-pro
- API 入口：https://api.skillhub.cn/user_10930401/feishu-pro
