lark-doc

⚠️ API 版本：本 skill 使用 v2 API。所有 docs +create 、 docs +fetch 、 docs +update 命令必须携带 --api-version v2 。 CRITICAL — 执行对应操作前，MUST 先用 Read 工具读取以下文件，缺一不可： 未读完以上文件就执行相应操作会导致参数选择错误、格式错误或样式不达标。 格式选择规则（全局）： 补充： 云空间资源发现统一走 drive +search ；当用户口头说"表格/报表/最近我编辑过的 xxx"时，也优先从 drive +search 开始。老的 docs +search 只在沿用 --filter JSON 的存量脚本里保留，后续会下线。 Shortcut 是对常用操作的高级封装（ lark-cli docs + [flags] ）。有 Shortcut 的操作优先使用。 - ../lark-shared/SKILL.md — 认证、权限处理、全局参数（所有操作通用） - 读取文档（ docs +fetch ） → 必读 lark-doc-fetch.md （ --scope / --detail 选择、局部读取策略、 / 输出结构） - 创建或编辑文档内容 → 必读 lark-doc-xml.md （XML 语法规则，仅当用户明确要求 Markdown 时改读 lark-doc-md.md ）；从零创建时加读 lark-doc-create-workflow.md ；编辑已有文档时加读 lark-doc-update-workflow.md - 创建 / 导入场景 （ docs +create ，或 docs +update --command append/overwrite 的整段写入）：XML 和 Markdown 都可以。用户提供 .md 本地文件、或明确说"导入 Markdown"时，直接用 Markdown；否则默认 XML（可用 callout、grid、checkbox 等富 block）。 - 精准编辑场景 （ docs +update 的 str_replace / block_insert_after / block_replace / block_delete / block_move_after 等局部精修指令）：优先使用 XML（ --doc-format xml ，即默认值）。XML 能稳定表达 block 结构和样式，局部精修更可控；不要因为 Markdown 更简单就自行切换。 - 用户需要在文档内 创建、复制或移动 资源块（画板、电子表格、多维表格等）时，必须先读取 lark-doc-xml.md 的「三、资源块」章节 - 用户说"看一下文档里的图片/附件/素材""预览素材" → 用 lark-cli docs +media-preview - 用户明确说"下载素材" → 用 lark-cli docs +media-download - 如果目标是画板/whiteboard/画板缩略图 → 只能用 lark-cli docs +media-download --type whiteboard （不要用 +media-preview ） -...