# Lark Doc > Operaciones sobre documentos en la nube de Lark (Docx/Wiki): leer, crear y editar documentos, insertar o descargar imágenes/adjuntos, y gestionar notas mentales. Fuente: https://skillsagentes.com/skills/larksuite/cli/lark-doc Markdown: https://skillsagentes.com/skills/larksuite/cli/lark-doc.md Repositorio: https://github.com/larksuite/cli Autor: larksuite Licencia: MIT Actualizado: el mes pasado Coste de contexto: 101 tok instalada, 1k tok al activarse, 44.6k tok con todos los archivos del bundle Bundle: 44 archivos, 174 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add larksuite/cli --skill lark-doc --agent claude-code # Cursor npx -y skills add larksuite/cli --skill lark-doc --agent cursor # Codex npx -y skills add larksuite/cli --skill lark-doc --agent codex # Gemini CLI npx -y skills add larksuite/cli --skill lark-doc --agent gemini # Windsurf npx -y skills add larksuite/cli --skill lark-doc --agent windsurf # Cline npx -y skills add larksuite/cli --skill lark-doc --agent cline ``` ## Qué hace - Lee, crea y edita documentos Docx/Wiki de Lark mediante lark-cli docs - Inserta, previsualiza y descarga imágenes o archivos adjuntos incrustados en el documento - Gestiona pizarras (whiteboard) y notas mentales (mindnotes) asociadas al documento - Consulta, revierte y comprueba el estado de versiones históricas del documento - Analiza URLs/tokens de documentos y XML local, contando caracteres para diagnóstico ## Cuándo usarla - El usuario da una URL o token de un documento Docx/Wiki (incluye /docx/ o /wiki/ de doubao.com) - Se necesita crear un documento desde cero, importar contenido o crear uno vacío - Hay que reescribir, pulir, reorganizar o dar formato a un documento existente - Se requiere insertar, previsualizar o descargar imágenes/adjuntos/pizarras del documento ## Cuándo no - Operaciones a nivel de archivo en Drive (buscar, importar/exportar, subir/descargar, permisos) - Comentarios del documento (añadir, ver, responder o reacciones) - Operaciones internas de datos en tablas o Base ## Qué la activa - "Aquí tienes el link del documento, resúmelo por favor" - "Crea un documento nuevo con este contenido" - "Reescribe y pule esta sección del documento" - "Descarga las imágenes adjuntas de este documento" - "Revierte el documento a la versión anterior" ## Antes de instalar - Requiere el binario lark-cli y el skill lark-shared para autenticación e identidad. ## Archivos - SKILL.md — 4 KB - references/genres/business-analysis.md — 3 KB - references/genres/data-report.md — 3 KB - references/genres/email.md — 4 KB - references/genres/execution-plan.md — 3 KB - references/genres/formal-doc.md — 4 KB - references/genres/meeting-minutes.md — 2 KB - references/genres/memo-brief.md — 2 KB - references/genres/official-redhead.md — 6 KB - references/genres/prd.md — 2 KB - references/genres/proposal.md — 2 KB - references/genres/research-report.md — 3 KB - references/genres/retrospective.md — 2 KB - references/genres/route-consumer.md — 4 KB - references/genres/route-creative.md — 4 KB - references/genres/route-knowledge.md — 5 KB - references/genres/route-marketing.md — 4 KB - references/genres/route-media.md — 4 KB - references/genres/route-opinion.md — 4 KB - references/genres/route-personal-brand.md — 3 KB - references/genres/route-platform.md — 639 B - references/genres/route-report.md — 1 KB - references/genres/route-workplace.md — 3 KB - references/genres/sop-tutorial.md — 4 KB - references/genres/technical-doc.md — 4 KB - references/genres/wechat.md — 4 KB - references/genres/weekly-report.md — 2 KB - references/genres/white-paper.md — 3 KB - references/genres/xiaohongshu.md — 3 KB - references/lark-doc-create-workflow.md — 9 KB - references/lark-doc-create.md — 3 KB - references/lark-doc-fetch.md — 7 KB - references/lark-doc-history.md — 5 KB - references/lark-doc-md.md — 6 KB - references/lark-doc-media-download.md — 2 KB - references/lark-doc-media-insert.md — 7 KB - references/lark-doc-media-preview.md — 2 KB - references/lark-doc-mindnote.md — 5 KB - references/lark-doc-resource-cover.md — 4 KB - references/lark-doc-script.md — 5 KB - references/lark-doc-update.md — 6 KB - references/lark-doc-whiteboard.md — 9 KB - references/lark-doc-xml-extended-blocks.md — 4 KB - references/lark-doc-xml.md — 5 KB ## SKILL.md Reproducido tal cual desde larksuite/cli bajo MIT. Esta sección es el documento original y está en inglés. # docs ## 场景与 Shortcut 路由 **CRITICAL：先判断场景，再读取该场景的参考文件；不要在任务开始时一次性读取全部参考文件。每个文件只在首次进入对应阶段时读取一次。** **身份：文档操作推荐显式指定 `--as user`。** **本地文件引用统一遵循文件访问权限：CWD 内优先使用 `@./相对路径`，其他目录使用 `@绝对路径`。XML 内的相对资源路径先查 CWD；仅文件不存在时再查源 XML 文件所在目录，同名文件以 CWD 为准。内联内容、stdin、在线文档没有源文件目录，不执行回退。** ### 文档内容 - **读取 / 摘要 — [`+fetch`](references/lark-doc-fetch.md)**：先读参考再获取文档。 - **从零创作 — [`创建工作流`](references/lark-doc-create-workflow.md)**：先完整执行创建工作流，**简单任务不是跳过的理由**； - **导入 / 空文档 — [`+create`](references/lark-doc-create.md)**：仅创建空文档或原样导入用户提供的完整内容时，跳过创建工作流。 - **编辑 / block 直达链接 — [`+update`](references/lark-doc-update.md)**：语义改写、润色、重组、补写或排版均按 update 参考完成。 ### 辅助能力 - **草稿初始化、解析与统计 — [`+script`](references/lark-doc-script.md)**：支持解析文档 URL / token 与本地 XML，统计字数并返回字符诊断；不支持 Markdown 输入。 - **历史版本 — [`+history-list` / `+history-revert` / `+history-revert-status`](references/lark-doc-history.md)**：查询、回滚文档历史版本或检查回滚任务状态。 ### 资源、画板与思维笔记 - **插入本地素材 — [`+media-insert`](references/lark-doc-media-insert.md)**：在文末插入本地图片或文件。 - **预览素材 — [`+media-preview`](references/lark-doc-media-preview.md)**：预览文档或评论中的图片、附件或素材。 - **下载素材 — [`+media-download`](references/lark-doc-media-download.md)**：下载文档中的图片、附件、素材或画板缩略图。 - **Docx 封面 — [`+resource-download` / `+resource-update` / `+resource-delete`](references/lark-doc-resource-cover.md)**：下载、更新或删除 Docx 封面。 - **画板 — [`画板工作流`](references/lark-doc-whiteboard.md)**：创建或更新画板时先读取工作流；更新已有画板必须复用现有 token，禁止新建空白画板；使用 [`whiteboard +update`](../lark-whiteboard/references/lark-whiteboard-update.md) 写入。 - **思维笔记 — `mindnotes`**：已有思维笔记走 [`思维笔记链路`](references/lark-doc-mindnote.md)；新建思维笔记走 [`lark-doc-whiteboard`](references/lark-doc-whiteboard.md)。 ### 认证与 Scope 执行 Shortcut 时，不预读 [`lark-shared`](../lark-shared/SKILL.md) 或预跑 `auth status --verify`；仅遇到未认证、token / 身份或 scope 错误时读取该 Skill，修复后重试。认证、身份或 scope 管理请求则直接使用该 Skill。 ## 不在本 Skill 范围 - **Drive 文件级操作**：找文档、导入导出、云空间文件上传 / 下载 / 权限管理 → [`lark-drive`](../lark-drive/SKILL.md)。复制文档、创建副本或另存为副本时，按其指引使用 `lark-cli drive files copy`；不要用 `docs +fetch` + `docs +create` 重建正文。 - **独立评论操作**：添加、分页查看、回复评论或增删 reaction → [`lark-drive`](../lark-drive/SKILL.md)；只需紧凑评论上下文时，直接使用默认 JSON 响应的 `docs +fetch`。 ## Dónde encaja - Categoría: [Documentos](https://skillsagentes.com/categorias/documentos.md) — Lee, escribe y transforma archivos PDF, DOCX, XLSX y PPTX. - Creador: [larksuite](https://skillsagentes.com/creators/larksuite.md) — 28 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Lark Slides](https://skillsagentes.com/skills/larksuite/cli/lark-slides.md): 飞书幻灯片: crea y edita presentaciones, lee contenido de slides, gestiona páginas (crear, eliminar, leer, reemplazo parcial). No cubre documentos, pizarras ni archivos generales. - [Lark Drive](https://skillsagentes.com/skills/larksuite/cli/lark-drive.md): Drive de Feishu/Lark: gestiona archivos y carpetas (subir/descargar, copiar/mover/eliminar, metadatos, permisos, comentarios, versiones, etiquetas de confidencialidad) e importa archivos locales como docx/sheet/bitable/slides. - [Lark Base](https://skillsagentes.com/skills/larksuite/cli/lark-base.md): Operaciones en Lark Base (multitabla): tablas, campos, registros, vistas, fórmulas/lookup, formularios, dashboards, workflows y roles; se usa ante Base/多维表格/bitable o enlaces /base/. - [Lark Im](https://skillsagentes.com/skills/larksuite/cli/lark-im.md): Mensajería instantánea de Feishu/Lark: enviar y responder mensajes, buscar historial, gestionar miembros de grupo, subir/descargar archivos, reacciones, avisos urgentes y tarjetas interactivas con sus callbacks. - [Lark Apps](https://skillsagentes.com/skills/larksuite/cli/lark-apps.md): Desarrollo y hosting de apps Miaoda/Spark: creación, desarrollo local o en la nube, diseño creativo, integraciones de IA/Feishu, logs, métricas, variables de entorno, colaboradores, roles y triggers. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)