# Feishu Doc

> When 飞书云文档 needs creating, reading, or updating → CRUD docs with Lark-flavored Markdown syntax.

- Skill: `cklxx/feishu-doc` (Agent Skill)
- Install (CLI): `npx skillmds@latest add cklxx/feishu-doc`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cklxx/feishu-doc/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: cklxx (https://skillmd.com/u/cklxx)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/cklxx/feishu-doc

---


# 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 |

## 调用示例

### 创建文档

```bash
python3 skills/feishu-cli/run.py '{
  "action": "tool",
  "module": "doc",
  "tool_action": "create",
  "title": "Q1 工作总结",
  "folder_token": "fldcnXXXX"
}'
```

### 读取文档内容

```bash
python3 skills/feishu-cli/run.py '{
  "action": "tool",
  "module": "doc",
  "tool_action": "read_content",
  "document_id": "doccnXXXX"
}'
```

### 写入 Markdown 内容

```bash
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 操作

```bash
# 列出知识空间
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`