ai_member_xiaoxi/skills/feishu-wiki-content-reader/SKILL.md

飞书知识库内容读取技能

功能说明

批量读取飞书知识库中指定文档及其所有子文档的内容，支持结构化提取文档内容，用于后续分析、整理和同步。

使用场景

1. 需要批量获取知识库中某目录下所有文档内容
2. 需要读取指定文档及其子文档做内容分析
3. 需要迁移或备份知识库内容
4. 需要同步知识库内容到其他存储位置

前置条件

• 已获取飞书用户授权（包含知识库读取权限）
• 已知目标文档的飞书URL或node_token

操作步骤

1. 获取文档子文档列表

如果需要读取目录下的所有子文档，先调用接口获取子文档列表：

{
  "name": "feishu_wiki_space_node",
  "parameters": {
    "action": "list",
    "parent_node_token": "<目标文档的node_token>",
    "space_id": "<文档所在知识空间的space_id>"
  }
}

• 可以通过文档URL提取node_token，例如URL：https://makee-interactive.feishu.cn/wiki/R8REwpLPxikYUEkLsdCcGy7pnCh 中的 R8REwpLPxikYUEkLsdCcGy7pnCh 就是node_token
• space_id可以通过get接口查询文档信息获取

2. 读取单个文档内容

对每个子文档，调用接口读取内容：

{
  "name": "feishu_fetch_doc",
  "parameters": {
    "doc_id": "<子文档的node_token或URL>"
  }
}

• 支持直接传入文档URL，工具会自动解析node_token
• 返回内容为Markdown格式，保留文档结构、表格、链接等元素

3. 批量读取完整流程示例

# 第一步：获取目录下所有子文档
GET子文档列表 → 得到所有子文档的node_token和标题

# 第二步：遍历读取每个子文档
FOR 每个子文档 IN 子文档列表:
    读取子文档内容 → 保存到本地或内存

# 第三步：内容处理（可选）
合并/整理/分析读取到的所有文档内容

示例

读取「L2 数据分析」目录下所有子文档

1. 目标文档URL：https://makee-interactive.feishu.cn/wiki/R8REwpLPxikYUEkLsdCcGy7pnCh
2. 调用feishu_wiki_space_node的list接口，获取到3个子文档
3. 分别调用feishu_fetch_doc读取每个子文档内容
4. 得到所有3个文档的完整Markdown内容

注意事项

1. 每个子文档的读取需要单独调用接口
2. 如果文档内容过大，需要使用offset参数分页读取
3. 需要确保用户已授权知识库读取权限，否则会返回授权失败
4. 文档中的图片、附件等资源需要单独调用下载接口获取