用途
SlideJ Template 是一个面向智能体的技能指南，用于为 SlideJ 演示文稿工具创建、设计、提取、更新或复用模板。SlideJ 没有模板命令，也没有内置模板；模板需使用者自行编写，本质是一个 JSON 文件，要求：
- 是一个合法的 SlideJ 演示文稿，可直接通过 slidej generate 原样生成；
- 用可复用样式类（styles）定义设计系统：页面框架、字号层级、卡片、强调色、页脚等；
- 携带风格指南（guide），告诉下一个智能体如何保持风格一致；
- 每种版式原型（封面、章节、内容、卡片等）各含一页示例，使用 flex 布局（slide.layout + box），可复制后填充内容。
生成器会读取 width、height、meta、theme、styles、fonts 和 slides；其余键（name、description、tags、guide、每页的 archetype）会被忽略，因此模板文件本身始终可生成。
主要能力
- 模板文件格式：定义 name、description、tags、guide、尺寸、meta、theme、styles、slides 等结构；guide 需以精确数字（十六进制色值、磅值、英寸、毫秒）写成指令，而非形容词。每页带 archetype 键，示例文字注明其角色与长度上限（如“标题（最多 6 词）”），同时充当文档。元素应命名（如 title、card-2-body）以便查找替换，视觉决策放在 styles 而非内联样式中。
- 创建模板工作流：依次为需求梳理（用途、受众、语气、品牌输入、宽高比、内容语言、所需页面类型）、设计系统（调色板、排版、网格、形状语言、动效）、示例页（核心原型加可选项）、校验、交付。
- 从现有 .pptx 提取模板：用 slidej parse 解析，读取主题、背景、标题位置、字号，挑选各原型最佳示例页，把真实内容替换为角色描述，去掉仅解析器用的字段（如 id、srcBase64），按推导出的网格归一化位置，再据观察结果撰写 guide 并校验。
- 基于模板生成演示文稿：先读完全部 guide，规划每页对应原型，复制 width、height、theme、meta、styles，深拷贝原型页并替换文字与图片，可自由增删卡片、项目符号或列（flex 布局会自动重排），保持类与动画不变。
- 校验：提供 scripts/check-template.js 做静态检查（报告无效颜色、未知类、背景中的主题色引用、无位置的盒子、缺失 styles/guide 段、缺失核心原型，对绝对定位文字估算溢出）；slidej generate 会为未知样式属性、错误值、缺失字体和溢出行打印警告；slidej parse 可选做往返检查。
- 核心原型清单：cover、section、content、cards、metrics、comparison、process、closing；可选：agenda、quote、image-text、chart、team。
使用方式
模板创建：先写 styles 与 guide，再按原型逐页搭建示例（内容页统一使用同一 page 类和相同页头结构，页边距来自 page 类内边距，装饰形状可出血、文字不可）。列布局无需计算：行盒子设 gap，子项设 grow: 1、basis: 0 即得 N 等分列，grow: 2 则占两倍宽；绝对坐标只用于出血装饰。字体不嵌入 .pptx，应优先选演示机已安装字体，并在 theme.majorFont/minorFont 中指定。校验命令：
node <this-skill>/scripts/check-template.js templates/acme-brand.json slidej generate templates/acme-brand.json -o acme-preview.pptx slidej parse acme-preview.pptx --no-images -o acme-roundtrip.json
两项检查均无警告即完成；如装有 LibreOffice 可转 PDF 目视检查。交付时告知文件位置、所含原型及使用命令。
默认保存位置为当前项目的 templates/<name>.json，资源放在 templates/<name>/assets/，以相对 JSON 的路径引用。旧版 SlideJ 读取 ~/.slidej/templates/，现已不再读取。
适用场景与限制
适用于需保持品牌风格的销售演示、季度复盘、课程等场景，以及需要从既有品牌演示文稿提取模板或批量复用模板的场合。限制包括：解析是近似的，SlideJ 无法表达的母版、占位符、SmartArt、图表、视频会丢失，需用形状和组件重建或在 guide.donts 中注明；PPTX 中为绝对定位形状，PowerPoint 的“新建幻灯片”不会套用模板样式，示例页即模板；flex 布局中文字按真实字体度量，字体缺失时只能估算并告警；组件内部比例固定，需为其指定高度或 grow；背景与表格文字色必须是十六进制，主题引用会导致文件无效；一个盒子或它的子项只能择一动画，同一页第一个 afterPrevious 动画会在进入时自动播放。