SKILL.md
Markdown 导入技能
从本地 Markdown 文件创建飞书云文档，或把 Markdown 追加导入到已有文档。支持 Mermaid/PlantUML 图表转飞书画板、大表格智能处理（行 > 9 单 block API 追加；列 > 9 拆分保留首列）。
Owner 规则：创建新文档后如需交付给用户，先解析
FEISHU_OWNER_EMAIL或配置文件owner_email。只在解析到 owner 时授予full_access；只在transfer_ownership=true时转移所有权。不要把示例邮箱当成真实接收人。
核心特性
- 三阶段并发管道：顺序创建块 → 并发处理图表/表格 → 失败回退
- Mermaid/PlantUML → 飞书画板：
mermaid/plantuml/puml代码块自动转换为飞书画板 - 图表故障容错：语法错误自动降级为代码块展示，服务端错误自动重试（默认最多 10 次，可用
--diagram-retries调整） - 大表格智能处理：行 > 9 时创建 9 行初始表 +
insert_table_rowAPI 追加到同一 block（视觉连贯，每行约 1 次 API 往返；verbose 模式 ≥ 5 行打印进度）；列 > 9 按列组拆分保留首列作为标识。单元格内容填充已走batch_update批量加速（v1.29+，#159）：阶段二预热cellMap后按批（single-group cell 每批 ≤ 30 个）一次性写入，失败再降级为 per-cell；典型 4×6×8 表从 ~70s 降到 ~3s（25-30x） - 表格列宽：默认按内容启发式（中文 14px / 英文 8px，最小 80px，最大 400px）。可通过紧邻表格上方注释
<!-- feishu-colwidth: 80,200,*,30% -->（单位 px / 百分比 /*走 auto）或 CLI flag--table-column-width=auto|fixed|N1,N2,...全局覆盖；注释优先级高于 flag - API 限流自动重试：画板创建和图表导入遇到 HTTP 429 时自动重试，读取服务端
x-ogw-ratelimit-reset响应头精确计算退避时间，采用指数退避策略，默认最多重试 10 次 - 并发控制：图表和表格分别使用独立的 worker 池（默认图表 5、表格 3 并发）
- 表格单元格图片真嵌入（#164）：Markdown 表格单元格内的本地/网络图片，会在表格填充完成后（阶段 2.5）真正嵌入为单元格内的 Image 子块，而非丢失或退化为文字。细节：纯图片单元格不会把图片说明（alt）串成多余的标题文字；嵌入失败或单元格对不齐的图片计入统计
cell_image_failed并打印，不静默丢弃；上传失败的空图块会被清理并补占位文本。仅doc import走真嵌入，doc add/content-update等非导入场景的单元格图片降级为[图片: 说明]占位文本。JSON 输出新增cell_image_total/success/failed
核心概念
Markdown 导入技能
从本地 Markdown 文件创建飞书云文档，或把 Markdown 追加导入到已有文档。支持 Mermaid/PlantUML 图表转飞书画板、大表格智能处理（行 > 9 单 block API 追加；列 > 9 拆分保留首列）。
Owner 规则：创建新文档后如需交付给用户，先解析
FEISHU_OWNER_EMAIL或配置文件owner_email。只在解析到 owner 时授予full_access；只在transfer_ownership=true时转移所有权。不要把示例邮箱当成真实接收人。
核心特性
- 三阶段并发管道：顺序创建块 → 并发处理图表/表格 → 失败回退
- Mermaid/PlantUML → 飞书画板：
mermaid/plantuml/puml代码块自动转换为飞书画板 - 图表故障容错：语法错误自动降级为代码块展示，服务端错误自动重试（默认最多 10 次，可用
--diagram-retries调整） - 大表格智能处理：行 > 9 时创建 9 行初始表 +
insert_table_rowAPI 追加到同一 block（视觉连贯，每行约 1 次 API 往返；verbose 模式 ≥ 5 行打印进度）；列 > 9 按列组拆分保留首列作为标识。单元格内容填充已走batch_update批量加速（v1.29+，#159）：阶段二预热cellMap后按批（single-group cell 每批 ≤ 30 个）一次性写入，失败再降级为 per-cell；典型 4×6×8 表从 ~70s 降到 ~3s（25-30x） - 表格列宽：默认按内容启发式（中文 14px / 英文 8px，最小 80px，最大 400px）。可通过紧邻表格上方注释
<!-- feishu-colwidth: 80,200,*,30% -->（单位 px / 百分比 /*走 auto）或 CLI flag--table-column-width=auto|fixed|N1,N2,...全局覆盖；注释优先级高于 flag - API 限流自动重试：画板创建和图表导入遇到 HTTP 429 时自动重试，读取服务端
x-ogw-ratelimit-reset响应头精确计算退避时间，采用指数退避策略，默认最多重试 10 次 - 并发控制：图表和表格分别使用独立的 worker 池（默认图表 5、表格 3 并发）
- 表格单元格图片真嵌入（#164）：Markdown 表格单元格内的本地/网络图片，会在表格填充完成后（阶段 2.5）真正嵌入为单元格内的 Image 子块，而非丢失或退化为文字。细节：纯图片单元格不会把图片说明（alt）串成多余的标题文字；嵌入失败或单元格对不齐的图片计入统计
cell_image_failed并打印，不静默丢弃；上传失败的空图块会被清理并补占位文本。仅doc import走真嵌入，doc add/content-update等非导入场景的单元格图片降级为[图片: 说明]占位文本。JSON 输出新增cell_image_total/success/failed