guizang-ppt-skill

环境要求

• 支持 Skill 的 AI Agent 环境（Claude Code / Codex 等）
• Agent 需具备 shell 权限，能执行安装与克隆命令
• 本地已安装 Node.js / npx（用于一行命令安装方式）
• 浏览器（用于打开生成的单文件 HTML 预览与演讲者模式）

安装与启动步骤

1. 1一行命令安装技能

   推荐方式。在终端执行该命令，通过 npx skills 把 guizang-ppt-skill 安装到你的 Agent 技能目录，无需手动下载。

   npx skills add https://github.com/op7418/guizang-ppt-skill --skill guizang-ppt-skill

   复制

2. 2或手动克隆安装

   没有 npx 时，可让有 shell 权限的 Agent 把仓库克隆到 ~/.claude/skills/guizang-ppt-skill 目录完成安装。

   git clone https://github.com/op7418/guizang-ppt-skill ~/.claude/skills/guizang-ppt-skill

   复制

3. 3检查安装文件

   安装完成后确认 SKILL.md、assets/、references/ 三类文件是否存在于技能目录中，缺失说明安装不完整。

   ls ~/.claude/skills/guizang-ppt-skill

   复制

4. 4向 Agent 提出需求

   安装后直接对 Agent 描述任务，例如指定风格、页数、配图数量；也可用 README 中的示例请求句式。

5. 5按工作流生成 PPT

   Agent 会引导选择 Style A 杂志风或 Style B 瑞士风、澄清需求、拷贝 template.html 或 template-swiss.html 并填充内容。

6. 6浏览器预览与排练

   生成后直接用浏览器打开 HTML 文件；按右下角 P 键进入演讲者模式，检查观众屏同步并记录实际时长。

7. 7更新到最新版

   已安装过时，进入技能目录执行 git pull 拉取最新代码，然后让 Agent 告知当前最新 commit。

   cd ~/.claude/skills/guizang-ppt-skill && git pull

   复制

如何确认成功

安装后确认 SKILL.md、assets/、references/ 均存在；生成后用浏览器打开 HTML，按右下角 P 能进入演讲者模式即成功。

常见问题

注意事项

• README 未提供 Web 服务端口、Docker 镜像或环境变量配置，本项目本质是 Agent 技能，不需要部署服务。
• 这是单文件 HTML 横向翻页 PPT，生成的成果直接用浏览器打开即可，无需构建工具。
• 演讲备注由 Agent 从大纲提取，用户未提供的信息不会猜测，排练时需自行记录实际时长用于迭代。
• 迭代时可根据排练结果调整内容、字号、高度和间距，并重新跑对应校验器。