Feishu Doc Skill
快速索引
文档操作
| 用户意图 |
module |
tool_action |
必填参数 |
| 创建文档 |
doc |
create |
可空(建议 title) |
| 读取文档 |
doc |
read |
document_id |
| 读取文档内容 |
doc |
read_content |
document_id |
| 写入 Markdown |
doc |
write_markdown |
document_id, content(或 markdown) |
| 列出文档块 |
doc |
list_blocks |
document_id |
| 更新文本块 |
doc |
update_block_text |
document_id, block_id, content |
Wiki 操作
| 用户意图 |
module |
tool_action |
必填参数 |
| 列出知识空间 |
wiki |
list_spaces |
- |
| 列出节点 |
wiki |
list_nodes |
space_id |
| 创建节点 |
wiki |
create_node |
space_id, title |
| 获取节点 |
wiki |
get_node |
space_id, node_token |
调用示例
创建文档
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "doc",
"tool_action": "create",
"title": "Q1 工作总结",
"folder_token": "fldcnXXXX"
}'
读取文档内容
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "doc",
"tool_action": "read_content",
"document_id": "doccnXXXX"
}'
写入 Markdown 内容
python3 skills/feishu-cli/run.py '{
"action": "tool",
"module": "doc",
"tool_action": "write_markdown",
"document_id": "doccnXXXX",
"content": "## 概述\n\n本季度完成了以下关键目标:\n\n1. 项目 A 上线\n2. 性能优化 30%"
}'
Wiki 操作
# 列出知识空间
python3 skills/feishu-cli/run.py '{"action":"tool","module":"wiki","tool_action":"list_spaces"}'
# 列出节点
python3 skills/feishu-cli/run.py '{"action":"tool","module":"wiki","tool_action":"list_nodes","space_id":"7xxx"}'
核心约束
文档 ID 来源
- URL 中提取:
https://xxx.feishu.cn/docx/doccnXXXX → document_id = "doccnXXXX"
- Wiki URL:先用
wiki get_node 获取 obj_token,再作为 document_id 使用
- API 返回:创建文档后返回
Lark Markdown 与标准 Markdown 差异
飞书文档支持的 Markdown 是 Lark 风味,与标准 GFM 有一些差异:
- 标题: 支持
# 到 ######
- 代码块: 支持
```language 语法
- 表格: 使用
| col1 | col2 | 标准表格语法
- 任务列表: 使用
- [ ] 和 - [x]
- 引用: 使用
> 前缀
- 特殊块: 支持
callout、grid、mermaid、plantuml 等
权限与默认行为
- 读取需要
docx:document:readonly scope
- 写入需要
docx:document scope
- Wiki 操作需要
wiki:wiki 相关 scope
- 通过 CLI 创建文档时,会自动返回
url 与 applink_url
- 创建文档后,CLI 会尝试默认给当前用户开启 管理权限(full_access),无需额外参数;若当前调用身份无法修改协作者权限,则会在返回中给出
manage_permission_warning
1---
2name: feishu-doc
3description: When 飞书云文档 needs creating, reading, or updating → CRUD docs with Lark-flavored Markdown syntax.
4triggers:
5 intent_patterns:
6 - "云文档|document|docx|创建文档|读取文档|更新文档"
7 - "知识库|wiki|知识空间"
8 - "文档内容|写文档|编辑文档"
9 - "帮我.*写到.*文档|write.*to.*doc|更新.*飞书.*文档"
10 - "读.*飞书.*文档|read.*lark.*doc|看下.*这个.*文档"
11 - "新建.*wiki|create.*wiki|发布.*知识库|publish.*wiki"
12 - "文档.*链接|doc.*link|分享.*文档|share.*doc"
13 - "追加.*内容|append.*content|在.*文档.*里.*加|add.*to.*doc"
14 context_signals:
15 keywords: ["doc", "document", "docx", "wiki", "文档", "知识库", "document_id", "写", "读", "创建", "编辑", "分享", "追加"]
16 confidence_threshold: 0.5
17priority: 9
18requires_tools: [bash]
19max_tokens: 300
20cooldown: 15
21metadata:
22 source: https://skillmd.com/skills/cklxx/feishu-doc
23---
24
25# Feishu Doc Skill
26
27## 快速索引
28
29### 文档操作
30
31| 用户意图 | module | tool_action | 必填参数 |
32|---------|--------|-------------|---------|
33| 创建文档 | doc | create | 可空(建议 title) |
34| 读取文档 | doc | read | document_id |
35| 读取文档内容 | doc | read_content | document_id |
36| 写入 Markdown | doc | write_markdown | document_id, content(或 markdown) |
37| 列出文档块 | doc | list_blocks | document_id |
38| 更新文本块 | doc | update_block_text | document_id, block_id, content |
39
40### Wiki 操作
41
42| 用户意图 | module | tool_action | 必填参数 |
43|---------|--------|-------------|---------|
44| 列出知识空间 | wiki | list_spaces | - |
45| 列出节点 | wiki | list_nodes | space_id |
46| 创建节点 | wiki | create_node | space_id, title |
47| 获取节点 | wiki | get_node | space_id, node_token |
48
49## 调用示例
50
51### 创建文档
52
53```bash
54python3 skills/feishu-cli/run.py '{
55 "action": "tool",
56 "module": "doc",
57 "tool_action": "create",
58 "title": "Q1 工作总结",
59 "folder_token": "fldcnXXXX"
60}'
61```
62
63### 读取文档内容
64
65```bash
66python3 skills/feishu-cli/run.py '{
67 "action": "tool",
68 "module": "doc",
69 "tool_action": "read_content",
70 "document_id": "doccnXXXX"
71}'
72```
73
74### 写入 Markdown 内容
75
76```bash
77python3 skills/feishu-cli/run.py '{
78 "action": "tool",
79 "module": "doc",
80 "tool_action": "write_markdown",
81 "document_id": "doccnXXXX",
82 "content": "## 概述\n\n本季度完成了以下关键目标:\n\n1. 项目 A 上线\n2. 性能优化 30%"
83}'
84```
85
86### Wiki 操作
87
88```bash
89# 列出知识空间
90python3 skills/feishu-cli/run.py '{"action":"tool","module":"wiki","tool_action":"list_spaces"}'
91
92# 列出节点
93python3 skills/feishu-cli/run.py '{"action":"tool","module":"wiki","tool_action":"list_nodes","space_id":"7xxx"}'
94```
95
96## 核心约束
97
98### 文档 ID 来源
99
100- URL 中提取:`https://xxx.feishu.cn/docx/doccnXXXX` → `document_id = "doccnXXXX"`
101- Wiki URL:先用 `wiki get_node` 获取 `obj_token`,再作为 `document_id` 使用
102- API 返回:创建文档后返回
103
104### Lark Markdown 与标准 Markdown 差异
105
106飞书文档支持的 Markdown 是 **Lark 风味**,与标准 GFM 有一些差异:
107
108- **标题**: 支持 `#` 到 `######`
109- **代码块**: 支持 ` ```language ` 语法
110- **表格**: 使用 `| col1 | col2 |` 标准表格语法
111- **任务列表**: 使用 `- [ ]` 和 `- [x]`
112- **引用**: 使用 `> ` 前缀
113- **特殊块**: 支持 `callout`、`grid`、`mermaid`、`plantuml` 等
114
115### 权限与默认行为
116
117- 读取需要 `docx:document:readonly` scope
118- 写入需要 `docx:document` scope
119- Wiki 操作需要 `wiki:wiki` 相关 scope
120- 通过 CLI 创建文档时,会自动返回 `url` 与 `applink_url`
121- 创建文档后,CLI 会尝试默认给当前用户开启 **管理权限(full_access)**,无需额外参数;若当前调用身份无法修改协作者权限,则会在返回中给出 `manage_permission_warning`