Agent skill

feishu-fetch-doc

获取飞书云文档内容。返回文档的 Markdown 内容,支持处理文档中的图片、文件和画板(需配合 feishu_doc_media 工具)。

Stars 5,205
Forks 557

Install this agent skill to your Project

npx add-skill https://github.com/op7418/CodePilot/tree/main/资料/feishu-openclaw-plugin/package/skills/feishu-fetch-doc

SKILL.md

feishu_mcp_fetch_doc

获取飞书云文档的 Markdown 内容(Lark-flavored 格式)。

重要:图片、文件、画板的处理

文档中的图片、文件、画板需要通过 feishu_doc_media(action: download)工具单独获取!

识别格式

返回的 Markdown 中,媒体文件以 HTML 标签形式出现:

  • 图片

    html
    <image token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" width="1833" height="2491" align="center"/>
    
  • 文件

    html
    <view type="1">
      <file token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc" name="skills.zip"/>
    </view>
    
  • 画板

    html
    <whiteboard token="Z1FjxxxxxxxxxxxxxxxxxxxtnAc"/>
    

获取步骤

  1. 从 HTML 标签中提取 token 属性值
  2. 调用 feishu_doc_media 下载:
    json
    {
      "action": "download",
      "resource_token": "提取的token",
      "resource_type": "media",
      "output_path": "/path/to/save/file"
    }
    

参数

  • doc_id(必填):支持直接传文档 URL 或 token
    • 直接传 URL:https://xxx.feishu.cn/docx/Z1FjxxxxxxxxxxxxxxxxxxxtnAc(系统自动提取 token)
    • 直接传 token:Z1FjxxxxxxxxxxxxxxxxxxxtnAc
    • 知识库 URL/token 也支持:https://xxx.feishu.cn/wiki/Z1FjxxxxxxxxxxxxxxxxxxxtnAcZ1FjxxxxxxxxxxxxxxxxxxxtnAc

Wiki URL 处理策略

知识库链接(/wiki/TOKEN)背后可能是云文档、电子表格、多维表格等不同类型的文档。当不确定类型时, 不能直接假设是云文档,必须先查询实际类型。

处理流程

  1. 先调用 feishu_wiki_space_node(action: get)解析 wiki token
    json
    { "action": "get", "token": "wiki_token_here" }
    
  2. 从返回的 node 中获取 obj_type(实际文档类型)和 obj_token(实际文档 token)
  3. 根据 obj_type 调用对应工具
obj_type 工具 传参
docx feishu_mcp_fetch_doc doc_id = obj_token
sheet feishu_sheet spreadsheet_token = obj_token
bitable feishu_bitable_* 系列 app_token = obj_token
其他 告知用户暂不支持该类型

示例

用户:帮我看下这个文档 https://xxx.feishu.cn/wiki/ABC123

  1. 调用 feishu_wiki_space_node(action: get, token: ABC123)
  2. 返回 obj_type: "docx", obj_token: "doxcnXYZ789"
  3. 调用 feishu_mcp_fetch_doc(doc_id: doxcnXYZ789)

工具组合

需求 工具
获取文档文本 feishu_mcp_fetch_doc
下载图片/文件/画板 feishu_doc_media(action: download)
解析 wiki token 类型 feishu_wiki_space_node(action: get)
读写电子表格 feishu_sheet
操作多维表格 feishu_bitable_* 系列

Expand your agent's capabilities with these related and highly-rated skills.

op7418/CodePilot

feishu-im-read

飞书 IM 消息读取工具使用指南,覆盖会话消息获取、话题回复读取、跨会话消息搜索、图片/文件资源下载。 **当以下情况时使用此 Skill**: (1) 需要获取群聊或单聊的历史消息 (2) 需要读取话题(thread)内的回复消息 (3) 需要跨会话搜索消息(按关键词、发送者、时间等条件) (4) 消息中包含图片、文件、音频、视频,需要下载 (5) 用户提到"聊天记录"、"消息"、"群里说了什么"、"话题回复"、"搜索消息"、"图片"、"文件下载" (6) 需要按时间范围过滤消息、分页获取更多消息

5,205 557
Explore
op7418/CodePilot

feishu-troubleshoot

飞书插件问题排查工具。包含常见问题 FAQ 和深度诊断命令(/feishu_doctor)。 常见问题可随时查阅。诊断命令用于排查复杂问题(多次授权仍失败、自动授权无法解决等), 会检查账户配置、API 连通性、应用权限、用户授权状态,并生成详细的诊断报告和解决方案。

5,205 557
Explore
op7418/CodePilot

feishu-create-doc

创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档,支持指定创建位置(文件夹/知识库/知识空间)。

5,205 557
Explore
op7418/CodePilot

feishu-bitable

飞书多维表格(Bitable)的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**: (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录(行数据) (3) 需要管理字段(列)、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格

5,205 557
Explore
op7418/CodePilot

feishu-calendar

飞书日历与日程管理工具集。包含日历管理、日程管理、参会人管理、忙闲查询。

5,205 557
Explore
op7418/CodePilot

feishu-task

飞书任务管理工具,用于创建、查询、更新任务和清单。 **当以下情况时使用此 Skill**: (1) 需要创建、查询、更新、删除任务 (2) 需要创建、管理任务清单 (3) 需要查看任务列表或清单内的任务 (4) 用户提到"任务"、"待办"、"to-do"、"清单"、"task" (5) 需要设置任务负责人、关注人、截止时间

5,205 557
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results