{"skill":{"slug":"feishu-doc-linxiaoman","displayName":"飞书文档操作-林小满","summary":"在飞书中创建、读取、追加、更新和删除文档内容，支持Markdown格式编辑与文档块管理。","description":"# Feishu Doc 技能\n\n## 概述\n\n飞书文档操作技能，用于在飞书中创建、读取、追加和更新文档。\n\n## 工具\n\n使用 `feishu_doc` 工具，参数：\n- `action`: 操作类型\n- `doc_token`: 文档 token（从飞书文档 URL 中提取，如 `/docx/XXX` 中的 XXX）\n- `content`: 文档内容（markdown 格式）\n- `title`: 文档标题（仅 create 时使用）\n- `folder_token`: 文件夹 token（可选）\n\n## 操作类型\n\n| action | 说明 | 必需参数 |\n|--------|------|----------|\n| create | 创建新空白文档 | title |\n| read | 读取文档内容 | doc_token |\n| append | 向文档追加内容 | doc_token, content |\n| write | 覆盖写入整个文档 | doc_token, content |\n| list_blocks | 列出文档所有块 | doc_token |\n| get_block | 获取单个块 | doc_token, block_id |\n| update_block | 更新单个块 | doc_token, block_id, content |\n| delete_block | 删除单个块 | doc_token, block_id |\n\n## 创建文档的正确方式\n\n### 坑：create + content 可能不生效\n\n直接用 `create` action 并传入大量 content 可能导致文档创建成功但内容为空：\n\n```json\n{\n  \"action\": \"create\",\n  \"title\": \"文档标题\",\n  \"content\": \"大量内容...\"\n}\n```\n\n### 正确做法：先 create 空文档，再 append\n\n1. 先用 `create` 创建空白文档（只传 title）\n2. 再用 `append` 逐次追加内容\n\n```json\n// 步骤1：创建空白文档\n{\n  \"action\": \"create\",\n  \"title\": \"文档标题\"\n}\n\n// 返回 doc_token，如 \"HYhbdqE2Goy9NLxle9XcomtPnVc\"\n\n// 步骤2：追加内容\n{\n  \"action\": \"append\",\n  \"doc_token\": \"HYhbdqE2Goy9NLxle9XcomtPnVc\",\n  \"content\": \"# 标题\\n\\n内容...\"\n}\n```\n\n## 文档 URL 解析\n\n飞书文档 URL 格式：\n- `https://feishu.cn/docx/{token}`\n- `https://feishu.cn/wiki/{token}`\n\n从 URL 中提取 token：\n- `/docx/` 后面的部分就是 token\n- `/wiki/` 后面的部分也是 token\n\n## 使用示例\n\n### 创建技术文档\n\n```json\n{\n  \"action\": \"create\",\n  \"title\": \"OpenClaw 使用指南\"\n}\n```\n\n返回：\n```json\n{\n  \"document_id\": \"JZyJdrVVTok9mfxVHqJc91Dhn3g\",\n  \"title\": \"OpenClaw 使用指南\",\n  \"url\": \"https://feishu.cn/docx/JZyJdrVVTok9mfxVHqJc91Dhn3g\"\n}\n```\n\n### 读取文档\n\n```json\n{\n  \"action\": \"read\",\n  \"doc_token\": \"JZyJdrVVTok9mfxVHqJc91Dhn3g\"\n}\n```\n\n### 追加内容\n\n```json\n{\n  \"action\": \"append\",\n  \"doc_token\": \"JZyJdrVVTok9mfxVHqJc91Dhn3g\",\n  \"content\": \"## 新章节\\n\\n这里是新增加的内容。\"\n}\n```\n\n### 覆盖写入\n\n```json\n{\n  \"action\": \"write\",\n  \"doc_token\": \"JZyJdrVVTok9mfxVHqJc91Dhn3g\",\n  \"content\": \"# 完全覆盖的标题\\n\\n全部内容都被替换了。\"\n}\n```\n\n## 内容格式\n\n- 使用 Markdown 格式\n- 飞书会自动渲染标题、列表、代码块等\n- 建议每段内容不要太长，分多次 append\n\n## 常见问题\n\n### Q: create 后内容是空的\nA: 使用 create + append 的两步写法，不要一次性 create + content\n\n### Q: 追加内容格式混乱\nA: 每次 append 建议包含完整的 Markdown 结构，飞书会按块处理\n\n### Q: 如何知道 doc_token\nA: 从 URL 提取，或 create 后的返回值获取\n\n---\n\n## 相关工具\n\n- `feishu_wiki`: 知识库操作\n- `feishu_bitable`: 多维表格操作\n- `feishu_drive`: 云盘操作\n","topics":["Feishu","文档","飞书"],"tags":{"document":"1.0.0","feishu":"1.0.0","latest":"1.0.0","openclaw":"1.0.0"},"stats":{"comments":0,"downloads":604,"installsAllTime":23,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772702715395,"updatedAt":1778491730325},"latestVersion":{"version":"1.0.0","createdAt":1772702715395,"changelog":"Feishu Doc skill v1.0.0 initial release:\n\n- Provides tools for creating, reading, appending, and updating Feishu documents.\n- Details operations using the feishu_doc tool, including required parameters for each action.\n- Highlights best practices: create empty documents first, then append content to avoid creation errors.\n- Explains how to extract doc_token from Feishu document URLs.\n- Includes clear usage examples and solutions for common issues.\n- Lists related Feishu tools for wiki, bitable, and drive integrations.","license":null},"metadata":null,"owner":{"handle":"noir-hedgehog","userId":"s175jqq3kcxjrgf7jg5s0y31c583vm0k","displayName":"Noir","image":"https://avatars.githubusercontent.com/u/261261891?v=4"},"moderation":null}