hands-on-deck
AI代理原生操作PPT的CLI工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：hands-on-deck。 它的用途是：AI代理原生操作PPT的CLI工具 完整的 Skill 内容见：https://321skill.com/skills/hands-on-deck/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'用hands-on-deck修改这个PPT，把第3页的标题从“Q1总结”换成“Q2展望”，然后替换第4页的图片为screenshot.png，并复制第5页的蓝色按钮放到第6页下方。' 它会自动生成一个JSON补丁，执行 `python deck.py deck.pptx apply patch.json -o out.pptx --fix --render img/`，验证所有操作，如果出错会列出具体形状ID和可用布局，一次性修复所有问题。
介绍
hands-on-deck 是一个专为AI代理设计的 PowerPoint 操作工具。它通过一个简单的命令行接口 deck.py，让代理能够像人类一样精准地检查、编辑、创建和验证 .pptx 文件。传统方式中，AI直接编辑PPT内部的XML容易出错且消耗大量Token，而重新生成整个文件则会丢失模板的品牌和布局。hands-on-deck 采用声明式补丁（JSON patch）来指定修改，工具自动执行并验证，确保每次操作安全可靠。
使用方式非常简洁：先用 inspect 命令查看幻灯片内容，然后用 apply 命令应用补丁文件，补丁支持替换文本、设置文本、交换图片、复制形状等操作。所有操作都是原子性的——要么全部成功，要么全部回滚。执行后，内置的linter会检查新产生的几何问题（如文本溢出、形状重叠），并给出精确的修复建议。
这个工具特别适合需要由AI自动批量处理PPT的场景，比如内容创作者批量修改课件讲义、营销团队更新演示素材、文档工程师维护标准模板。由于它被打包为 Anthropic 的 Agent Skill，可以直接在 Claude Code 或 claude.ai 中使用，同时任何能运行Python的代理都能调用它。
建议在使用前先用 python deck.py docs 查看完整命令参考，并准备一个目标PPT作为模板。补丁文件中的操作需要精确指定形状ID，因此建议先用 inspect --brief 获取形状清单。如果遇到复杂动画或图表，这个工具可能无法处理，建议改用专业办公软件。
核心特点
与直接编辑OOXML或重新生成PPT的方案不同，hands-on-deck 采用声明式补丁，原子验证所有操作，错误信息包含精确的形状清单和修复建议，并且内置linter能发现文本溢出、形状重叠等几何问题，而不仅仅是语法错误。
注意事项
不适合处理包含复杂动画、高级图表、协作编辑或需要手动调整元素位置的场景。
常见问题
这个工具支持Keynote或Google Slides吗？
支持，因为Keynote和Google Slides都能导入/导出 .pptx 格式，只要是有效的 .pptx 文件即可。
如何安装和运行？
git clone 仓库后，确保Python环境，直接运行 `python deck.py` 即可。作为Agent Skill，可放入Claude的skills目录。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/hands-on-deck/raw/index.md 读取 hands-on-deck 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/hands-on-deck/raw/index.md（查看排版版本）