OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add riba2534/feishu-cli --skill feishu-cli-write
向飞书文档写入内容、创建新文档、新建空白文档。支持 doc import 从 Markdown 创建、 doc content-update 精准追加/覆盖/替换/插入/删除，doc add/update/delete 低层块操作， 以及图片/文件插入。当用户请求创建文档、写文档、更新文档、替换章节、插入章节、 删除章节、追加内容、覆盖文档、插入图片或文件时使用。
npx skills add riba2534/feishu-cli --skill feishu-cli-write
本技能负责创建和编辑飞书 docx。Markdown 文件导入创建文档也可直接用 feishu-cli-import；只读/导出走 feishu-cli-read / feishu-cli-export。
创建后如需交付给用户，先解析 owner：
FEISHU_OWNER_EMAIL，其次读取 ~/.feishu-cli/config.yaml 的 owner_email。full_access：
FEISHU_TRANSFER_OWNERSHIP=true 或配置 transfer_ownership: true 时转移所有权：
FEISHU_OWNER_EMAIL。写入临时 Markdown 后先做编码检查：
doc import 已在 CLI 内校验非法 UTF-8 和 U+FFFD，但生成阶段仍建议先检查，避免把乱码写入云文档。
不要把 doc import --document-id 当成更新命令；它会把 Markdown 转成新块追加到文档末尾。已有文档编辑优先用 doc content-update。
| 用户意图 | 推荐模式 |
|---|---|
| 在末尾新增内容 | append |
| 完全重写文档 | overwrite |
| 替换某个章节 | replace_range |
| 全文查找替换 | replace_all |
| 在某个章节前/后插入 | insert_before / insert_after |
| 删除某个章节 | delete_range |
常用示例：
关键规则：用户说“修改/替换/更新某段”时用 replace_range 或 replace_all，不要 append 导致重复。
--table-column-width（content-update / add 通用，默认 auto）：auto 按内容启发式 | fixed 固定宽度 | N1,N2,... 像素列表（* 表示该列走 auto）。仅 Markdown 内容类型生效；也可在表格上方写注释 <!-- feishu-colwidth: 80,200,*,30% --> 覆盖（注释优先级高于 flag）。
doc import 默认上传图片；doc add / content-update 使用 --upload-images 上传 Markdown 中的本地/网络图片并回填 Image Block。
单独插入图片或文件用 doc media-insert：
低层 JSON 需要熟悉飞书 Block 结构；普通章节编辑优先用 content-update。
doc add-board 添加画板块向文档插入一个空画板块（block_type=43），返回 block_id 和 whiteboard_id，后续可用 feishu-cli board 系列命令操作画板内容。
| flag | 说明 | 默认 |
|---|---|---|
--parent-id | 父块 ID | 空（文档根节点） |
--index | 插入位置索引 | -1（末尾） |
--output, -o | 输出格式 (json) | 文本 |
doc add-callout 添加高亮块向文档插入一个 Callout 高亮块（block_type=19），并自动写入文本内容（API 会自动生成空子块，CLI 已处理为直接更新而非额外创建）。
--callout-type | 背景色 | 视觉含义 |
|---|---|---|
info（默认） | 蓝色（6） | 信息提示，灯泡图标 |
warning | 黄色（4） | 警告提示 |
error | 红色（2） | 错误提示 |
success | 绿色（5） | 成功提示 |
注：CLI 当前仅暴露 4 种 type；如需 CAUTION（橙=3）/IMPORTANT（紫=7）等其他 6 色 Callout，请用 Markdown
<callout type="CAUTION">...</callout>走doc import/content-update。
| flag | 说明 | 默认 |
|---|---|---|
--callout-type | 类型 (info/warning/error/success) | info |
--icon | 自定义图标（emoji shortcode，如 bulb fire） | 空 |
--parent-id | 父块 ID | 空（文档根节点） |
--index | 插入位置索引 | -1（末尾） |
--output, -o | 输出格式 (json) | 文本 |
Markdown 表格导入 docx 时：
insert_table_row 追加到同一 block。feishu-cli sheet import-md report.md --title "报表"。文档内已有表格结构操作：
doc import / content-update 支持常见 Markdown，以及导出端生成的 HTML 扩展标签：
Mermaid / PlantUML 会在导入时转为飞书画板；语法限制参考 ../feishu-cli-import/references/doc-guide.md。
overwrite。