OfficeCLI Morph-PPT 技能
为 AI 代理打造的 PowerPoint 平滑过渡(Morph)动画技能,可生成具有跨幻灯片连续运动的 .pptx 文件。
证据显示:skill明确要求用户确认的流程缺失,但命令执行在本地生成pptx文件,无外发数据。提供安装脚本但未审计其安全性,依赖外部服务(d.officecli.ai)可能不可信。存在少量文件操作(如clean-accumulation会删除形状),但显式要求用户意图。未看到用户确认或数据流透明性说明。扣分原因:安装脚本来源未验证,依赖未固定版本,未明确数据处置和回滚方案。
证据显示:提供了详细的help-first规则和验证命令,但未提供测试用例或CI。脚本中Python和Shell实现存在差异,可能不一致。错误处理有检查但部分依赖外部命令返回值,未完全覆盖。扣分原因:无自动化测试,关键路径未复现,错误反馈部分依赖用户自查。
证据显示:明确声明了触发条件(morph, smooth transition等)和不适用的场景(如普通deck)。提供了详细的使用场景和边界。环境适配:强调支持中文,但未提及大陆网络访问受限问题。扣分原因:未提供大陆网络可达性的明确说明,但核心功能不依赖海外服务。
证据显示:文档结构清晰,有分层说明(SKILL.md, reference文件)。提供了安装和依赖提示。命名规范(三前缀系统)明确。已知限制(如渲染器兼容性)已披露。许可证为Apache-2.0。扣分原因:未提供版本号或更新日志,维护责任未明确。
证据显示:提供了多个具体配方和完整示例,输出为pptx文件,预期可直接使用。但无执行验证,无法确认结果正确性。扣分原因:无实际运行证据,输出正确性未验证。
证据显示:提供了命令示例和验证grep,但无测试套件或第三方验证。依赖外部CLI,未提供可复现的测试。扣分原因:无独立证据,仅文档断言。
- 安装脚本来自外部域名(d.officecli.ai),请在使用前审计其安全性
- 未提供自动化测试,建议在实际使用前进行小规模试点验证
- 渲染效果依赖PowerPoint 365/Keynote/WPS,LibreOffice和部分Web查看器仅显示淡入淡出
- 文档提到的一些功能(如morph-helpers.sh)在Python版本中可能不一致,建议以官方帮助为准
这个 Skill 能做什么,适合哪些场景?
此技能是 OfficeCLI 工具集中专门用于创建 PowerPoint 演示文稿的专业技能,重点实现 Morph 过渡效果——即形状在幻灯片之间平滑移动、缩放、旋转的连续动画。它建立在 OfficeCLI 的 pptx 基础技能之上,继承了其所有硬性设计规则,并新增了跨幻灯片形状命名绑定、场景演员(Scene Actor)与内容前缀、幽灵定位(ghost positioning)以及专门的验证门禁。该技能通过命令行接口驱动 OfficeCLI 二进制文件,无需安装 Microsoft Office。它适用于需要 Keynote 风格连续动画的演示文稿,但不适用于普通演示文稿或 pitch deck。
该技能指导 AI 代理使用 officecli 命令行工具创建带 Morph 过渡的 .pptx 文件。具体操作包括:添加幻灯片并设置 transition=morph 属性;通过 shape 命令添加和定位形状,并使用 !! 或 # 前缀命名以实现跨幻灯片配对;将形状移出画布(例如 x=36cm)来实现退出动画;使用 batch 命令批量处理多个操作;运行验证检查(如 officecli validate)和 HTML 预览(officecli view <file> html)来审核交付质量。它还包含辅助脚本(reference/morph-helpers.py 和 .sh)用于克隆幻灯片、清理幽灵形状和最终检查。技能会生成单个 .pptx 文件作为输出。
- 演示文稿设计师需要创建具有连续视觉动效的幻灯片组,例如一个标题从中心移动到角落并缩小,让新内容占据中心舞台。
- 业务分析师需要制作 8-10 页的密集演示文稿,在关键部分使用 3-5 个 Morph 过渡,以强调叙事节奏。
- 产品经理需要构建 18 页以上的三幕式叙事,在幕间使用较长的 Morph 过渡,并在各幕内部使用较安静的过渡。
- 教育工作者希望创建逐步展示概念演变的幻灯片,例如图表中的条形逐渐增长(通过手动构建的 actor 矩形实现)。
- 开发者希望自动化生成具有视觉吸引力的 PowerPoint,无需安装 Office,可在 CI/CD 或 Docker 环境中运行。
这个 Skill 有哪些优点和局限?
- 无需安装 Microsoft Office;纯命令行驱动,非常适合 AI 代理自动化。
- 提供详细的命名约定和规划模板,帮助避免常见的 Morph 动画失败模式。
- 包含强制性的交付门禁(Gate 1-5b),确保生成的演示文稿符合视觉和结构质量标准。
- 提供多种现成的配方(recipes)和辅助脚本,简化了常见模式(如多幻灯片动画)的构建过程。
- 附带 52 种视觉风格库,可提供设计灵感,同时避免复制僵硬的坐标。
- Morph 过渡仅在 PowerPoint 365、Keynote 和 WPS 中渲染;LibreOffice 和许多 Web 查看器会降级为淡入淡出效果。
- 该技能假定读者已熟悉 pptx 基础技能;如果未先阅读,可能会遗漏关键规则。
- 潜在的幻影(ghost)累积问题要求严格维护每个幻灯片上的形状;如果管理不善,可能会导致输出混乱。
- 没有提供内置的测试套件;验证依赖 manual/scripted 门禁,这些门禁可能无法捕获所有视觉问题。
- 该技能针对演示文稿创建进行了优化;如果用户需要静态演示文稿,它不会自动回退到基础技能,需要用户明确选择。
如何安装这个 Skill?
首先安装 OfficeCLI 二进制文件。对于 macOS/Linux,运行 curl -fsSL https://d.officecli.ai/install.sh | bash;对于 Windows PowerShell,运行 irm https://d.officecli.ai/install.ps1 | iex。然后验证安装:officecli --version。此技能是 OfficeCLI 仓库的一部分,并以 skills/morph-ppt/SKILL.md 的形式提供。要使用它,请将 SKILL.md 文件放入符合 Agent Skills 标准的技能目录中,例如 ~/.claude/skills/morph-ppt/SKILL.md(对于 Claude Code)。确保 officecli 在 PATH 中,且 jq 可用于 JSON 处理。
如何使用这个 Skill?
当用户要求使用 Morph 过渡或连续动画时,通过自然语言描述触发此技能,例如“创建一个包含平滑跨幻灯片动画的演示文稿”。按照技能指示,在编码前先规划 Morph 对(在 brief.md 中),然后使用 officecli 命令构建幻灯片。示例:创建演示文稿:FILE="deck.pptx"; officecli create "$FILE";添加带 Morph 的幻灯片:officecli add "$FILE" / --type slide --prop transition=morph;添加形状并命名:officecli add "$FILE" "/slide[2]" --type shape --prop 'name=!!actor-ring' ...。在每张幻灯片后,酌情将旧内容重影到 x=36cm。最后运行 officecli validate "$FILE" 并打开 HTML 预览进行视觉审核。
这个 Skill 与同类方案有什么区别?
与 python-pptx 等其他库相比,OfficeCLI 提供单一命令界面,无需编写代码,并且内置渲染引擎支持视觉反馈。与 Microsoft PowerPoint 本身的 Morph 功能相比,该技能通过形状命名规则和验证门禁,使 AI 代理能够可靠地实现 Morph 效果。