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:readonlyscope - 写入需要
docx:documentscope - Wiki 操作需要
wiki:wiki相关 scope - 通过 CLI 创建文档时，会自动返回
url与applink_url - 创建文档后，CLI 会尝试默认给当前用户开启 管理权限（full_access），无需额外参数；若当前调用身份无法修改协作者权限，则会在返回中给出
manage_permission_warning