feishu-cli-docs

Name: feishu-cli-docs
Author: riba2534

github.com/riba2534Documents1.4k167 installsUpdated 3w ago

About feishu-cli-docs

feishu-cli-docs is a routing and execution-guidance skill for Feishu document tasks, covering reading, authoring, editing, importing, and exporting. It maps task intent to workflows and sets rules for edits, identity, permissions, and result handling.

Key features

01Routes tasks to document workflows
02Covers reading, authoring, editing, import, and export
03Defines procedures for changing existing documents
04Explains identity and permission handling
05Specifies exit-code and confirmation handling

Use cases

01Choosing a suitable document reading or editing flow
02Editing existing documents precisely by block ID
03Importing or exporting Markdown and Feishu documents
04Diagnosing permission errors and partial failures

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-docs

After installing, type/feishu-cli-docsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

evals/

evals.json

evals/fixtures/

local-image.md

owner-config.yaml

remote-image.md

references/workflows/author/references/

doc-script.md

docs-ai-markdown.md

docx-xml-extended-blocks.md

docx-xml.md

references/workflows/author/references/genres/

business-analysis.md

data-report.md

email.md

execution-plan.md

formal-doc.md

meeting-minutes.md

memo-brief.md

official-redhead.md

prd.md

proposal.md

research-report.md

retrospective.md

route-consumer.md

route-creative.md

route-knowledge.md

route-marketing.md

route-media.md

route-opinion.md

route-personal-brand.md

route-platform.md

route-report.md

route-workplace.md

Details

From the project README

飞书文档

只读取当前任务需要的工作流；跨步骤任务可以按顺序读取多个。加载后，将工作流中的 references/、scripts/、templates/、examples/ 相对路径按该 workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

路由

意图	读取文件
阅读、总结、分析 docx/wiki/sheet，大文档按大纲/章节/关键词局部读取，获取块结构，不主动落盘	`references/workflows/read/workflow.md`
取文档内容转成可直接发 IM 的 Markdown（`doc read --doc-format im-markdown`，`--lang` 控制 @人显示语言）	`references/workflows/read/workflow.md`
带 block id 读取（`doc read --with-ids` / `--engine docs_ai`），为精确修改做准备	`references/workflows/read/workflow.md`
从零创作文档（写 / 起草方案、PRD、周报、纪要、报告、教程等），选体裁、写 DocxXML 草稿并用 `doc script` 初始化与预检	`references/workflows/author/workflow.md`
创建 docx（含 `doc create --content` 带本地图片/附件、HTML 块、画板源文件建文档）、追加、覆盖、替换、删除或移动内容，按 block id 精确改写，插入本地或剪贴板图片/附件（`--from-clipboard`）	`references/workflows/write/workflow.md`
设置、下载或删除文档封面（`doc resource update/download/delete --type cover`）	`references/workflows/write/workflow.md`
查看历史版本、回滚文档（`doc history list/revert/revert-status`）	`references/workflows/write/workflow.md`
把 Markdown 文件导入为飞书 docx（含 Mermaid/PlantUML/SVG 转画板）	`references/workflows/import/workflow.md`
导出 docx/wiki/sheet 到本地 Markdown/PDF/Word/Excel，下载或预览文档内图片、附件、评论图片或画板缩略图（`doc media-download` / `doc media-preview`）	`references/workflows/export/workflow.md`
上传、下载、覆盖、查找替换或比较云盘原生 `.md`	`references/workflows/markdown/workflow.md`
读取已有思维笔记的节点，新增子节点或更新节点（`mindnote nodes list/create`）	`references/workflows/mindnote/workflow.md`

关键边界

“查看并总结”走 read；明确要求保存到路径才走 export。
从零写一篇文档走 author；只建空文档、原样写入用户给定的完整内容或改已有文档走 write。
Markdown 转为可阅读 docx 走 import；把 .md 源文件原样存入云盘走 markdown。
mindnote nodes create 只在已有思维笔记里新增/更新节点，不新建思维笔记；新建思维导图走 feishu-cli-visual 的画板。
DOCX/XLSX 等二进制文件导入走 feishu-cli-storage 的 drive 工作流。
doc htmlbox 属于 feishu-cli-visual；权限和转移所有权属于 feishu-cli-storage。

执行规则

/wiki/ 链接或类型不明的 token 先 drive inspect --url 解析；Bitable 链接用 bitable resolve。wiki 链接解析后区分 node_token 与底层文档 obj_token；底层是 sheet/bitable/slides 时按类型交给对应技能。
修改已有文档一律用 doc content-update，不要用 doc import --document-id（只会追加到文末）；改几个字用文本级替换，改章节或块先 doc read --with-ids 拿 block id。写入前确认目标、更新模式和影响范围；content-update 没有 dry-run，不确定时先在测试文档上验证。
写命令默认 Bot 身份：Bot 新建的文档会自动给当前登录用户授予 full_access（输出 permission_grant）；编辑用户自己的文档而 Bot 无权限时，显式 --user-access-token "$(feishu-cli auth token --as user)"。读命令 User 优先、Bot 兜底。
按退出码处理结果：2 = 参数或定位有歧义（选择器多处命中、方言占位无法写回、本地文件不存在），修正参数后重试； 1 且有失败明细（doc import 的 failures、content-update 的 partial_success、本地资源 failed）时按明细补齐，不要整篇重导；10 = 危险操作缺 --yes（doc delete、doc history revert）。
导入前读取 references/workflows/import/references/doc-guide.md。
用户明确指定接收人时按其要求授权；其余按 write 工作流读取生效的 owner_email / transfer_ownership，仅在已配置 owner 时处理。未要求通知时在当前会话返回文档链接。

删除、覆盖类命令返回退出码 10 时，向用户确认目标与影响后追加全局 --yes 重跑，不要自行添加。身份或 scope 报错（如 99991663/99991668/99991672/99991679）读取 ../feishu-cli-platform/references/workflows/auth/references/identity.md；判断成败、编写脚本或处理确认门禁读取 ../feishu-cli-platform/references/workflows/auth/references/agent-contract.md。

Comments

Markdown supported

Details

Author: riba2534
Repository: riba2534/feishu-cli
Category: Documents
Installs: 167
GitHub stars: 1,433

Report

More skills

All skills

handoff

github.com/mattpocock

1.1M

Compact the current conversation into a handoff document for another agent to pick up

lark-doc

open.feishu.cn

823.9k

Operate on Feishu cloud documents (Docx / Wiki): read, create, and edit documents; insert or download image attachments; and work with mind notes. Use when the user provides a document URL/token (including /docx/ or /wiki/ on doubao.com); route by URL path/token rather than domain. `/page/<token>` is a Miaoda app, not a Feishu cloud document. Route embedded document resources according to the unified rules in the reading reference. Use lark-drive for standalone comment operations; use docs +fetch to read comments alongside the main text. Operations on spreadsheet or Base internal data are outside this skill.

lark-drive

open.feishu.cn

823.2k

Feishu cloud storage (Drive): manage Drive files and folders, including uploads/downloads, folder creation, copying/moving/deleting, viewing metadata, checking permission settings, comments/permissions/subscriptions, titles, versions, Feishu document security labels (secure labels), and local file imports. Use when users need to organize Drive folders, handle cloud storage resource URLs/tokens, identify link types/actual tokens/titles, or import Word/Markdown/Excel/CSV/PPTX/.base as docx/sheet/bitable/slides. Route doubao.com cloud storage URLs/tokens by resource path and token too; do not fall back to WebFetch. Not responsible for: editing document content (use lark-doc), spreadsheet/Base table data operations (use lark-sheets/lark-base), knowledge space node/member management (use lark-wiki), or native Markdown file read/write/patch/diff (use lark-markdown).

lark-sheets

open.feishu.cn

821.8k

Feishu Spreadsheets: create and operate spreadsheets. Supports worksheets and row/column structures (add/delete/merge/size/hide/freeze/group), cell read/write (values/formulas/styles/comments/cell images), range copy/move/sort/fill, find and replace, bulk updates, and creating and maintaining objects such as charts, pivot tables, conditional formatting, filters and filter views, dropdown lists, sparklines, and floating images. Also supports formula validation, restoring historical versions, and importing/exporting local Excel/CSV files and Feishu spreadsheets. Use when users need to create or edit spreadsheets, summarize and visualize data, format spreadsheets, calculate formulas (including migrating Excel formulas), or build financial models (DCF, three statements, budgets, Sensitivity, etc.). For multidimensional tables (Base/bitable), use lark-base. If users want to search for spreadsheet files in cloud storage (Drive/cloud storage) by name or keyword, use lark-drive's drive +search to locate resources first. When users provide a doubao.com /sheets/ URL/token, use this skill directly; do not fall back to WebFetch because the domain is not Feishu. Routing is based on the URL path pattern and token, not the domain.