lark-slides

SKILL.md

slides (v1)

Quick Reference

用户需求
优先动作
关键文档 / 命令

新建 PPT
先规划 slide_plan.json，再按复杂度选择一步或两步创建
planning-layer.md、visual-planning.md、asset-planning.md、slides +create

大幅改写页面
先回读现有 XML，写入新 plan，再替换或重建相关页面
xml_presentations.get、+replace-slide、lark-slides-edit-workflows.md

编辑单个标题、文本块、图片或局部元素
优先块级替换/插入，不改页序
slides +replace-slide、lark-slides-replace-slide.md

读取或分析已有 PPT
解析 slides/wiki token，回读全文或单页 XML，保存 xml_presentation_id、slide_id、revision_id
xml_presentations.get、xml_presentation.slide.get

上传或使用图片
先上传为 file_token，禁止直接写 http(s) 外链
slides +media-upload，或 +create --slides 的 @./path 占位符

用户提到模板、主题、版式
先检索模板，再摘要，必要时裁切骨架
template_tool.py search → summarize → extract

创建失败、空白页、3350001、布局异常
先回读状态，再按排障清单修复，不假设原操作原子成功
troubleshooting.md、validation-checklist.md

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理

CRITICAL — 生成任何 XML 之前，MUST 先用 Read 工具读取 xml-schema-quick-ref.md，禁止凭记忆猜测 XML 结构。

CRITICAL — 新建演示文稿或大幅改写页面时，MUST 先生成 .lark-slides/plan/<deck-or-task-id>/slide_plan.json，再生成 XML。先创建对应目录，规划层规则和中间产物生命周期见 planning-layer.md。仅替换一个标题、插入一个块等小型已有页编辑可豁免。