Automate Hancom Documents
innae1121-bit/gsghwp
Route every Hancom/HWP document edit, analysis, and verification request to the GSGHWPBETA (gsg-hwp-beta-live) MCP.
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退…
Install Lark Drive
$ npx skills add Pinvou/pinvou-agent --skill lark-drive -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install Pinvou/pinvou-agent lark-drive --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/Pinvou/pinvou-agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive .claude/skills/lark-drive && 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 "lark-drive" agent skill from https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive into .claude/skills/lark-drive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-drive", 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/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-driveType 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 Pinvou/pinvou-agent --skill lark-drive -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install Pinvou/pinvou-agent lark-drive --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git skills-src && mkdir -p .agents/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive .agents/skills/lark-drive && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "lark-drive" agent skill from https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive into .agents/skills/lark-drive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-drive", 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 Pinvou/pinvou-agent --skill lark-drive -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install Pinvou/pinvou-agent lark-drive --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive .cursor/skills/lark-drive && 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 "lark-drive" agent skill from https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive into .cursor/skills/lark-drive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-drive", 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/Pinvou/pinvou-agent.git --path pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive--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 Pinvou/pinvou-agent --skill lark-drive -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install Pinvou/pinvou-agent lark-drive --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive .gemini/skills/lark-drive && 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 "lark-drive" agent skill from https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive into .gemini/skills/lark-drive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-drive", 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 Pinvou/pinvou-agent lark-driveInstalls 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 Pinvou/pinvou-agent --skill lark-drive -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git skills-src && mkdir -p .github/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive .github/skills/lark-drive && 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 "lark-drive" agent skill from https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive into .github/skills/lark-drive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-drive", 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 Pinvou/pinvou-agent --skill lark-drive -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install Pinvou/pinvou-agent lark-drive --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/Pinvou/pinvou-agent.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive .opencode/skills/lark-drive && 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 "lark-drive" agent skill from https://github.com/Pinvou/pinvou-agent/tree/main/pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive into .opencode/skills/lark-drive/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-drive", 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
lark-drive- GitHub stars
- 2.4k
- Token cost
- ~4k tokens
- SKILL.md length
- 923 words
- Files
- 61 (incl. references)
- Skills in repo
- 30
- Repo updated
- First seen
- Licence
- MIT
At a glance
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退…
- Tasks that involve Messaging and chat bots
- SKILL.md covers 快速决策, 修改标题, 核心概念 and 不在本 skill 范围, plus 2 more sections
- Reaches xxx.feishu.cn
- Tasks that involve PowerPoint presentations
What it does
Lark Drive is an agent skill from Pinvou/pinvou-agent. 【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退 WebFetch。不负责:文档内容编辑(lark-doc)、表格/Base 表内数据(lark-sheets/lark-base)、知识库节点(lark-wiki)。
Its SKILL.md is about 4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 61 other files, including reference files (for example `references/lark-drive-add-comment.md`, `references/lark-drive-add-reply.md` and `references/lark-drive-apply-permission.md`).
It sits in Documents & Office, covering Messaging and chat bots and PowerPoint presentations. It works with Microsoft Excel and Microsoft PowerPoint. The repository describes itself as: Open-source desktop AI agent for tools, files, knowledge, workflows, and real deliverables. The licence is MIT.
When your agent uses it
- Tasks that involve Messaging and chat bots
- Tasks that involve PowerPoint presentations
Example prompts
- “/lark-drive”
What it can do on your machine
Read from SKILL.md and the folder at commit b93341c. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
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 bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
xxx.feishu.cn
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
Lark Drive loads about 4k tokens when it runs, and up to ~121k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 923 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 Pinvou/pinvou-agent at commit b93341c, republished under its MIT licence (© Pinvou). 923 words, ~4,036 tokens.
Download SKILL.mdSave it as
.claude/skills/lark-drive/SKILL.md (or your agent's skills folder). This skill also uses 60 other files; get the full folder from GitHub.- name
- lark-drive
- description
- 【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退 WebFetch。不负责:文档内容编辑(lark-doc)、表格/Base 表内数据(lark-sheets/lark-base)、知识库节点(lark-wiki)。
- version
- 1.0.1
- metadata.cliHelp
- lark-cli drive --help
drive (v1)
CRITICAL — 开始前 MUST 先用 read 读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
术语说明： 飞书云空间也常被称为"云盘"、"云存储"、"网盘"或"我的空间"，这些说法通常指的是同一个产品，是飞书官方的云端文件存储与管理中心。
导入分流规则： 如果用户要把本地 Excel / CSV /
.base快照导入成 Base / 多维表格 / bitable，必须优先使用lark-cli drive +import --type bitable。不要先切到lark-base；lark-base只负责导入完成后的表内操作。
副本分流规则： 如果用户要复制在线文档、创建文档副本、把文档复制到另一个文件夹，必须使用
lark-cli drive +copy。不要用drive +export下载后再drive +import上传，也不要用docs +fetch+docs +create重建正文；导出/导入只用于本地文件转换或离线产物。
快速决策
- 用户要把已有 Wiki 节点移出知识库，放到 Drive 文件夹或“我的空间”根目录：切到
lark-wiki，使用lark-cli wiki +move-to-drive；不要把 Wiki token 直接交给drive +move。这是会改变文档归属和权限继承的写操作，执行前确认源节点与目标位置。 - 用户要复制文档 / 创建副本 到云盘或者文件夹时：已提供可直接使用的 URL 或 token，按
references/lark-drive-copy.md使用lark-cli drive +copy；仅提供标题时，先按references/lark-drive-search.md使用drive +search唯一定位源资源，再按 copy reference 复制。如果是要复制文档 / 创建副本到知识库，使用wiki +node-copy（见lark-wiki-node-copy.md）。 - 用户要识别飞书 / doubao 云空间 URL 的类型和 token时，可以先按 URL 路径形态做轻量判断；当路径已明确指向 docx / sheet / bitable / slides / file / folder 等资源时，可直接提取对应 token/type。传入 wiki URL、需要识别标题或 canonical URL、URL/token 有歧义，或后续操作依赖底层真实资源时，再使用
lark-cli drive +inspect --url '<url>'进行识别；具体用法、失败处理和边界见references/lark-drive-inspect.md。 - 高风险写操作（删除、公开权限修改、owner 转移、版本删除/回滚、批量移动/覆盖/同步）必须同时满足三个条件才执行：目标已解析为该操作可直接使用的执行对象，执行细节已明确到可直接调用命令（例如删除的 file-token/type、公开权限修改的共享范围、owner 转移的目标 owner、版本删除/回滚的 version id、移动/覆盖/同步的目标位置和冲突策略），且用户在本轮明确确认执行这些具体目标和执行细节。用户只说“删除没用的文件”“开放/共享给大家”“改成开放”“覆盖/移动这些”只表示目标状态；先只读发现并列出候选、权限档位或执行方案，停止等待用户确认。
- 用户明确要移除单个云文档协作者权限时，使用
lark-cli drive +member-remove；先阅读references/lark-drive-member-remove.md。这是高风险写操作，真实执行必须确认准确的资源、成员 ID/type 和 wiki 权限范围，并显式传--yes。 - 用户要为指定飞书文档设置 / 修改密级标签（secure label），或查询当前用户可用的密级标签，直接读取
references/lark-drive-secure-label.md；这是 Drive 文件治理能力。 - 用户要检查 / 治理文档权限、公开范围、链接分享、外部访问、复制下载权限、密级标签、owner 转移，或要“权限风险报告、收紧权限、申请查看 / 编辑权限、转移 / 批量转移 owner”，必须先阅读
references/lark-drive-workflow.md，再按其中Workflow Registry进入permission_governanceworkflow。 - 用户要查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置，优先使用
lark-cli drive +permission-get-setting；它只读取目标自身设置，不递归审计文件夹子文档权限。裸 token 必须显式传--type。 - 用户要按特定主题、关键词或内容线索跨容器查找资料，并统一收集到 Drive 文件夹或 Wiki 节点，必须先阅读
references/lark-drive-workflow.md，再按其中Workflow Registry进入topic_move_collectorworkflow。该 workflow 负责搜索召回、内容验证、相关性分类、移动计划、写前确认和结果验证；禁止直接从drive +search或drive +move开始。 - 用户要整理云盘 / 文件夹 / 文档库 / 知识库 / 个人文档库，或要“盘点目录结构、找出未归档/临时/重复/空目录、生成整理方案”，必须先阅读
references/lark-drive-workflow.md，再按其中Workflow Registry进入knowledge_organizeworkflow。默认只生成方案；创建目录、移动资源、申请权限都必须单独确认。 - 按主题跨范围查找并集中归档，进入
topic_move_collector；对已知文件夹、文档库或知识库做目录盘点和结构重组，进入knowledge_organize；只移动一个已明确资源时仍使用原子移动命令。 - 用户要搜文档 / Wiki / 电子表格 / 多维表格 / 云空间（云盘/云存储）对象，优先使用
lark-cli drive +search；按标题定位和处理重复候选时遵循references/lark-drive-search.md。自然语言里"最近我编辑过的"、"我创建的"（→--created-by-me，原始创建者语义）、"我负责/owner 的"（→--mine，owner 语义）、"最近一周我打开过的 xxx"、"某人 owner 的 docx" 等直接映射到扁平 flag，避免手写嵌套 JSON。 - 用户要对文档评论做任何操作（添加评论、列表 / 批量查询、回复、获取 / 更新 / 删除回复、解决 / 恢复、reaction），按下方 Shortcuts 表选择对应的
drive +<verb>评论命令，执行前先阅读该命令的 ref。按评论定位文档正文位置见references/lark-drive-comment-location.md。 - 用户给出 doubao.com 的云空间资源 URL/token，或明确提到豆包里的 file/folder/docx/sheet/bitable/wiki 资源时，仍按资源类型、URL 路径和 token 路由到本 skill；不要因为域名不是飞书而回退到 WebFetch。
- 导入目标类型映射：bitable←.xlsx/.csv/.base；docx←.md/.docx/.doc/.txt/.html；slides←.pptx（上限 500MB）；sheet←.xlsx/.xls/.csv，均用
lark-cli drive +import --type <类型>。 - 批量执行
drive +import且目标是同一个位置（同一--folder-token、默认根目录，或同一--target-token）时，必须串行执行；不要并发导入到同一位置，服务端可能返回并发冲突错误。 - 用户要在 Drive 里上传、创建、读取、局部 patch 或覆盖更新原生
.md文件（不是导入成 docx）：本环境无 lark-markdown 技能；远端下载用drive +download、本地编辑用文件工具、回传用drive +upload（组合说明见references/lark-drive-upload.md）。 - 比较原生
.md历史版本差异，或比较远端 Markdown 与本地草稿：先用drive +version-history/+version-get拿到历史版本到本地，再用本地 diff。 - 用户要查看、下载、回滚或删除文件的历史版本，使用
drive +version-history、drive +version-get、drive +version-revert、drive +version-delete；这组命令同时支持--as user和--as bot，自动化场景优先--as bot。 - 用户要在云空间（云盘/云存储）里新建文件夹，优先使用
lark-cli drive +create-folder。 - 用户要查看或下载文件内容，或者查看文件可用预览格式并获取 PDF / HTML / 文本 / 图片等转换预览产物，使用
lark-cli drive +preview。+preview和+download都支持--file-token/--url/--wiki-token三选一（Wiki 会解析到底层file）；但两者只处理 Drive 文件，若目标是 docx/sheet/bitable/slides 等在线文档，改用drive +export。 - 用户要获取某个文件的封面图，优先使用
lark-cli drive +cover；先--list-only看规格，再选--spec下载。 - 用户要导出云文档时，优先使用
lark-cli drive +export --url '<文档 URL>' --file-extension <格式>；详细参数、Wiki token 和错误码处理见references/lark-drive-export.md。 - 用户要把本地文件上传到知识库 / 文档库里的某个 wiki 节点下时，仍然使用
lark-cli drive +upload --wiki-token <wiki_token>；不要误切到wiki域命令。 - 用户给的是 wiki URL / token，且后续还没明确底层资源类型时，先用
lark-cli drive +inspect解包；+inspect失败后不要自动切到别的写接口继续尝试，先按错误提示处理权限、scope 或链接问题。 drive +inspect/drive +upload遇到not found、permission denied、missing scope时，默认停止重试；只有rate limit或临时网络错误才适合有限重试。
修改标题
- 用户要重命名 / 改标题 / 改文件名，使用
lark-cli drive +update-title，用法见references/lark-drive-update-title.md。
核心概念
文档类型与 Token
飞书开放平台中，不同类型的文档有不同的 URL 格式和 Token 处理方式。在进行文档操作（如添加评论、下载文件等）时，必须先获取正确的 file_token。
文档 URL 格式与 Token 处理
| URL 格式 | 示例 | Token 类型 | 处理方式 |
|---|---|---|---|
/docx/ | https://example.larksuite.com/docx/doxcnxxxxxxxxx | file_token | URL 路径中的 token 直接作为 file_token 使用 |
/doc/ | https://example.larksuite.com/doc/doccnxxxxxxxxx | file_token | URL 路径中的 token 直接作为 file_token 使用 |
/wiki/ | https://example.larksuite.com/wiki/wikcnxxxxxxxxx | wiki_token | 不能直接当底层 file_token；优先用 drive +inspect 解包获取 obj_token |
/sheets/ | https://example.larksuite.com/sheets/shtcnxxxxxxxxx | file_token | URL 路径中的 token 直接作为 file_token 使用 |
/page/ | https://example.feishu.cn/page/pagcnxxxxxxxx/ | apps token | URL 路径中的 token 直接使用，资源类型为 apps |
/drive/folder/ | https://example.larksuite.com/drive/folder/fldcnxxxx | folder_token | URL 路径中的 token 作为文件夹 token 使用 |
Wiki 链接特殊处理
lark-cli drive +inspect --url 'https://xxx.feishu.cn/wiki/wikcnXXX'知识库链接背后可能是 docx、sheet、bitable、slides、file 等不同对象。后续要做评论、下载、导出或内容读取时，优先用 drive +inspect 拿到 type、token、title、url；完整手动解析和跨 skill 路由见共享文档 lark-wiki-token-routing.md。不要只根据 /wiki/<token> 猜底层类型。
常见操作 Token 需求
| 操作 | 需要的 Token | 说明 |
|---|---|---|
| 读取文档内容 | file_token / 通过 docs +fetch 自动处理 | docs +fetch 支持直接传入 URL |
| 下载文件 | file_token | 从文件 URL 中直接提取 |
| 上传文件 | folder_token / wiki_node_token | 目标位置的 token |
典型错误与解决方案
| 错误信息 | 原因 | 解决方案 |
|---|---|---|
not exist | 使用了错误的 token | 检查 token 类型，wiki 链接必须先查询获取 obj_token |
permission denied | 没有相关操作权限 | 引导用户检查当前身份对文档/文件是否有相应操作权限；如果需要，可以授予相应权限 |
invalid file_type | file_type 参数错误 | 根据 obj_type 传入正确的 file_type（docx/doc/sheet/slides/bitable/apps） |
232140101 / 232140100 / 233523001（常见于 drive +import 的 job_error_msg） | 同一位置下存在并发导入 / 创建操作 | 批量导入到同一文件夹、根目录或同一 --target-token 时改为串行执行；每个失败项每次重试前等待几秒，总共最多重试 3 次，仍失败就停止并报告冲突 |
权限能力入口
- 用户要管理 Drive 文档/文件协作者、公开权限、授权当前应用访问文档，或处理
permission.public.patch的91009/91010/91011/91012错误时，先读lark-drive-permission-guide.md。 - 用户要查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置，使用
+permission-get-setting；如果要递归审计文件夹下子文档权限，再进入permission_governanceworkflow。 - 用户只是没有访问权限并希望向 owner 申请访问，优先使用
+apply-permission。 - 普通 scope、身份或登录问题仍按
lark-shared处理；不要把租户安全策略、对外分享、密级拦截简单归类为缺 scope。
Show full SKILL.md (377 more words)Show less
不在本 skill 范围
- 文档正文读取、总结、创建、编辑、图片/附件插入或下载：使用
lark-doc。 - 电子表格单元格、筛选、公式、样式等表内操作：使用
lark-sheets。 - Base / 多维表格内部的表、字段、记录、视图、仪表盘等操作：使用
lark-base。 - 知识空间、Wiki 节点层级、空间成员管理：使用
lark-wiki；上传本地文件到 wiki 节点仍用drive +upload --wiki-token。 - 在线文档（docx 等）正文的历史版本查询 / 回滚：使用
lark-doc的+history-list/+history-revert，不走本 skill 的+version-*。 - 原生 Markdown 文件的在线读写/patch/diff:本环境无专门技能,按上述 download/本地编辑/upload 组合处理
Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（lark-cli drive +<verb> [flags]）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+search | 搜索文档、Wiki、表格、文件夹等云空间对象；支持 --edited-since、--created-by-me、--mine、--doc-types 等扁平 flag；区分 original creator 与 owner 语义。 |
+upload | 上传本地文件到 Drive 文件夹或 wiki 节点；修改/重写/更新已有文件时优先覆盖上传，而不是直接上传一个新文件。 |
+create-folder | 新建 Drive 文件夹，支持父文件夹与 bot 创建后自动授权。 |
+download | 下载 Drive 文件到本地。 |
+preview | 查看或下载文件内容，或者查看文件可用预览格式并获取 PDF / HTML / 文本 / 图片等转换预览产物。 |
+cover | 查看或下载文件封面图规格。 |
+status | 比较本地目录与 Drive 文件夹差异；默认按 SHA-256 精确比较，--quick 使用修改时间近似比较。 |
+pull | 从 Drive 拉取文件到本地目录，支持重复远端路径处理和增量模式。 |
+sync | 双向同步本地目录与 Drive 文件夹：拉取 new_remote、推送 new_local，双向处理 modified；只同步 type=file，跳过在线文档和 shortcut，且不会删除两端多余文件（镜像删除分别用 +pull --delete-local / +push --delete-remote）。参数语义：--on-conflict 只对 modified 生效（remote-wins / local-wins / keep-both / ask）；--on-duplicate-remote 只对远端同名冲突生效（fail 默认 / newest / oldest）；--quick 改用修改时间近似比较（默认 SHA-256 精确比较）。 |
+push | 将本地目录推送到 Drive 文件夹，支持 skip / smart / overwrite 与确认后删除远端。 |
+create-shortcut | 在另一个文件夹里创建现有 Drive 文件的快捷方式。 |
+copy | 复制资源到目标文件夹；如果要复制到知识库，使用 wiki +node-copy； |
+add-comment | 给 doc/docx/file/sheet/slides/base(bitable) 添加全文/局部评论；不支持妙搭 apps。 |
+list-comments | 分页获取评论列表。 |
+batch-query-comments | 按评论 ID 批量获取评论。 |
+resolve-comment | 把评论标记为已解决（is_solved=true）。 |
+restore-comment | 恢复/重新打开已解决评论（is_solved=false）。 |
+add-reply | 给已有评论添加回复。 |
+list-replies | 分页获取某条评论下的回复。 |
+update-reply | 整体替换某条回复的内容。 |
+delete-reply | 删除评论下的某条回复（高风险，需 --yes）。 |
+react-reply | 给回复加/删表情回应。 |
+export | 将 doc/docx/sheet/bitable/slides 导出为本地文件。 |
+export-download | 根据导出产物的 file_token 下载文件。 |
+import | 将本地文件导入为飞书在线文档、表格、多维表格或幻灯片。 |
+version-history | 查看文件历史版本。 |
+version-get | 下载指定历史版本。 |
+version-revert | 回滚到指定历史版本。 |
+version-delete | 删除指定历史版本。 |
+move | 移动 Drive 文件或文件夹；Wiki 层级移动走 lark-wiki。 |
+update-title | 重命名文件、文件夹、在线文档或知识库。 |
+delete | 删除 Drive 文件或文件夹，文件夹删除会轮询异步任务。 |
+task_result | 查询 import/export/move/delete 等异步任务结果。 |
+inspect | 检视 URL 的类型、标题和 canonical token；wiki URL 会自动解包到底层文档。 |
+apply-permission | 以 user 身份向文档 owner 申请访问权限。 |
+member-add | 添加一个或最多 10 个 Drive 文档、文件、文件夹或 wiki 节点协作者/授权成员；封装 Drive permission member create/batch_create，真实写入需要 --yes。 |
+member-list | 查询 Drive 文档、文件、文件夹或 wiki 节点的协作者/授权成员列表。 |
+member-remove | 移除一个 Drive 文档、文件、文件夹或 wiki 节点协作者；封装 Drive permission member delete，真实写入需要 --yes。 |
+permission-get-setting | 查询文件、文件夹或云文档自身的公开访问、分享、协作者管理、安全与评论权限设置；支持 URL 或裸 token + --type；不递归读取文件夹子文档权限。 |
+secure-label-list | 列出当前用户可用的密级标签。 |
+secure-label-update | 更新 Drive 文件或文档的密级标签。 |
API Resources
lark-cli schema drive.<resource>.<method> # 调用 API 前必须先查看参数结构
lark-cli drive <resource> <method> [flags] # 调用 API重要：使用原生 API 时，必须先运行
schema查看--data/--params参数结构，不要猜测字段格式。高频原生命令： 读取 Drive 文件夹清单时使用
drive files list，使用前先读references/lark-drive-files-list.md，按模板通过--params传参并手动处理分页；不要把--page-all输出直接交给 JSON 解析脚本。
files
copy— 复制文件；优先使用drive +copycreate_folder— 新建文件夹list— 获取文件夹下的清单；使用前阅读references/lark-drive-files-list.mdpatch— 修改文件标题；优先使用drive +update-titleshortcut
permission.members
auth— 公共访问/协作权限设置修改前的 manage-public 权限预检；详见 references/lark-drive-workflow-permission-governance.mdcreate— 增加协作者权限transfer_owner— owner 转移，高风险写：需--yes并走 permission_governance 确认（见 references/lark-drive-workflow-permission-governance.md）
metas
batch_query— 获取文档元数据
user
remove_subscription— 取消订阅用户、应用维度事件subscription— 订阅用户、应用维度事件（本次开放评论添加事件）subscription_status— 查询用户、应用对指定事件的订阅状态
file.statistics
get— 获取文件统计信息- 获取 docx / 文件统计信息时，建议优先使用 typed flags：
lark-cli drive file.statistics get --file-token <token> --file-type <type> --format json；--paramsJSON 也支持，适合批量拼装或 raw 参数场景。
- 获取 docx / 文件统计信息时，建议优先使用 typed flags：
file.view_records
list— 获取文档的访问者记录- 查看 docx 最近访问记录、返回 open_id、最多 N 条时，建议优先使用 typed flags：
lark-cli drive file.view_records list --file-token <docx_token> --file-type docx --page-size <N> --viewer-id-type open_id --format json；--paramsJSON 也支持，适合批量拼装、分页续跑或 raw 参数场景。
- 查看 docx 最近访问记录、返回 open_id、最多 N 条时，建议优先使用 typed flags：
file.comment.reply.reactions
update_reaction— 添加/删除 reaction；优先使用drive +react-reply
quota_details
get— 获取当前用户的容量信息，包含各业务使用量、租户配额是否超限、用户配额、所在部门配额- 仅支持
--as user，不要使用默认的 bot 身份 quota_detail_id传当前用户的user_id
- 仅支持
© Pinvou, 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 60 other files (references) in pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive of Pinvou/pinvou-agent.
- SKILL.md
- references/lark-drive-add-comment.md
- references/lark-drive-add-reply.md
- references/lark-drive-apply-permission.md
- references/lark-drive-batch-query-comments.md
- references/lark-drive-comment-content.md
- references/lark-drive-comment-location.md
- references/lark-drive-copy.md
- references/lark-drive-cover.md
- references/lark-drive-create-folder.md
- references/lark-drive-create-shortcut.md
- references/lark-drive-delete-reply.md
- references/lark-drive-delete.md
- references/lark-drive-download.md
- references/lark-drive-export-download.md
- references/lark-drive-export.md
- references/lark-drive-files-list.md
- references/lark-drive-import.md
- references/lark-drive-inspect.md
- references/lark-drive-list-comments.md
- … and 41 more
Open the folder on GitHubat commit b93341c
Compare with similar skills
Lark Drive 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 |
|---|---|---|---|---|---|---|
| Lark Drive this skillPinvou/pinvou-agent | 2.4k | — | ~4k | Automated safety check: Pass | MIT | |
| Automate Hancom Documentsinnae1121-bit/gsghwp | 101 | — | ~7.9k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| GenOffice Document CLIgenspark-ai/genoffice | 9.2k | — | ~19k | Automated safety check: Pass | Apache-2.0 | |
| Docx4jplutext/docx4j | 2.4k | — | ~2.5k | Automated safety check: Pass | None | |
| Cyber Pptcrazyykhllc-bit/CyberPPT | 1.8k | — | ~10k | Automated safety check: Pass | MIT |
Similar skills
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
GenOffice Document CLI
genspark-ai/genoffice
Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.
Docx4j
plutext/docx4j
A skill your agent uses when writing Java code that creates, reads or edits Word (.docx), PowerPoint (.pptx) or Excel (.xlsx) files with docx4j — including generating documents, editing existing…
Cyber Ppt
crazyykhllc-bit/CyberPPT
当用户需要把 DOCX、PDF、TXT、XLSX、研究报告、业务材料或原始数据转成高密度、可编辑、咨询风格 PPTX 时使用；也适用于需要 SCR 论证、视觉风格探索、详细图表和渲染质检的 PPT。
Markit
shift-labs-ai/markit
Convert files and URLs to Markdown. An agent skill from shift-labs-ai/markit.
More from Pinvou/pinvou-agent
All 30 skills in this repoTmeet Skill
Pinvou/pinvou-agent
何时用：用户明确要通过命令行操作腾讯会议（tmeet），或 Agent 遇到工具缺失/调用失败/能力不足想反馈平台时。OAuth 登录/登出/状态、会议管理（创建/更新/取消/查询/搜索/受邀者）、录制管理（列表/播放地址/智能纪要/转写/权限申请）、元宝纪要（按关键词/时间搜索、稳态/瞬态详情）、会议报告（参会人/等候室/导出明细/异步任务）、通讯录（仅限会议邀请/呼叫入会前置解析，严禁单独查…
Wecomcli Doc
Pinvou/pinvou-agent
何时用:仅当用户明确指定 doc/docx/word/在线文档/office文档或提供 doc.weixin.qq.com/doc/ 链接时使用;泛指「做个文档/写文档/整理成文档」默认走 wecomcli-smartpage 或本地工具,本技能不得抢占。doc 内容操作:新建、导入(.doc/.docx/.txt)、读取、追加、覆盖写入;结构化数据需求改用智能文档/智能表格;公共管理走…
Dws
Pinvou/pinvou-agent
【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/AI听记/邮箱/在线电子表格(axls)/知…
Lark Im
Pinvou/pinvou-agent
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive…
Lark Sheets
Pinvou/pinvou-agent
【何时用:仅当用户明确指向飞书/Lark 电子表格;泛指做表格默认走本地工具】创建/操作飞书电子表格:工作表与行列结构、读写单元格(值/公式/样式/批注/图片)、查找替换、批量更新、图表/透视表/条件格式/筛选/迷你图/浮动图片。按名称搜索云空间表格文件改用 lark-drive 的 drive +search。doubao.com 的 /sheets/ URL 也走本 skill。不适用本地…
Lark Base
Pinvou/pinvou-agent
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、BaseApp 应用模式（页面与组件）、Workspace 目录、workflow、角色权限、模板中心（模板分类/列表/搜索）；遇到…
Related
Works with
Questions about Lark Drive
What does Lark Drive do?
【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云空间:管理 Drive 文件/文件夹,上传下载、复制移动删除、评论、权限、密级标签、版本、改标题,导入 Word/Markdown/Excel/CSV/PPTX/.base 为在线文档;doubao.com 云空间 URL 同走本 skill,不回退…. Lark Drive is an agent skill from Pinvou/pinvou-agent.
When should I use Lark Drive?
Lark Drive fits situations like: tasks that involve Messaging and chat bots; tasks that involve PowerPoint presentations.
How do I install Lark Drive in Claude Code?
Run `npx skills add Pinvou/pinvou-agent --skill lark-drive -a claude-code`. Or copy the skill folder (pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive in Pinvou/pinvou-agent) into .claude/skills/lark-drive in your project. Claude Code loads it when a task matches its description.
How do I install Lark Drive in Codex?
Run `npx skills add Pinvou/pinvou-agent --skill lark-drive -a codex`. Or copy the skill folder (pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-drive in Pinvou/pinvou-agent) into .agents/skills/lark-drive in your project. Codex loads it when a task matches its description.
Can I use Lark Drive 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 Pinvou/pinvou-agent --skill lark-drive -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lark-drive, .gemini/skills/lark-drive, .github/skills/lark-drive and .opencode/skills/lark-drive in your project.
What does Lark Drive need to run?
SKILL.md names no scripts, command-line tools or credentials: Lark Drive is instructions for the agent only.
Does Lark Drive access the network?
SKILL.md names 1 domain. In commands or code: xxx.feishu.cn; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Lark Drive 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 Lark Drive use?
Lark Drive 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 Lark Drive use?
About 4k tokens (SKILL.md is roughly 16k 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 117k tokens, read only when the agent opens those files.
What are the alternatives to Lark Drive?
Skills that share tags, products or a category with Lark Drive: Automate Hancom Documents (innae1121-bit/gsghwp, 101 stars), Markitdown (ImCa0/just-laws, 781 stars), GenOffice Document CLI (genspark-ai/genoffice, 9.2k stars) and Docx4j (plutext/docx4j, 2.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Lark Drive?
Pinvou (a GitHub organization) maintains it in Pinvou/pinvou-agent, which has 2,416 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 10, 2026.
Source: Pinvou/pinvou-agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.