Lark Whiteboard
appleweiping/WEIPING_WIKI
飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用 DSL（转成 OpenAPI 格式）、PlantUML/Mermaid 格式更新画板内容。
飞书文档创建前的兼容性检查规范。覆盖 Mermaid/PlantUML 语法限制（8 种图表类型的飞书安全写法）、 表格自动拆分规则（9×9 限制）、Callout/公式/图片处理、API 限制与容错机制。
Install Feishu CLI Doc Guide
$ npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills feishu-cli-doc-guide --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/feishu-cli-doc-guide .claude/skills/feishu-cli-doc-guide && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "feishu-cli-doc-guide" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/feishu-cli-doc-guide into .claude/skills/feishu-cli-doc-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "feishu-cli-doc-guide", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/feishu-cli-doc-guideType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills feishu-cli-doc-guide --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/feishu-cli-doc-guide .agents/skills/feishu-cli-doc-guide && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "feishu-cli-doc-guide" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/feishu-cli-doc-guide into .agents/skills/feishu-cli-doc-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "feishu-cli-doc-guide", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills feishu-cli-doc-guide --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/feishu-cli-doc-guide .cursor/skills/feishu-cli-doc-guide && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "feishu-cli-doc-guide" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/feishu-cli-doc-guide into .cursor/skills/feishu-cli-doc-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "feishu-cli-doc-guide", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/LeoYeAI/openclaw-master-skills.git --path skills/feishu-cli-doc-guide--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills feishu-cli-doc-guide --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/feishu-cli-doc-guide .gemini/skills/feishu-cli-doc-guide && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "feishu-cli-doc-guide" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/feishu-cli-doc-guide into .gemini/skills/feishu-cli-doc-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "feishu-cli-doc-guide", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install LeoYeAI/openclaw-master-skills feishu-cli-doc-guideInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/feishu-cli-doc-guide .github/skills/feishu-cli-doc-guide && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "feishu-cli-doc-guide" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/feishu-cli-doc-guide into .github/skills/feishu-cli-doc-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "feishu-cli-doc-guide", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install LeoYeAI/openclaw-master-skills feishu-cli-doc-guide --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/LeoYeAI/openclaw-master-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/feishu-cli-doc-guide .opencode/skills/feishu-cli-doc-guide && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "feishu-cli-doc-guide" agent skill from https://github.com/LeoYeAI/openclaw-master-skills/tree/main/skills/feishu-cli-doc-guide into .opencode/skills/feishu-cli-doc-guide/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "feishu-cli-doc-guide", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
feishu-cli-doc-guide- GitHub stars
- 2.2k
- Token cost
- ~3k tokens
- SKILL.md length
- 988 words
- Files
- 3 (incl. references)
- Skills in repo
- 972
- Repo updated
- First seen
- Licence
- MIT
At a glance
飞书文档创建前的兼容性检查规范。覆盖 Mermaid/PlantUML 语法限制（8 种图表类型的飞书安全写法）、 表格自动拆分规则（9×9 限制）、Callout/公式/图片处理、API 限制与容错机制。
- Works in 11 steps: 概述 → TL;DR 速查清单 → Mermaid 飞书语法规范 → …
- Tasks that involve Messaging and chat bots
- SKILL.md covers 1. 概述, 2. TL;DR 速查清单, 3. Mermaid 飞书语法规范 and 4. PlantUML 安全子集, plus 5 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Feishu CLI Doc Guide is an agent skill from LeoYeAI/openclaw-master-skills. 飞书文档创建前的兼容性检查规范。覆盖 Mermaid/PlantUML 语法限制（8 种图表类型的飞书安全写法）、 表格自动拆分规则（9×9 限制）、Callout/公式/图片处理、API 限制与容错机制。 被 feishu-cli-write、feishu-cli-import 等技能引用，在生成将要导入飞书的 Markdown 之前必须参考。 确保内容兼容飞书，避免导入失败。
Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `_meta.json` and `references/mermaid-spec.md`).
It sits in Productivity & Automation, covering Messaging and chat bots and Diagrams. It works with Feishu (Lark) and Mermaid. The repository describes itself as: 🧠 Curated collection of 1209+ best OpenClaw skills — weekly updated by MyClaw.ai. The licence is MIT.
When your agent uses it
- Tasks that involve Messaging and chat bots
- Tasks that involve Diagrams
Example prompts
- “/feishu-cli-doc-guide”
Requirements
- Pre-approved tools (allowed-tools): Read
Workflow steps
11 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit e5199b5. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
Read
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Feishu CLI Doc Guide loads about 3k tokens when it runs, and up to ~6.6k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 988 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from LeoYeAI/openclaw-master-skills at commit e5199b5, republished under its MIT licence (© LeoYeAI). 988 words, ~2,959 tokens.
Download SKILL.mdSave it as
.claude/skills/feishu-cli-doc-guide/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- feishu-cli-doc-guide
- description
- 飞书文档创建前的兼容性检查规范。覆盖 Mermaid/PlantUML 语法限制（8 种图表类型的飞书安全写法）、 表格自动拆分规则（9×9 限制）、Callout/公式/图片处理、API 限制与容错机制。 被 feishu-cli-write、feishu-cli-import 等技能引用，在生成将要导入飞书的 Markdown 之前必须参考。 确保内容兼容飞书，避免导入失败。
- allowed-tools
- Read
- user-invocable
- false
飞书文档创建规范指南
1. 概述
本技能是 其他飞书文档技能的参考规范，不可直接调用。整合了以下来源的验证经验：
feishu-cli项目代码实现（converter/、client/board.go、cmd/import_markdown.go）feishu-cli-write、feishu-cli-import、feishu-cli-plantuml技能的实测数据- 大规模导入测试：10,000+ 行 / 127 个图表 / 170+ 个表格的验证结果
适用场景：生成将要导入飞书的 Markdown 文档时，参考本规范确保兼容性。
2. TL;DR 速查清单
生成飞书 Markdown 前，快速过一遍这 10 条核心规则：
| # | 规则 | 严重度 |
|---|---|---|
| 1 | ❌ Mermaid flowchart 标签禁止 {}（会被解析为菱形节点） | 必须遵守 |
| 2 | ❌ Mermaid 禁止 par...and...end（飞书完全不支持） | 必须遵守 |
| 3 | ❌ Mermaid 节点标签换行禁止 \n（会原样显示），用 <br/> | 必须遵守 |
| 4 | ⚠️ Mermaid sequenceDiagram：participant ≤ 8，alt 嵌套 ≤ 1 层 | 强烈建议 |
| 5 | ✅ 方括号标签含冒号时加双引号：["类型: string"] | 必须遵守 |
| 6 | ❌ PlantUML 禁止行首缩进、skinparam、可见性标记（+ - # ~） | 必须遵守 |
| 7 | ⚠️ 表格超过 9 行或 9 列会自动拆分，无需手动处理 | 了解即可 |
| 8 | ✅ Callout 仅 6 种：NOTE / WARNING / TIP / CAUTION / IMPORTANT / SUCCESS | 必须遵守 |
| 9 | ⚠️ 块级公式 $$...$$ 会降级为行内 Equation（API 限制） | 了解即可 |
| 10 | ✅ 图片默认自动上传，失败时降级为占位块 | 了解即可 |
3. Mermaid 飞书语法规范
这是最重要的章节。Mermaid 图表导入飞书有严格的语法限制，不遵守会导致渲染失败。
支持的 8 种图表类型
| 类型 | 声明 | 飞书 diagram_type | 说明 |
|---|---|---|---|
| 流程图 | flowchart TD / flowchart LR | 6 (flowchart) | 支持 subgraph |
| 时序图 | sequenceDiagram | 2 (sequence) | 复杂度限制最严格 |
| 类图 | classDiagram | 4 (class) | |
| 状态图 | stateDiagram-v2 | 7 (state) | 必须用 v2 |
| ER 图 | erDiagram | 5 (er) | |
| 甘特图 | gantt | 0 (auto) | |
| 饼图 | pie | 0 (auto) | |
| 思维导图 | mindmap | 1 (mindmap) |
7 条强制性规则
规则 1：❌ 禁止在标签中使用花括号 {}
花括号会被 Mermaid 解析器识别为菱形（decision）节点，导致语法错误。此规则针对 flowchart 节点标签，erDiagram/classDiagram 语法结构中的 {} 不受此限制。
❌ 错误
flowchart TD
A["{name: value}"]
✅ 正确
flowchart TD
A["name: value"]替代方案：移除花括号，或用圆括号/方括号替代。
规则 2：❌ 禁止使用 par...and...end 并行语法
飞书画板完全不支持 par 语法（错误码 2891001）。
❌ 错误
sequenceDiagram
par
A->>B: 请求1
and
A->>C: 请求2
end
✅ 正确：用 Note 替代
sequenceDiagram
Note over A,C: 并行处理
A->>B: 请求1
A->>C: 请求2规则 3：⚠️ 方括号中避免冒号
方括号 [text:xxx] 中的冒号可能导致解析歧义。
❌ 可能出错
flowchart TD
A[类型:string]
✅ 正确
flowchart TD
A["类型: string"]修复方法：给含冒号的标签加双引号。
规则 4：⚠️ Note 作用域限制
Note over 最多跨 2 个相邻 participant。
❌ 错误：跨太多参与者
sequenceDiagram
Note over A,D: 说明
✅ 正确
sequenceDiagram
Note over A,B: 说明规则 5：⚠️ sequenceDiagram 复杂度阈值
| 维度 | 安全阈值 | 超限风险 |
|---|---|---|
| participant 数量 | ≤ 8 | 超过 10 + 其他因素 → 失败 |
| alt/opt 嵌套 | ≤ 1 层 | 超过 2 层 → 失败风险增大 |
| 消息标签长度 | 简短（≤ 30 字符） | 长标签 + 多参与者 → 失败 |
| 总消息数 | ≤ 30 | 需结合其他因素评估 |
超限组合（实测必定失败）：10+ participant + 2+ alt + 30+ 长消息标签
建议：超过安全阈值时，拆分为多个小图。
规则 6：❌ 节点标签换行禁止 \n，必须用 <br> 或 <br/>
飞书画板不支持 Mermaid 节点标签中的 \n 转义符，会原样显示为 \n 文本。需要使用 <br> 或 <br/> 实现换行，也可以在源码中写真实换行（需用双引号包裹标签）。
❌ 错误：\n 会原样显示为文本
flowchart TD
A["normalizePort\n(detect-port)"]
✅ 正确：使用 <br>
flowchart TD
A["normalizePort<br>(detect-port)"]
✅ 正确：使用 <br/>
flowchart TD
A["normalizePort<br/>(detect-port)"]
✅ 正确：源码中直接换行（标签必须用双引号）
flowchart TD
A["normalizePort
(detect-port)"]规则 7：⚠️ 避免过于复杂的嵌套结构
多层 subgraph 嵌套、大量条件分支等复杂结构会增加渲染失败概率。保持图表简洁。
生成前检查清单
在生成 Mermaid 代码块前，逐项检查：
- 图表类型是否在支持的 8 种之内？
- 标签中是否存在花括号
{}？→ 移除或替换 - 是否使用了
par...and...end？→ 改用Note over - 方括号标签中是否有冒号？→ 加双引号
- sequenceDiagram 参与者是否 ≤ 8？
- sequenceDiagram alt 嵌套是否 ≤ 1 层？
- 节点标签换行是否使用了
\n？→ 改用<br>或<br/> - 整体复杂度是否可控？→ 考虑拆分
详细的 8 种图表模板和更多正反示例见
references/mermaid-spec.md。
4. PlantUML 安全子集
全局规则
- ✅ 使用
@startuml/@enduml包裹（思维导图用@startmindmap/@endmindmap） - ❌ 不要使用行首缩进（飞书画板将缩进行视为独立行）
- ❌ 避免
skinparam、!define、颜色、字体、对齐控制等样式指令 - ⚠️ 避免方向控制指令（
left to right direction等在部分场景不可靠）
各图类型注意事项
| 图类型 | 安全语法 | 禁忌 |
|---|---|---|
| 活动图 | start/stop、:动作;、if/then/else/endif、repeat、fork | ❌ 避免过深嵌套 |
| 时序图 | participant、->/-->、activate/deactivate、note、alt/opt/loop | ❌ 避免样式指令 |
| 类图 | class、interface、package、关系箭头 | ❌ 避免可见性标记（+ - # ~） |
| 用例图 | actor、(用例)、<<include>>/<<extend>> | ❌ 避免复杂布局 |
| 组件图 | [Component]、package/node/cloud/database | ❌ 避免 ArchiMate sprite |
| ER 图 | entity、关系箭头 | ⚠️ 与 Mermaid ER 语法不同 |
| 思维导图 | @startmindmap、* / + 层级标记 | ✅ 必须用专用包裹标记 |
Mermaid vs PlantUML 选择策略
| 场景 | 推荐 | 原因 |
|---|---|---|
| 流程图 | Mermaid | 飞书原生支持更好，成功率高 |
| 时序图（简单） | Mermaid | 语法简洁 |
| 时序图（复杂） | PlantUML | Mermaid 复杂度限制严格 |
| 类图 | Mermaid | 两者都可，Mermaid 更简洁 |
| ER 图 | Mermaid | 语法更直观 |
| 状态图 | Mermaid | stateDiagram-v2 支持好 |
| 甘特图 | Mermaid | PlantUML 甘特图飞书支持差 |
| 饼图 | Mermaid | 简洁 |
| 思维导图 | 两者均可 | PlantUML 层级标记更灵活 |
| 用例图 | PlantUML | Mermaid 不支持 |
| 组件图 | PlantUML | Mermaid 不支持 |
| 活动图（复杂分支） | PlantUML | 支持更丰富的分支语法 |
默认推荐 Mermaid，仅在 Mermaid 不支持的图类型或复杂场景下使用 PlantUML。
5. Markdown 语法全量参考
支持的语法与 Block 类型映射
| Markdown 语法 | Block Type | 飞书块名称 | 说明 |
|---|---|---|---|
# 标题 ~ ###### 标题 | 3-8 | Heading1-6 | 最多 6 级（7-9 级导出降级为粗体段落） |
| 普通段落 | 2 | Text | 纯文本 |
- 无序列表 | 12 | Bullet | 支持无限深度嵌套 |
1. 有序列表 | 13 | Ordered | 支持无限深度嵌套 |
- [x] / - [ ] | 17 | Todo | 任务列表 |
```lang | 14 | Code | 代码块（支持语言标识） |
> 引用 | 34 | QuoteContainer | 引用容器（导入使用 QuoteContainer） |
> [!NOTE] | 19 | Callout | 高亮块（6 种类型，见第 6 节） |
--- | 22 | Divider | 分割线 |
| Markdown 表格 | 31 | Table | 超过 9 行或 9 列自动拆分（见第 7 节） |
 | 27 | Image | 默认自动上传（见第 8 节） |
```mermaid | 21→43 | Diagram→Board | 自动转飞书画板（见第 3 节） |
```plantuml / ```puml | 21→43 | Diagram→Board | 自动转飞书画板（见第 4 节） |
$$公式$$ | 16 | Equation | 块级公式（降级为行内 Equation） |
$公式$ | — | InlineEquation | 行内公式 |
新增块类型（导出支持）
以下块类型在导出时有对应的处理：
| Block Type | 名称 | 导出结果 | 说明 |
|---|---|---|---|
| 44 | Agenda | 展开子块 | 议程块 |
| 45 | AgendaItem | 展开子块 | 议程条目 |
| 46 | AgendaItemTitle | 粗体文本 | 议程标题 |
| 47 | AgendaItemContent | 展开子块 | 议程内容 |
| 48 | LinkPreview | 链接 | 链接预览块 |
| 49 | SyncSource | 展开子块 | 同步源块 |
| 50 | SyncReference | 展开子块 | 同步引用块 |
| 51 | WikiCatalogV2 | [知识库目录 V2] | 知识库目录 V2 |
| 52 | AITemplate | HTML 注释 | AI 模板块 |
行内样式
| Markdown | 效果 | 说明 |
|---|---|---|
**粗体** | 粗体 | Bold TextStyle |
*斜体* | 斜体 | Italic TextStyle |
`行内代码` | 代码 | InlineCode TextStyle |
~~删除线~~ | Strikethrough TextStyle | |
<u>下划线</u> | 下划线 | Underline TextStyle |
[文字](url) | 链接 | Link TextElement |
==高亮== | 高亮 | Highlight（需启用选项） |
嵌套列表示例
- 一级无序
- 二级无序
- 三级无序
1. 四级有序
2. 四级有序
- 三级无序
- 二级无序无序/有序列表支持 无限深度嵌套 和 混合嵌套，导入时自动保留缩进层级。
6. Callout 高亮块
6 种类型与背景色映射
| 类型 | bgColor | 颜色 | Markdown 语法 | 适用场景 |
|---|---|---|---|---|
| NOTE | 6 | 蓝色 | > [!NOTE] | 补充说明、提示信息 |
| WARNING | 2 | 红色 | > [!WARNING] | 警告、危险提醒 |
| TIP | 4 | 黄色 | > [!TIP] | 技巧、建议 |
| CAUTION | 3 | 橙色 | > [!CAUTION] | 注意事项 |
| IMPORTANT | 7 | 紫色 | > [!IMPORTANT] | 重要信息 |
| SUCCESS | 5 | 绿色 | > [!SUCCESS] | 成功、通过 |
⚠️
INFO与NOTE等效（都映射为 bgColor=6 蓝色），统一使用NOTE。
Show full SKILL.md (373 more words)Show less
使用示例
> [!NOTE]
> 这是一条补充说明信息。
> [!WARNING]
> 此操作不可逆，请谨慎执行。
> [!TIP]
> 使用 `--verbose` 参数可以查看详细进度。
> [!CAUTION]
> 注意：API 有频率限制。
> [!IMPORTANT]
> 必须在执行前配置环境变量。
> [!SUCCESS]
> 所有测试用例已通过。注意事项
- ❌ Callout 块不能同时设置
EmojiId，仅通过BackgroundColor区分类型 - ✅ 支持 Callout 内包含子块（段落、列表等）
- ✅ 统一使用
NOTE而非INFO（两者等效，NOTE是 Markdown 标准写法）
7. 表格规范
9 行 × 9 列限制与自动拆分
飞书 API 限制单个表格最多 9 行（包括表头）× 9 列。超出时 feishu-cli 自动拆分为多个表格。
拆分逻辑（converter/markdown_to_block.go）：
| 维度 | 处理方式 |
|---|---|
| ≤ 9 行 且 ≤ 9 列 | ✅ 直接创建单个表格 |
| > 9 行 | 按行拆分为多个表格，每个最多 8 行数据 + 1 行表头 |
| > 9 列 | 按列拆分为多个表格，保留首列作为标识列 |
| > 9 行 且 > 9 列 | 先列拆分，再行拆分（复合拆分） |
列拆分策略：首列通常是标识/名称列，在所有列组中保留，避免拆分后数据行无法识别。每个列组最多 9 列（1 列标识 + 8 列数据）。
列宽自动计算
列宽根据单元格内容自动计算（converter/markdown_to_block.go:25-103）：
| 参数 | 值 | 说明 |
|---|---|---|
| 中文字符宽度 | 14px | 非 ASCII 字符 |
| 英文字符宽度 | 8px | ASCII 字符 |
| 列内边距 | 16px | 每列额外边距 |
| 最小列宽 | 80px | 不能更窄 |
| 最大列宽 | 400px | 不能更宽 |
| 文档默认宽度 | 700px | 总宽度不足时按比例扩展 |
单元格多块支持
表格单元格内可以包含多种块类型：
- Text（普通文本）
- Bullet（无序列表）
- Heading（标题）
⚠️ 注意：飞书 API 创建表格时会自动在每个单元格内创建空的 Text 块。填充内容时应 更新现有块 而非创建新块。
表格编写建议
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| 数据 | 数据 | 数据 |- ✅ 确保每行列数一致
- ✅ 大表格（超过 8 行数据或超过 9 列）会自动拆分，无需手动处理
- ✅ 列宽由内容自动决定，无需手动控制
8. 图片处理
图片上传（v1.8.0+）
feishu-cli 默认通过 --upload-images 自动上传图片：
- 遇到
时，自动下载网络图片或读取本地图片 - 通过素材上传 API 上传到飞书，获取 file_token
- 创建 Image 块并引用 file_token，实现图片插入
- 上传失败时降级为占位块，导入报告显示失败数量
注意事项
- ✅ 默认开启图片上传，使用
--no-upload-images可关闭（创建占位块） - ⚠️ 图片并发上传数通过
--image-workers控制（默认 2，API 限制 5 QPS） - ✅ 支持本地图片路径和网络 URL（HTTP/HTTPS）
- ✅ 图片相关的 alt 文字会作为占位信息保留
9. 公式支持
行内公式
使用单美元符号包裹：$E = mc^2$
支持一个段落内包含多个行内公式：
已知 $a^2 + b^2 = c^2$，当 $a = 3, b = 4$ 时，$c = 5$。块级公式
使用双美元符号包裹：
$$
\int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
$$注意事项
- ⚠️ 飞书 API 不支持直接创建块级 Equation（BlockType=16），实际导入时 降级为行内 Equation
- ✅ LaTeX 语法兼容飞书 KaTeX 渲染器
- ✅ 公式中的特殊字符无需额外转义
10. API 限制与容错
三阶段并发管道
feishu-cli doc import 采用三阶段管道架构（cmd/import_markdown.go）：
| 阶段 | 方式 | 处理内容 |
|---|---|---|
| 阶段一 | 顺序 | 按文档顺序创建所有块，为图表创建空画板占位块，收集表格任务 |
| 阶段二 | 并发 | 图表 worker 池（默认 5 并发）+ 表格 worker 池（默认 3 并发）同时处理 |
| 阶段三 | 逆序 | 处理失败的图表：删除空画板块，在原位置插入代码块（逆序避免索引偏移） |
批量操作限制
| 限制 | 值 | 处理方式 |
|---|---|---|
| 单次创建块数 | 最多 50 个 | 自动分批（batchSize = 50） |
| 单个表格行数 | 最多 9 行 | 自动拆分并复制表头 |
| 单个表格列数 | 最多 9 列 | 自动拆分并保留首列 |
| 文件夹子节点 | 不超过 1500 | 超出报错 1062507 |
| 文档块总数 | 有上限 | 超出报错 1770004 |
| 文件大小 | 最大 100MB | 超出直接报错 |
| API 频率 | 429 Too Many Requests | 自动重试 + 线性退避 |
图表重试与降级策略
| 错误类型 | 判断条件 | 处理方式 |
|---|---|---|
| 语法错误 | Parse error、Invalid request parameter | ❌ 不重试，直接降级为代码块 |
| 服务端错误 | 500/502/503、internal error | ✅ 重试（最多 10 次，1s 间隔） |
| 频率限制 | 429、rate limit、frequency limit | ✅ 重试（归为可重试错误） |
| 重试耗尽 | 超过最大重试次数 | ⚠️ 降级为代码块 |
降级处理流程：
- 获取文档所有顶层子块
- 按索引 逆序 处理失败图表（避免删除导致索引偏移）
- 删除空画板块
- 在原位置插入代码块（保留原始图表代码）
CLI 并发控制参数
| 参数 | 默认值 | 说明 |
|---|---|---|
--diagram-workers | 5 | 图表（Mermaid/PlantUML）并发导入数 |
--table-workers | 3 | 表格并发填充数 |
--diagram-retries | 10 | 图表最大重试次数 |
--verbose | false | 显示详细进度 |
画板 API 技术细节
- API 端点：
/open-apis/board/v1/whiteboards/{id}/nodes/plantuml syntax_type：1 = PlantUML，2 = Mermaiddiagram_type映射：0=auto, 1=mindmap, 2=sequence, 3=activity, 4=class, 5=er, 6=flowchart, 7=state, 8=component
11. 完整预创建检查清单
创建将导入飞书的 Markdown 文档前，完成以下检查：
文档结构
- 标题层级不超过 6 级（H7-H9 会降级为粗体段落）
- 嵌套列表使用 2 或 4 空格缩进
- 表格数据行控制在 8 行以内（避免不必要拆分）
- 文件总大小不超过 100MB
Mermaid 图表
- 图表类型在支持的 8 种之内
- ❌ 标签无花括号
{} - ❌ 未使用
par...and...end - ✅ 方括号标签内含冒号时已加双引号
- ⚠️ sequenceDiagram：participant ≤ 8，alt ≤ 1 层
- ❌ 节点标签换行未使用
\n，已改用<br>或<br/> - 复杂图表已拆分为多个小图
PlantUML 图表
- ✅ 使用正确的包裹标记（
@startuml/@enduml） - ❌ 无行首缩进
- ❌ 无
skinparam等样式指令 - ❌ 类图未使用可见性标记（
+ - # ~）
特殊内容
- ✅ 图片路径正确（默认自动上传，失败降级为占位块）
- ✅ 公式语法正确（
$...$行内 /$$...$$块级） - ✅ Callout 类型在 6 种之内（NOTE/WARNING/TIP/CAUTION/IMPORTANT/SUCCESS）
性能考虑
- 大量图表时考虑增加
--diagram-workers - 大量表格时考虑增加
--table-workers - 首次导入建议加
--verbose观察进度
© LeoYeAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 2 other files (references) in skills/feishu-cli-doc-guide of LeoYeAI/openclaw-master-skills.
- SKILL.md
- _meta.json
- references/mermaid-spec.md
Open the folder on GitHubat commit e5199b5
Compare with similar skills
Feishu CLI Doc Guide next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Feishu CLI Doc Guide this skillLeoYeAI/openclaw-master-skills | 2.2k | — | ~3k | Automated safety check: Pass | MIT | |
| Lark Whiteboardappleweiping/WEIPING_WIKI | 119 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Relay Stack Playbookkxn/codex-remote-feishu | 328 | — | ~1.3k | Automated safety check: Pass | None | |
| A Stock Predictiondigoal/blog | 8.6k | — | ~2.2k | Automated safety check: Pass | GPL-2.0 | |
| Us Stock Predictiondigoal/blog | 8.6k | — | ~1.9k | Automated safety check: Warn | GPL-2.0 | |
| Feishu Docopenclaw/openclaw | 392k | — | ~516 | Automated safety check: Pass | MIT |
Similar skills
Relay Stack Playbook
kxn/codex-remote-feishu
A skill your agent uses when working on this repository's relay stack: Codex app-server protocol translation, relayd, relay-wrapper, Feishu bot integration, VS Code remote integration, or real-stack…
A Stock Prediction
digoal/blog
A股个股次日(T+1)走势预测 skill。当用户输入A股股票代码(如 600519、000858、300750、688981、430090)或公司名称(如"贵州茅台"、"宁德时代"、"比亚迪"),并要求预测次日走势、给出交易计划、评估盈亏概率时,触发本 skill。skill 会用 mcpMiniMaxwebsearch…
Us Stock Prediction
digoal/blog
美股个股次日走势预测 skill。当用户输入美股股票代码(如 AAPL、TSLA)或公司名称(如 "苹果"、"特斯拉"),并要求预测次日(T+1)走势、给出交易计划、评估盈亏概率时,触发本 skill。skill 会用 mcpMiniMaxwebsearch 搜证盘前 90…
Feishu Doc
openclaw/openclaw
Feishu document read/write workflows. An agent skill from openclaw/openclaw.
Claude To Im
op7418/Claude-to-IM-skill
Bridge THIS Claude Code or Codex session to Telegram, Discord, Feishu/Lark, QQ, or WeChat so the user can chat with Claude from their phone.
More from LeoYeAI/openclaw-master-skills
All 972 skills in this repoDevOps Pipeline Management
LeoYeAI/openclaw-master-skills
Manages pipelines on a DevOps quality and efficiency platform through its OpenAPI: list workspaces and templates, create, update, run and cancel pipelines, and read run records.
Feishu Document Collaboration
LeoYeAI/openclaw-master-skills
Patches OpenClaw's Feishu extension so an edited document triggers an isolated agent session that reads the doc and replies inline, turning it into a live chat space.
Files Memory System
LeoYeAI/openclaw-master-skills
Multi-context memory management system for OpenClaw agents with group-isolated storage, global shared memory, workspace organization, and group-specific skills isolation.
GEO-Claw AI Visibility Agent
LeoYeAI/openclaw-master-skills
Runs a brand's AI-search visibility work end to end: diagnosing how AI platforms represent it, repositioning it, producing AI-optimized content and monitoring ongoing mentions.
Google Workspace CLI
LeoYeAI/openclaw-master-skills
Installs and authenticates the gws CLI, then automates Gmail, Drive, Sheets, Calendar, Docs, Chat and Tasks with ready-made recipes, persona bundles and security audits.
HealthFit Health Advisors
LeoYeAI/openclaw-master-skills
Runs four advisor roles, a fitness coach, nutritionist, data analyst and TCM practitioner, to build a health profile and track workouts, diet and wellness over time.
Related
Works with
Categories
Questions about Feishu CLI Doc Guide
What does Feishu CLI Doc Guide do?
飞书文档创建前的兼容性检查规范。覆盖 Mermaid/PlantUML 语法限制（8 种图表类型的飞书安全写法）、 表格自动拆分规则（9×9 限制）、Callout/公式/图片处理、API 限制与容错机制。. Feishu CLI Doc Guide is an agent skill from LeoYeAI/openclaw-master-skills.
When should I use Feishu CLI Doc Guide?
Feishu CLI Doc Guide fits situations like: tasks that involve Messaging and chat bots; tasks that involve Diagrams.
How do I install Feishu CLI Doc Guide in Claude Code?
Run `npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a claude-code`. Or copy the skill folder (skills/feishu-cli-doc-guide in LeoYeAI/openclaw-master-skills) into .claude/skills/feishu-cli-doc-guide in your project. Claude Code loads it when a task matches its description.
How do I install Feishu CLI Doc Guide in Codex?
Run `npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a codex`. Or copy the skill folder (skills/feishu-cli-doc-guide in LeoYeAI/openclaw-master-skills) into .agents/skills/feishu-cli-doc-guide in your project. Codex loads it when a task matches its description.
Can I use Feishu CLI Doc Guide in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add LeoYeAI/openclaw-master-skills --skill feishu-cli-doc-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/feishu-cli-doc-guide, .gemini/skills/feishu-cli-doc-guide, .github/skills/feishu-cli-doc-guide and .opencode/skills/feishu-cli-doc-guide in your project.
What does Feishu CLI Doc Guide need to run?
SKILL.md names no scripts, command-line tools or credentials: Feishu CLI Doc Guide is instructions for the agent only. Its frontmatter pre-approves these tools: Read.
Does Feishu CLI Doc Guide access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Feishu CLI Doc Guide safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Feishu CLI Doc Guide use?
Feishu CLI Doc Guide is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Feishu CLI Doc Guide use?
About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.7k tokens, read only when the agent opens those files.
What are the alternatives to Feishu CLI Doc Guide?
Skills that share tags, products or a category with Feishu CLI Doc Guide: Lark Whiteboard (appleweiping/WEIPING_WIKI, 119 stars), Relay Stack Playbook (kxn/codex-remote-feishu, 328 stars), A Stock Prediction (digoal/blog, 8.6k stars) and Us Stock Prediction (digoal/blog, 8.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Feishu CLI Doc Guide?
LeoYeAI (a GitHub user) maintains it in LeoYeAI/openclaw-master-skills, which has 2,159 GitHub stars. The repository holds 972 skills in this directory. The repository was last updated on July 20, 2026.
Source: LeoYeAI/openclaw-master-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.