Skills feishu-doc

install

source · Clone the upstream repo

git clone https://github.com/wulaosiji/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/wulaosiji/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/feishu-doc" ~/.claude/skills/wulaosiji-skills-feishu-doc && rm -rf "$T"

manifest: feishu-doc/SKILL.md

source content

Feishu Document Tool (Read-Only)

飞书文档只读工具。支持读取、解析文档内容。

When to Use

需要快速预览飞书文档的纯文本内容时
需要提取文档中的表格、图片等结构化数据时
需要获取文档中的特定块内容时
需要验证文档是否存在且可访问时

Do NOT use this skill if

需要创建新文档 → 使用
```
feishu-doc-orchestrator
```
需要修改现有文档 → 使用
```
feishu-doc-orchestrator
```
需要创建到知识库 → 使用
```
feishu-wiki-orchestrator
```
需要下载原始文件 → 使用
```
feishu-pdf-downloader
```

Typical Trigger Phrases

"帮我读一下这个飞书文档"
"Read this Feishu document for me"
"提取文档里的表格数据"
"Get the content from this docx link"

Workflow

Ask for inputs: 确认飞书文档 URL 或 doc_token

Extract token: 从 URL

https://xxx.feishu.cn/docx/ABC123def

提取

doc_token

Quick read: 执行

read

操作获取标题、纯文本内容、块统计

{ "action": "read", "doc_token": "ABC123def" }

Check hints: 如果响应中的
```
hint
```
字段存在，或
```
block_types
```
包含
```
Table
```
/
```
Image
```
，说明需要进一步提取结构化内容

List blocks（如需要）: 执行

list_blocks

获取完整结构化数据

{ "action": "list_blocks", "doc_token": "ABC123def" }

Get specific block（如需要）: 执行

get_block

精准获取特定部分

{ "action": "get_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }

Return summary: 返回文档内容摘要或结构化数据

Guardrails

本技能严格只读，不支持
```
create
```
、
```
write
```
、
```
append
```
、
```
update_block
```
、
```
delete_block
```
如需写入操作，必须使用
```
feishu-doc-orchestrator
```
原
```
feishu-doc
```
的写入操作存在以下问题，因此已禁用：
- ```
create
```
  和
```
write
```
  分离，容易创建空文档
- 表格格式不支持
- 位置控制弱（容易创建到错误位置）
- 无原子性保证

Use Cases

需求	推荐操作	说明
快速了解文档内容	`read`	纯文本，速度快
需要表格数据	`list_blocks`	包含完整结构化数据
只需要特定部分	`get_block`	精准获取，节省 Token
检查文档是否存在	`read`	轻量级验证

Related Skills

feishu-doc-orchestrator - 创建和修改飞书文档
feishu-wiki-orchestrator - 知识库文档操作
feishu-doc-converter - 文档格式转换
feishu-pdf-downloader - 下载飞书文件

About

Part of the Feishu automation toolkit by UniqueClub. 🌐 https://uniqueclub.ai