$npx -y skills add op7418/CodePilot --skill feishu-create-doc创建飞书云文档。从 Lark-flavored Markdown 内容创建新的飞书云文档,支持指定创建位置(文件夹/知识库/知识空间)。
| 1 | # feishu_mcp_create_doc |
| 2 | |
| 3 | 通过 MCP 调用 `create-doc`,从 Lark-flavored Markdown 内容创建一个新的飞书云文档。 |
| 4 | |
| 5 | # 返回值 |
| 6 | |
| 7 | 工具成功执行后,返回一个 JSON 对象,包含以下字段: |
| 8 | |
| 9 | - **`doc_id`**(string):文档的唯一标识符(token),格式如 `doxcnXXXXXXXXXXXXXXXXXXX` |
| 10 | - **`doc_url`**(string):文档的访问链接,可直接在浏览器中打开,格式如 `https://bytedance.feishu.cn/docx/doxcnXXXXXXXXXXXXXXXXXXX` |
| 11 | - **`message`**(string):操作结果消息,如"文档创建成功" |
| 12 | |
| 13 | |
| 14 | # 参数 |
| 15 | |
| 16 | ## markdown(必填) |
| 17 | 文档的 Markdown 内容,使用 Lark-flavored Markdown 格式。 |
| 18 | |
| 19 | 调用本工具的markdown内容应当尽量结构清晰,样式丰富, 有很高的可读性. 合理的使用callout高亮块, 分栏,表格等能力,并合理的运用插入图片与mermaid的能力,做到图文并茂.. |
| 20 | 你需要遵循以下原则: |
| 21 | |
| 22 | - **结构清晰**:标题层级 ≤ 4 层,用 Callout 突出关键信息 |
| 23 | - **视觉节奏**:用分割线、分栏、表格打破大段纯文字 |
| 24 | - **图文交融**:流程和架构优先用 Mermaid/PlantUML 可视化 |
| 25 | - **克制留白**:Callout 不过度、加粗只强调核心词 |
| 26 | |
| 27 | 当用户有明确的样式,风格需求时,应当以用户的需求为准!! |
| 28 | |
| 29 | **重要提示**: |
| 30 | - **禁止重复标题**:markdown 内容开头不要写与 title 相同的一级标题!title 参数已经是文档标题,markdown 应直接从正文内容开始 |
| 31 | - **目录**:飞书自动生成,无需手动添加 |
| 32 | - Markdown 语法必须符合 Lark-flavored Markdown 规范,详见下方"内容格式"章节 |
| 33 | - 创建较长的文档时,强烈建议配合update-doc中的append mode, 进行分段的创建,提高成功率. |
| 34 | |
| 35 | ## title(可选) |
| 36 | 文档标题。 |
| 37 | |
| 38 | ## folder_token(可选) |
| 39 | 父文件夹的 token。如果不提供,文档将创建在用户的个人空间根目录。 |
| 40 | |
| 41 | folder_token 可以从飞书文件夹 URL 中获取,格式如:`https://xxx.feishu.cn/drive/folder/fldcnXXXX`,其中 `fldcnXXXX` 即为 folder_token。 |
| 42 | |
| 43 | ## wiki_node(可选) |
| 44 | 知识库节点 token 或 URL(可选,传入则在该节点下创建文档,与 folder_token 和 wiki_space 互斥) |
| 45 | |
| 46 | wiki_node 可以从飞书知识库页面 URL 中获取,格式如:`https://xxx.feishu.cn/wiki/wikcnXXXX`,其中 `wikcnXXXX` 即为 wiki_node token。 |
| 47 | |
| 48 | ## wiki_space(可选) |
| 49 | 知识空间 ID(可选,传入则在该空间根目录下创建文档。特殊值 `my_library` 表示用户的个人知识库。与 wiki_node 和 folder_token 互斥) |
| 50 | |
| 51 | wiki_space 可以从知识空间设置页面 URL 中获取,格式如:`https://xxx.feishu.cn/wiki/settings/7448880953499959300`,其中 `7448880953499959300` 即为 wiki_space ID。 |
| 52 | |
| 53 | **参数优先级**:wiki_node > wiki_space > folder_token |
| 54 | |
| 55 | # 示例 |
| 56 | |
| 57 | ## 示例 1:创建简单文档 |
| 58 | |
| 59 | ```json |
| 60 | { |
| 61 | "title": "项目计划", |
| 62 | "markdown": "# 项目概述\n\n这是一个新项目。\n\n## 目标\n\n- 目标 1\n- 目标 2" |
| 63 | } |
| 64 | ``` |
| 65 | |
| 66 | ## 示例 2:创建到指定文件夹 |
| 67 | |
| 68 | ```json |
| 69 | { |
| 70 | "title": "会议纪要", |
| 71 | "folder_token": "fldcnXXXXXXXXXXXXXXXXXXXXXX", |
| 72 | "markdown": "# 周会 2025-01-15\n\n## 讨论议题\n\n1. 项目进度\n2. 下周计划" |
| 73 | } |
| 74 | ``` |
| 75 | |
| 76 | ## 示例 3:使用飞书扩展语法 |
| 77 | |
| 78 | 使用高亮块、表格等飞书特有功能: |
| 79 | |
| 80 | ```json |
| 81 | { |
| 82 | "title": "产品需求", |
| 83 | "markdown": "<callout emoji=\"💡\" background-color=\"light-blue\">\n重要需求说明\n</callout>\n\n## 功能列表\n\n<lark-table header-row=\"true\">\n| 功能 | 优先级 |\n|------|--------|\n| 登录 | P0 |\n| 导出 | P1 |\n</lark-table>" |
| 84 | } |
| 85 | ``` |
| 86 | |
| 87 | ## 示例 4:创建到知识库节点下 |
| 88 | |
| 89 | ```json |
| 90 | { |
| 91 | "title": "技术文档", |
| 92 | "wiki_node": "wikcnXXXXXXXXXXXXXXXXXXXXXX", |
| 93 | "markdown": "# API 接口说明\n\n这是一个知识库文档。" |
| 94 | } |
| 95 | ``` |
| 96 | |
| 97 | ## 示例 5:创建到知识空间根目录 |
| 98 | |
| 99 | ```json |
| 100 | { |
| 101 | "title": "项目概览", |
| 102 | "wiki_space": "7448880953499959300", |
| 103 | "markdown": "# 项目概览\n\n这是知识空间根目录下的一级文档。" |
| 104 | } |
| 105 | ``` |
| 106 | |
| 107 | ## 示例 6:创建到个人知识库 |
| 108 | |
| 109 | ```json |
| 110 | { |
| 111 | "title": "学习笔记", |
| 112 | "wiki_space": "my_library", |
| 113 | "markdown": "# 学习笔记\n\n这是创建在个人知识库中的文档。" |
| 114 | } |
| 115 | ``` |
| 116 | |
| 117 | # 内容格式 |
| 118 | |
| 119 | 文档内容使用 **Lark-flavored Markdown** 格式,这是标准 Markdown 的扩展版本,支持飞书文档的所有块类型和富文本格式。 |
| 120 | |
| 121 | ## 通用规则 |
| 122 | |
| 123 | - 使用标准 Markdown 语法作为基础 |
| 124 | - 使用自定义 XML 标签实现飞书特有功能(具体标签见各功能章节) |
| 125 | - 需要显示特殊字符时使用反斜杠转义:`* ~ ` $ [ ] < > { } | ^` |
| 126 | |
| 127 | --- |
| 128 | |
| 129 | ## 📝 基础块类型 |
| 130 | |
| 131 | ### 文本(段落) |
| 132 | |
| 133 | ```markdown |
| 134 | 普通文本段落 |
| 135 | |
| 136 | 段落中的**粗体文字** |
| 137 | |
| 138 | 多个段落之间用空行分隔。 |
| 139 | |
| 140 | 居中文本 {align="center"} |
| 141 | 右对齐文本 {align="right"} |
| 142 | ``` |
| 143 | |
| 144 | **段落对齐**:支持 `{align="left|center|right"}` 语法。可与颜色组合:`{color="blue" align="center"}` |
| 145 | |
| 146 | ### 标题 |
| 147 | |
| 148 | 飞书支持 9 级标题。H1-H6 使用标准 Markdown 语法,H7-H9 使用 HTML 标签: |
| 149 | |
| 150 | ```markdown |
| 151 | # 一级标题 |
| 152 | ## 二级标题 |
| 153 | ### 三级标题 |
| 154 | #### 四级标题 |
| 155 | ##### 五级标题 |
| 156 | ###### 六级标题 |
| 157 | <h7>七级标题</h7> |
| 158 | <h8>八级标题</h8> |
| 159 | <h9>九级标题</h9> |
| 160 | |
| 161 | # 带颜色的标题 {color="blue"} |
| 162 | ## 红色标题 {color="red"} |
| 163 | # 居中标题 {align="center"} |
| 164 | ## 蓝色居中标题 {color="blue" align="center"} |
| 165 | ``` |
| 166 | |
| 167 | **标题属性**:支持 `{color="颜色名"}` 和 `{align="left|center|right"}` 语法,可组合使用。颜色值:red, orange, yellow, green, blue, purple, gray。请谨慎使用该能力. |
| 168 | |
| 169 | ### 列表 |
| 170 | 有序列表,无序列表嵌套使用tab或者 2 空格缩进 |
| 171 | ```markdown |
| 172 | - 无序项1( |
| 173 | - 无序项1.a |
| 174 | - 无序项1.b |
| 175 | |
| 176 | 1. 有序项1 |
| 177 | 2. 有序项2 |
| 178 | |
| 179 | - [ ] 待办 |
| 180 | - [x] 已完成 |
| 181 | ``` |
| 182 | |
| 183 | ### 引用块 |
| 184 | |
| 185 | ```markdown |
| 186 | > 这是一段引用 |
| 187 | > 可以跨多行 |
| 188 | |
| 189 | > 引用中支持**加粗**和*斜体*等格式 |
| 190 | ``` |
| 191 | |
| 192 | ### 代码块 |
| 193 | |
| 194 | **⚠️** 只支持围栏代码块(` ``` `),不支持缩进代码块。 |
| 195 | |
| 196 | ````markdown |
| 197 | ```python |
| 198 | print("Hello") |
| 199 | ``` |
| 200 | ```` |
| 201 | |
| 202 | 支持语言:python, javascript, go, java, sql, json, yaml, shell 等。 |
| 203 | |
| 204 | ### 分割线 |
| 205 | |
| 206 | ```markdown |
| 207 | --- |
| 208 | ``` |
| 209 | |
| 210 | --- |
| 211 | |
| 212 | ## 🎨 富文本格式 |
| 213 | |
| 214 | ### 文本样式 |
| 215 | |
| 216 | `**粗体**` `*斜体*` `~~删除线~~` `` `行内代码` `` `<u>下划线</u>` |
| 217 | |
| 218 | ### 文字颜色 |
| 219 | |
| 220 | `<text color="red">红色</text>` `<text background-color="yellow">黄色背景</text>` |
| 221 | |
| 222 | 支持: red, orange, yellow, green, blue, purple, gray |
| 223 | |
| 224 | ### 链接 |
| 225 | |
| 226 | `[链接文字](https://example.com)` (不支持锚点链接) |
| 227 | |
| 228 | ### 行内公式(LaTeX) |
| 229 | |
| 230 | `$E = mc^2$`(`$`前后需空格)或 `<equation>E = mc^2</equation>`(无限制,推荐) |
| 231 | |
| 232 | --- |
| 233 | |
| 234 | ## 🚀 高级块类型 |
| 235 | |
| 236 | ### 高亮块(Callout) |
| 237 | |
| 238 | ```html |
| 239 | <callout emoji="✅" background-color="light-green" border-color="green"> |
| 240 | 支持**格式化**的内容,可包含多个块 |
| 241 | </callout> |
| 242 | ``` |
| 243 | |
| 244 | **属性**: emoji (使用emoji 字符如 ✅ ⚠️ 💡), background-color, border-color, text-color |
| 245 | |
| 246 | **背景色**: light-red/red, light-blue/blue, light-green/green, light-yellow/yellow, light-orange/orange, light-purple/purple, pale-gray/light-gray/dark-gray |
| 247 | |
| 248 | **常用**: 💡light-blue(提示) ⚠️light-yellow(警告) ❌light-red(危险) ✅light-green(成功) |
| 249 | |
| 250 | **限制**: callout子块仅支持文本、标题、列表、待办、引用。不支持代码块、表格、图片。 |
| 251 | |
| 252 | ### 分栏(Grid) |
| 253 | |
| 254 | 适合对比、并列展示场景。支持 2-5 列: |
| 255 | #### 两栏(等宽) |
| 256 | |
| 257 | ```html |
| 258 | <grid cols="2"> |
| 259 | <column> |
| 260 | |
| 261 | 左栏内容 |
| 262 | |
| 263 | </column> |
| 264 | <column> |
| 265 | |
| 266 | 右栏内容 |
| 267 | |
| 268 | </column> |
| 269 | </grid> |
| 270 | ``` |
| 271 | #### 三栏自定义宽度 |
| 272 | ```html |
| 273 | <grid cols="3"> |
| 274 | <column width="20">左栏(20%)</column> |
| 275 | <column width="60">中栏(60%)</colu |