Agent Skills: Feishu Doc Skill

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