Apple Style PPT Maker
Overview
Drive a deterministic presentation pipeline for Apple-style minimalist decks.
Enforce requirement clarification, strict schema validation, full-plan review, consistent slide rendering, selective page regeneration, and PPTX export.
Workflow
- 0. Check
uv availability. If missing, stop and ask the user to install uv. - Clarify requirements with the user.
- Build and validate
slides_plan.json. - Get user review for the full JSON plan before image generation.
- Generate all slide images at default
2K and webp. - Run result review and regenerate specific pages when requested.
- Export slides to
final.pptx.
Step 0: Verify uv
Run:
CODEBLOCK0
If the command fails:
- - stop the workflow immediately
- ask the user to install INLINECODE6
- continue only after
uv is available
Step 1: Clarify Requirements
Use a friendly, conversational tone.
Do not expose internal schema field names to the user.
Ask in natural language and confirm:
- - this deck's core topic
- target audience and meeting context
- expected speaking duration and target page count
- desired tone and language
- must-keep points and sensitive points to avoid
Follow user input language by default.
Do not generate images before all clarification items are confirmed.
Internal mapping rule (do not show to user):
- - map the confirmed answers to the internal requirement fields used by the JSON plan
Step 2: Build Structured Slide JSON
Create slides_plan.json and validate it against references/slides-schema.json.
Start from references/slides-plan-template.json when you need a fast baseline.
Use references/apple-style-spec.md to keep visual consistency and style quality.
Define both content and visual intent for each page:
- - text payload (
on_slide_text) - visual blueprint (
visual_blueprint) - consistency checks (
consistency_checks)
Step 3: Review Full Plan Before Rendering
Always show the complete slides_plan.json to the user.
Pause until the user approves the full plan.
Apply edits to the JSON plan first, then render images.
Step 4: Generate Slide Images
Run:
CODEBLOCK1
Defaults:
- - resolution: INLINECODE13
- format: INLINECODE14
- aspect ratio: INLINECODE15
- model:
gemini-3-pro-image-preview (Nano Banana Pro path)
Generated files:
- - INLINECODE17
- INLINECODE18
- INLINECODE19
- INLINECODE20
Step 5: Review and Regenerate Specific Page
Run:
CODEBLOCK2
Behavior:
- - Regenerate only the target slide.
- Snapshot prior image, prompt, and metadata to
history/. - Update manifest revision metadata.
Step 6: Export PPTX
Run:
CODEBLOCK3
Environment
Set one of:
- - INLINECODE22
- INLINECODE23
Optional:
- - place
.env in current directory - place
.env in this skill directory
Dependency management:
- - each executable script uses PEP 723 inline metadata
- run scripts with
uv run ... so dependencies bootstrap automatically
Notes
- - Keep style and spacing consistent across all pages.
- Prefer concise, readable text over dense paragraphs.
- Use regeneration instead of re-rendering the entire deck for isolated edits.
Apple 风格 PPT 制作器
概述
驱动一套确定性的演示文稿制作流程,用于生成 Apple 风格极简幻灯片。流程包括:需求澄清、严格模式验证、完整方案审查、一致的幻灯片渲染、选择性页面重新生成以及 PPTX 导出。
工作流程
- 0. 检查 uv 是否可用。若缺失,则停止并请用户安装 uv。
- 与用户澄清需求。
- 构建并验证 slides_plan.json。
- 在生成图片前,请用户审查完整的 JSON 方案。
- 以默认 2K 分辨率和 webp 格式生成所有幻灯片图片。
- 运行结果审查,并根据要求重新生成特定页面。
- 将幻灯片导出为 final.pptx。
第 0 步:验证 uv
运行:
bash
uv --version
如果命令执行失败:
- - 立即停止工作流程
- 请用户安装 uv
- 仅在 uv 可用后继续
第 1 步:澄清需求
使用友好、对话式的语气。
不要向用户暴露内部模式字段名称。
以自然语言提问并确认:
- - 本演示文稿的核心主题
- 目标受众和会议背景
- 预期的演讲时长和目标页数
- 期望的语气和语言
- 必须保留的要点和需要避免的敏感点
默认跟随用户输入的语言。
在所有澄清项确认之前,不要生成图片。
内部映射规则(不向用户展示):
- - 将确认的答案映射到 JSON 方案使用的内部需求字段
第 2 步:构建结构化幻灯片 JSON
创建 slidesplan.json 并对照 references/slides-schema.json 进行验证。
当需要快速基线时,从 references/slides-plan-template.json 开始。
使用 references/apple-style-spec.md 保持视觉一致性和风格质量。
为每个页面定义内容和视觉意图:
- - 文本内容(onslidetext)
- 视觉蓝图(visualblueprint)
- 一致性检查(consistencychecks)
第 3 步:在渲染前审查完整方案
始终向用户展示完整的 slides_plan.json。
暂停直到用户批准完整方案。
先对 JSON 方案进行编辑,然后渲染图片。
第 4 步:生成幻灯片图片
运行:
bash
uv run scripts/generateslides.py --plan slidesplan.json --out outputs/deck_a
默认设置:
- - 分辨率:2K
- 格式:webp
- 宽高比:16:9
- 模型:gemini-3-pro-image-preview(Nano Banana Pro 路径)
生成的文件:
- - images/slide-XX.webp
- prompts/slide-XX.prompt.md
- meta/slide-XX.meta.json
- deck_manifest.json
第 5 步:审查并重新生成特定页面
运行:
bash
uv run scripts/regenerate_slide.py \
--plan slides_plan.json \
--slide 4 \
--change 简化数据叙述并增加留白 \
--out outputs/deck_a
行为:
- - 仅重新生成目标幻灯片。
- 将先前的图片、提示和元数据快照保存到 history/。
- 更新清单修订元数据。
第 6 步:导出 PPTX
运行:
bash
uv run scripts/export_pptx.py \
--images-dir outputs/deck_a/images \
--output-pptx outputs/deck_a/final.pptx
环境
设置以下之一:
- - APPLESTYLEPPTMAKERGEMINIAPIKEY
- GEMINIAPIKEY
可选:
- - 将 .env 放在当前目录
- 将 .env 放在此技能目录
依赖管理:
- - 每个可执行脚本使用 PEP 723 内联元数据
- 使用 uv run ... 运行脚本,依赖项将自动引导
注意事项
- - 保持所有页面的风格和间距一致。
- 优先使用简洁、可读的文本,而非密集的段落。
- 对于孤立的编辑,使用重新生成而非重新渲染整个演示文稿。