飞书文档管理助手:让 Agent 通过 Open API 操作飞书文档

前言

在飞书(Lark)里写文档、改格式、整理目录,通常要在客户端里点选,或自己写脚本调飞书开放平台接口。前者难批量、难和编码助手联动;后者要查文档、维护 token 和错误处理,成本高。若希望对话里直接说「建一篇文档」「把这段内容追加进去」「按关键词搜云文档」,需要一套把飞书 Open API 封装成 Agent 可执行步骤的能力。下面介绍 SkillHub 社区 Skill「飞书文档管理助手」,面向上述需求。

这是什么

「飞书文档管理助手」是发布在 SkillHub 上的社区 Skill,坐标为 @user_f8b61f8a/feishu-doc-manager-v2,当前版本 1.0.0,分类为 office-efficiency(办公效率),由发布者 user_f8b61f8a 维护。

官方简介说明:当用户需要在飞书(Lark)上创建、阅读、编辑、搜索或管理文档时使用;通过飞书 Open API 处理文档创建、内容写入与追加、格式设置以及文件夹整理。Skill 带有 requires_api_key=true 标签,表示运行前需要配置与开放平台相关的密钥或凭证(具体字段以安装后的 SKILL.md 为准)。

在 SkillHub 上,该 Skill 评分为 100000,下载 932 次(页面统计,撰写时以 SkillHub 展示为准)。

核心功能

以下能力均来自 SkillHub 页面与已抓取元数据中的简介,未单独展开的实现细节以 Skill 包内说明为准。

  1. 文档生命周期:创建、读取、编辑、搜索与管理飞书文档。
  2. 内容与格式:写入正文、追加内容、进行格式化相关操作(依托飞书 Open API)。
  3. 目录组织:支持文件夹层面的整理与管理。

适用平台表述为 Feishu / Lark,实现路径统一为飞书 Open API,而非模拟用户在客户端内的点击操作。

安装与启用

通过 SkillHub CLI 安装

先按 SkillHub 官方安装说明检查或安装 CLI(完整说明见 SkillHub 安装与优先源配置):

command -v skillhub && skillhub --version

若未安装 CLI,可使用官方脚本(节选):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装本 Skill 时,必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/,可能不会被识别。各客户端路径不同,安装文档中给出的示例如下:

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

安装命令形式为:

skillhub install @user_f8b61f8a/feishu-doc-manager-v2 --dir <你的 skills 目录>

也可将下面提示词发给支持 Skill 安装的 AI,让其按官方流程完成安装:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_f8b61f8a/feishu-doc-manager-v2`。

凭证与 API

Skill 标记为需要 API Key。实际使用前,需在飞书开放平台创建应用并取得调用文档接口所需的权限与凭证,并按 Skill 包内 SKILL.md 的说明配置到 Agent 环境。未在公开页面列出具体环境变量名时,不要自行猜测字段名,以安装后文档为准。

安装或更新 Skill 后,按你所用客户端要求重启或刷新 Agent,以便加载新 Skill。

典型用法

公开页面未提供独立脚本示例;可复现的入口有两类。

1. 安装引导(官方页面原文)

向 AI 发送:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_f8b61f8a/feishu-doc-manager-v2`。

2. 任务描述(与简介一致的触发方式)

在 Skill 已安装且 API 已配置的前提下,用自然语言描述飞书文档相关任务,例如:在指定空间创建文档、读取某文档内容、追加段落、搜索标题关键词、将文档移动到某文件夹。Agent 应在 Skill 指引下调用飞书 Open API 完成操作。具体参数与接口以 Skill 内流程及飞书开放平台文档为准。

适用场景与注意

适合谁

  • 已在用 Cursor、Claude Code、Codex 等支持 Skills 的 Agent,且文档协作集中在飞书/ Lark 的团队或个人。
  • 愿意在开放平台侧维护应用与权限,并接受通过 API 而非纯 UI 操作文档。

限制与注意

  • 社区来源(community),行为与维护节奏取决于发布者与 Skill 版本;升级前可用 skillhub 查看版本 1.0.0 是否有更新。
  • 依赖网络与飞书 Open API 配额、权限;requires_api_key=true 表示未配置凭证时 Skill 无法正常工作。
  • 公开统计中的「安装」次数可能与各客户端本地安装方式不一致,以你本机 skills 目录是否出现该 Skill 为准。
  • 本介绍不包含飞书企业合规、数据出境等策略说明;生产环境请按组织安全规范审批应用权限。

结尾

「飞书文档管理助手」把飞书文档的创建、读写、搜索、格式与文件夹整理收敛为 Agent Skill,减少手写 Open API 调用的重复劳动。若你正在 SkillHub 上选型办公类 Skill,可从官方页面查看说明并安装:https://www.skillhub.cn/skills/user_f8b61f8a/feishu-doc-manager-v2(API 入口:https://api.skillhub.cn/user_f8b61f8a/feishu-doc-manager-v2)。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜