lark-slides

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md ，其中包含认证、权限处理 CRITICAL — 生成任何 XML 之前，MUST 先用 Read 工具读取 xml-schema-quick-ref.md ，禁止凭记忆猜测 XML 结构。 CRITICAL — 如果用户提到“模板”“套用模板”“参考某种主题/风格/版式”，或用户需求明显落在已有场景模板内（如工作汇报、产品介绍、商业计划书、培训、晋升汇报等），MUST 先用 scripts/template_tool.py 的 search 做模板检索；默认给出 2-3 个最匹配模板候选供用户选择。锁定模板后用 summarize 获取主题和布局摘要；只有需要布局骨架时才用 extract 裁切目标页型 XML。不要直接读取完整模板 XML。 [!NOTE] scripts/template_tool.py 需要 Python 3。 references/template-index.json 是脚本缓存/轻量路由索引，不是默认给 agent 阅读的文档； assets/templates/*.xml 是机器资源，只应通过脚本摘要或裁切，不要全文读取。 CRITICAL — 使用模板生成或改写页面时，MUST 先 summarize 目标页型；只有需要具体布局骨架时才 extract 。生成本地 XML 后，如可运行 Python，MUST 先用 scripts/layout_lint.py 检查 XML well-formed、重叠/越界/文本高度风险，再创建或追加页面。它不是完整 XSD schema 校验。 编辑已有幻灯片页面 ：优先用 +replace-slide （块级替换/插入，不动页序）；选择 action 和完整读-改-写流程见 lark-slides-edit-workflows.md 。 飞书幻灯片通常是用户自己的内容资源。 默认应优先显式使用 --as user （用户身份）执行 slides 相关操作 ，始终显式指定身份。 执行规则 ： 一条命令创建包含页面内容的 PPT（推荐）： 也可以分两步（先创建空白 PPT，再逐页添加），详见 +create 参考文档 。 [!WARNING] --slides '[...]' 适合简单页面批量创建，但并不等同于“10 页以内都安全”。如果 slide XML 含中文、大段文本、复杂布局、嵌套引号或较多特殊字符，shell 传参时可能出现转义或截断问题，导致内容丢失、页面空白或布局异常。遇到复杂页面时，优先改用“两步创建法”。 [!IMPORTANT] slides +create --slides 底层是“先创建空白 PPT，再逐页调用 xml_presentation.slide.create ”。这不是原子操作；中途某一页失败时，前面已创建成功的页面会保留。skill 必须把这种“部分成功”风险提前告诉用户，并在失败后先记录 xml_presentation_id ，回读确认当前状态，再决定是否在现有 PPT 上继续修复或追加。 以上是最小可用示例。更丰富的页面效果（渐变背景、卡片、图表、表格等），参考下方 Workflow 和 XML 模板。 重要 ：...