Infographic PowerPoint Deck

Quick start (default: images-only deck, style-pack architecture)

1. Pick one style pack folder (required) from references/style-pack-catalog.md.
   • If user does not specify style, default to editorial-light.
2. Compose the style block bundle:
   • Run scripts/compose_style_pack_blocks.py --pack-id <id> (or manually read the style-pack files).
   • This yields a consistent block set: profile + motif + consistency + scene bias.
3. Draft a slide list (8–20 slides): title, quote(s), key points, scene ID.
   • Scene IDs come from references/scene-catalog.md.
   • If you need fast defaults, reuse presets from references/scene-preset-library.md.
   • If you already have a reasoning artifact (recommended): convert slide_extraction.md rows into slides.
   • If slide_extraction.md already includes Recommended style pack ID / Scene ID / Layout hint, use those fields directly.
4. For each slide, fill references/prompt_template.md:
   • Paste the composed style block bundle.
   • Paste exact required text (verbatim).
   • Add slide-specific scene layer details and icons.
5. Generate each slide as one 16:9 image.
   • In the slide prompt text, explicitly include a ratio lock sentence (e.g., 画布比例硬约束：16:9 横版（宽屏），禁止方图。).
   • In the tool call, explicitly set ratio config when supported (e.g., generation_config with aspect_ratio: "16:9").
6. QA readability + text accuracy; regenerate only failed slides.
   • If any slide is not 16:9 or has text defects, regenerate the image directly.
   • Do not crop, pad, resize, or post-process generated images unless the user explicitly asks.
7. Assemble images-only PPTX with scripts/build_images_only_pptx.py.

Outputs to produce in the user’s workspace:

• slides_plan.md (slide-by-slide content + visuals)
• prompts.md (the exact prompts used for each slide)
• slides/slide01.png ... (final 16:9 images)
• deck_images_only.pptx (concatenated images)

Recommended upstream artifact (thinking before slides)

For higher-quality decks, start from a logically structured article + extraction table:

• Use the deep-research-article skill to produce article.md and slide_extraction.md.
• Prefer the deep-research handoff-contract columns (style pack ID, scene ID, layout hint, text budget) so each row maps directly to one slide prompt.
• If the extraction table is legacy/simple format, normalize it using references/deep_research_handoff_mapping.md before prompt writing.

Prompt stack (minimal vs full)

• Minimal stack (recommended for most decks):
  • references/style-pack-catalog.md (choose pack ID)
  • references/style-pack-system.md (load order + composition rules)
  • references/style-packs/<pack-id>/ (pack-local blocks)
  • references/typography_spacing_lock.md
  • references/text_fidelity_block.md
  • references/negative_prompt_block.md
• Full stack (use when you want maximum narrative + visual control):
  • Minimal stack +
  • references/storyboard_library.md
  • references/shot_mood_library.md
  • references/scene-catalog.md
  • references/scene_library.md
  • references/layout_library.md
  • references/chinese_quote_compression.md (when quotes are long)

Style-pack system (modular and scalable)

Use folderized style packs so each style is self-contained:

• Each style pack lives in references/style-packs/<pack-id>/.
• Each pack has its own manifest.toml and block files that define the look.
• Packs can inherit from base-core to reuse shared constraints.
• Prompts are composed as: base-core + chosen pack + slide-specific content.
• This avoids cross-file mismatch and makes new style creation deterministic.

Note: despite the Bible-themed examples, this workflow works for any topic. Swap scenes/props in references/scene_library.md to match your domain (product, research, training, etc.).

Slide prompt recipe (copy/paste template)

Read references/prompt_template.md and fill it per slide. Keep it extremely explicit:

• Put all required on-slide text under a “必须出现文字（逐字准确）” section.
• For visuals, describe scene layers (far/mid/foreground), plus 3–8 concrete objects.
• Specify what must be subtle/low-contrast so text stays readable.

If you need inspiration for “更有画面感”的场景素材与道具库, read references/scene_library.md. If you need stable scene IDs + tags for selection/filtering, read references/scene-catalog.md. If you need copy-ready visual scene blocks, read references/scene-preset-library.md. If you need fast, reliable infographic compositions, read references/layout_library.md. If you need “镜头语言/时间天气/光影情绪” presets, read references/shot_mood_library.md. If you need style modularity, read references/style-pack-system.md and use scripts/compose_style_pack_blocks.py. If you want fewer typos and more readability, paste these into every slide prompt: references/typography_spacing_lock.md, references/text_fidelity_block.md, references/negative_prompt_block.md. If you want “像分镜一样”的观看节奏，read references/storyboard_library.md. If you have long verse blocks, read references/chinese_quote_compression.md and split quotes across slides (do not paraphrase).

Quality bar (and how to iterate)

For each slide:

• Readability first: text never overlaps busy imagery; use a dedicated text panel.
• No hallucinated text: forbid extra words/logos/watermarks.
• Chinese accuracy: if any characters are wrong, regenerate that slide with:
  • shorter quote blocks,
  • “逐字准确，不得改写，不得增删标点/空格”,
  • simpler backgrounds.
• Engagement: add background scenes + textures + icon clusters, but keep them low-contrast.

Common failure fixes:

• Tool call fails/intermittent errors: retry after a short wait; keep prompt stable; reduce scene complexity only if repeats.
• Text too small: reduce bullet count; split into two slides; demand “大字号、舒适行距”.
• Too busy: force “背景低对比、仅右侧画面、左侧纯净面板”.
• Deck too dark: switch to editorial-light or airy-relaxed, disable vignette, force daylight scene IDs, and add brightness override.
• Ratio mismatch: regenerate that slide with stricter 16:9 constraint in prompt; do not crop or otherwise post-process.
  • Ensure both prompt text and tool-call config specify 16:9 in the same retry.

Operating mode (be patient; avoid “probe images”)

• Image generation can be slow. Prefer generating the real slides directly.
• Avoid generating test/probe images (e.g. blank backgrounds) unless the user explicitly asks for diagnostics.
• If an image call fails intermittently, retry the same slide prompt after a brief pause; do not change multiple variables at once.
• Default delivery mode is raw outputs: keep generated images as-is and assemble the PPT directly from them.

Tooling constraints (important)

Some image tools only allow writing output images to specific directories (often ~/Downloads or a workspace path). When blocked:

1. Generate images into an allowed directory (e.g. ~/Downloads/<deck_id>/).
2. Copy images into the project/workspace output folder.

Bundled scripts

scripts/compose_style_pack_blocks.py

• Compose inherited style-pack blocks into one paste-ready bundle.
• Use before prompt writing to prevent style mismatch.

Run:

python3 scripts/compose_style_pack_blocks.py --pack-id editorial-light

scripts/create_style_pack.py

• Scaffold a new style pack folder with manifest + block templates.
• Use when existing packs are not enough and you need fast extension.

Run:

python3 scripts/create_style_pack.py --pack-id warm-minimal --display-name "Warm Minimal" --keywords "温暖,平衡" --scene-tags "warm,clean"

scripts/build_images_only_pptx.py

• Assemble an images-only PPTX by concatenating slide*.png full-screen in filename order.
• Use when the user wants “PPT = concatenated images”, with no PPT text boxes.

Dependencies (install if missing):

python3 -m pip install python-pptx

Run:

python3 scripts/build_images_only_pptx.py --images-dir /path/to/slides --out /path/to/deck.pptx

References

• Read references/prompt_template.md when you need a high-detail prompt skeleton that produces the “rich background infographic” style reliably.
• Read references/style-pack-system.md for composition rules and how to add new style packs.
• Read references/style-pack-catalog.md for intent-to-style routing and pack selection.
• Read references/style-packs/ for self-contained style definitions.
• Read references/style_profile_library.md for legacy style aliases (backward compatibility).
• Read references/deep_research_handoff_mapping.md to normalize upstream slide_extraction.md fields from deep-research-article.
• Read references/scene-catalog.md for reusable scene IDs and tags.
• Read references/scene-preset-library.md for ready-to-paste scene visual blocks.
• Read references/scene-entry-template.md when adding new scene IDs to the catalog.
• Read references/scene_library.md to quickly add “场景化/电影感” elements (locations + props) without making the slide messy.
• Read references/layout_library.md to choose a layout that matches your text density (so slides stay readable).
• Read references/shot_mood_library.md for cinematic shot + lighting + time-of-day presets.
• Read references/motif_pack.md to make the whole deck feel like a single cohesive series.
• Read references/deck_consistency_block.md to lock margins/light direction/texture/icon style across the whole deck.
• Read references/typography_spacing_lock.md to prevent tiny text and keep spacing consistent.
• Read references/text_fidelity_block.md to reduce Chinese typos and forbid any extra words.
• Read references/negative_prompt_block.md to avoid common generator artifacts (watermarks/English/UI).
• Read references/storyboard_library.md to give the whole deck a narrative arc.
• Read references/chinese_quote_compression.md to split long quotes without paraphrasing (keeps fonts large).