Lisa 的 PPT 技能
Lisa 的 PPT 是一个路由驱动的演示文稿工作流程。本入口仅负责全局执行纪律和路线选择;每条选定的路线拥有其自身的流程。
强制加载顺序
硬性规则 — 路径优先于命令:保留宿主提供的包含本文件的绝对目录 SKILL_DIR。每次工具调用时,展开 ${SKILL_DIR} 并将任何 skills/lisa-ppt/ 前缀替换为它。切勿使用 cd、当前工作目录(CWD)或假定仓库检出。如果不可用,请询问用户;不要搜索或猜测。
- 读取本文件。
- 每个会话运行一次
python3 "${SKILL_DIR}/scripts/preflight.py"。如果结果为FAIL(缺少核心依赖、过时的 Codex 桩代码),请在继续之前修复;警告仅降低可选表面。 - 通过具体绝对路径
${SKILL_DIR}/workflows/routing.md读取workflows/routing.md。 - 从路由权威中选择恰好一个顶层路线及其激活配置文件。
- 仅读取生成的运行时权威及其显式触发的支持文档。
| 选定路线/配置文件 | 运行时权威 |
|---|---|
| 生成 PPTX — 图片转 PPTX | workflows/profiles/image-to-pptx.md;Codex 支持,始终为快速(Quick) |
| 生成 PPTX — 美化 | workflows/profiles/beautify-pptx.md;显式快速意图选择快速,否则为默认(Default) |
| 生成 PPTX — 普通默认 | workflows/generate-pptx.md |
| 生成 PPTX — 普通显式快速 | workflows/profiles/quick-generate.md |
生成 PPTX — Hi Ted, Meet Lisa HTML 演讲者文稿 (/lisa-ppt <deck>.html) | workflows/lisa-deck.md;其摄入取代第 1-2 步,然后选定的生成权威从第 3 步继续 |
| 创建模板 | workflows/create-template.md |
| 编辑原生 PPTX | workflows/edit-native-pptx.md |
硬性规则 — 仅选定的权威:路由后不要加载其他顶层路线的流程。图片转 PPTX 和美化为互斥关系;图片转 PPTX 激活快速,而美化从显式快速意图中选择。切勿同时加载两个运行时。支持文档细化一条路线;它们从不与路线竞争。
创作表达范围
参考 — 非约束条件:生成的页面可以携带的内容。文本 — 内联强调文本、导语、引人注目的引言、英雄数字、要点行。几何 — 187 种 Office 预设、布尔合并、连接符、自由曲线、页面字段和轮廓载体组合。图像 — 全出血字段、编辑裁剪、形状图片、注册图层、遮罩和聚光灯、跨页连续性。绘制 — 渐变、通道 alpha、原生阴影和发光、半色调、分面形式。重复 — 一个跨页主题根据页面角色变化。每个形式的语法位于选定运行时权威的构建参考中。
阶段框架
每条路线都是一个计划 → 执行·检查·行动循环:当每个创作输入作为文件或保留决策存在时,计划结束;执行创作页面,检查运行路线的关卡,行动在所属层(纪律 7)修复,循环在导出时结束。步骤编号保持原样。
| 阶段 | 默认 | 快速 | 编辑原生 | 创建模板 |
|---|---|---|---|---|
| 计划 | 第 1-5 步 | §2 | §1-4 | 第 1-3 步 |
| 执行·检查·行动 | 第 6-7 步 | §3-4 | §5-7 | 第 4-8 步 |
全局执行纪律
- 串行执行 — 按顺序遵循选定权威的步骤。已完成的非阻塞步骤可以直接继续到下一个符合条件的步骤。
- 阻塞即停止 — 在每个
⛔ BLOCKING关卡处,等待用户显式确认。不要代表用户做决定。 - 禁止跨阶段打包 — 不要合并跨越未关闭关卡的工作。一旦路线的最终用户关卡关闭,后续非阻塞步骤可以自动继续。
- 进入前检查关卡 — 在进入步骤之前验证所有列出的先决条件。
- 禁止投机执行 — 不要在其所属步骤之前准备后期阶段的工件。
- 确定性路由 — 当
routing.md已解析请求时,不要添加路线选择问题。如果路线先决条件缺失,请说明并停止该路线。 - 在所属层行动 — 失败时,在拥有该故障的最浅层进行修复:页面局部问题在页面修复,清单/规范/资源故障在计划工件修复,工具故障在拥有源工件修复;然后从路线的声明指针处继续。不要静默降级必需的工件。
全局沟通规则
- 除非用户显式覆盖,否则匹配用户的语言和源语言。
- 本地化用户可见的选项标签和解释。在需要精确时保留确切的枚举 ID 或字段名。
- 保持
design_spec.md的章节标题和字段名为模板的原始英文;内容值可以使用用户的语言。 - 在切换角色之前,读取相应的角色参考并输出:
## [角色切换:<角色名称>]
📖 正在读取角色定义:references/<文件名>.md
📋 当前任务:<简要描述>
仓库兼容性
- 本包是一个工作流程/技能,而非通用应用脚手架。默认情况下,不要创建
.worktrees/、tests/、分支工作流程或通用工程结构。 - 将所需的工作流程、参考、脚本和模板文档保留在此技能目录内。
- 仓库级文档可以指向本包;包运行时文件不得依赖于仓库级指令。
- 在 Windows 上,如果文档记录的
python3 ...命令不可用,请使用python重新运行同一命令。