auto-sync: feishu-wiki-content-reader 2026-04-03_16:06

SKILL.md

@@ -0,0 +1,70 @@
+# 飞书知识库内容读取技能
+
+## 功能说明
+批量读取飞书知识库中指定文档及其所有子文档的内容，支持结构化提取文档内容，用于后续分析、整理和同步。
+
+## 使用场景
+1. 需要批量获取知识库中某目录下所有文档内容
+2. 需要读取指定文档及其子文档做内容分析
+3. 需要迁移或备份知识库内容
+4. 需要同步知识库内容到其他存储位置
+
+## 前置条件
+- 已获取飞书用户授权（包含知识库读取权限）
+- 已知目标文档的飞书URL或node_token
+
+## 操作步骤
+
+### 1. 获取文档子文档列表
+如果需要读取目录下的所有子文档，先调用接口获取子文档列表：
+```json
+{
+  "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. 读取单个文档内容
+对每个子文档，调用接口读取内容：
+```json
+{
+  "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. 文档中的图片、附件等资源需要单独调用下载接口获取