用途:把一份 Markdown 大纲或 slides_plan.json 配合一种视觉风格,通过 OpenAI Images API(gpt-image-2)逐页生成幻灯片图片,并打包为 16:9 的 .pptx。支持指定内置风格(如 gradient-glass、clean-tech-blue、dark-aurora、swiss-grid、hand-sketch 等,按 initial、featured、xiamulingzi 分组存放于 styles/ 下),也支持模板克隆模式:传入 .pptx 模板后所有页面仿照该模板,--template-strict 会把对应模板页作为图片参考喂给模型以提高仿真度。
主要能力:内置风格采用 MD 与同名 .layouts.json 配对结构,运行时分配不同 layout;提供 examples/ 场景起步模板(产品发布、融资路演、周报、课程课件、论文答辩、读书分享等),仅在用户需求模糊时作结构参考,不得直接沿用其中的虚构内容。模板渲染由 render_template.py 完成,模板克隆前须先用 python3 scripts/render_template.py --check 确认本机有可执行的渲染后端(Windows PowerPoint COM、macOS Keynote、或 LibreOffice/soffice),缺失时需安装 LibreOffice 或由用户导出页面 PNG 后经 --template-images 传入。
使用方式:克隆仓库后执行 bash install_as_skill.sh --target claude 或 --target codex;API 直连需配置 OPENAI_BASE_URL、OPENAI_API_KEY、GPT_IMAGE_MODEL_NAME、GPT_IMAGE_QUALITY。常规流程为先写 slides_plan.md,与用户确认后用 python3 scripts/md_to_plan.py 转 JSON,再运行 python3 scripts/generate_ppt.py --plan slides_plan.json --style styles/<collection>/<id>.md 出图打包;模板克隆加 --template-pptx 和可选 --template-strict。若调用方本身就是 Codex 且带 image_generation 工具,可用 --prepare-only 生成 prompts.json 后由 agent 自行出图,再复用打包逻辑。
适用场景与限制:适合演示文稿、路演、汇报、课程课件等页面生成。模板渲染依赖本机后端,特殊环境可能不可用;外部真实图片需作为独立 picture object 叠加,不能用简易整页 PNG 打包,否则无法在 PowerPoint 中单独选中。密钥不应写入业务项目 .env,具体计费与价格资料暂未提供。