lark-slides
SKILL.md
slides (v1)
Quick Reference
| 用户需求 | 优先动作 | 关键文档 / 命令 |
|---|---|---|
| 新建 PPT | 先规划 slide_plan.json，再按复杂度选择一步或两步创建 |
planning-layer.md、visual-planning.md、asset-planning.md、slides +create |
| 已有 PPT 大幅改写 | 多页整页重建用 +replace-pages，单页局部编辑用 +replace-slide |
xml_presentations.get、lark-slides-replace-pages.md、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 |
| 获取幻灯片页面截图 | 用 slide_id 或页号指定页面 |
slides +screenshot、lark-slides-screenshot.md |
| 上传或使用图片 | 先上传为 file_token，禁止直接写 http(s) 外链 |
slides +media-upload，或 +create --slides 的 @./path 占位符 |
| 在 slide 中绘制柱/条/折线/面积/雷达/饼等有数据序列的图表 | 使用原生 <chart> 元素 |
xml-schema-quick-ref.md |
| 在 slide 中绘制流程图、时序图、架构图、散点图、漏斗图或装饰图案 | 必须先用 Read 工具读取参考文档，再生成 <whiteboard> 元素 |
lark-slides-whiteboard.md |
| 使用语义图标 | 先检索 IconPark，再写 <icon iconType="..."> |
iconpark_tool.py search → resolve、iconpark.md |
| 用户提到模板、主题、版式 | 先检索模板，再摘要，必要时裁切骨架 | template_tool.py search → summarize → extract |
| 创建失败、空白页、3350001、布局异常 | 先回读状态，再按排障清单修复，不假设原操作原子成功 | troubleshooting.md、validation-checklist.md |
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，认证、权限和全局参数均以 lark-shared 为准。