fast-ppt-master

name	fast-ppt-master
description	AI-driven SVG-to-PPTX presentation generator. Source → Strategist → Executor → Export. Triggers: "create PPT", "make presentation", "生成PPT", "做PPT".

PPT Master — Fast Edition

Source → Project → Strategist → [Images] → Executor → Export. That's it.

Iron Rules

1. Serial execution — steps run in order, output feeds next step
2. Strategist confirmation is BLOCKING — wait for user approval before generating
3. Spec lock re-read per page — read_file <project>/spec_lock.md before each SVG
4. Hand-written SVG only — no script-generated batch SVG, no sub-agents
5. Sequential pages — one page at a time, no grouping

Pipeline

Step 1: Source Processing

Convert user material to Markdown:

python3 ${SKILL_DIR}/scripts/source_to_md.py <file_or_URL>

CSV/TSV/Markdown → read directly. No source? Ask user for content.

Step 2: Project Init

python3 ${SKILL_DIR}/scripts/project_manager.py init <name> --format ppt169
python3 ${SKILL_DIR}/scripts/project_manager.py import-sources <project> <sources...> --move

Formats: ppt169 (1280x720 default), ppt43 (1024x768), story (1080x1920), banner (1920x1080).

Step 3: Template (Optional)

Default: skip, free design. Only triggered when user provides an explicit template directory path containing design_spec.md.

Step 4: Strategist Phase

Read references/strategist.md
Read templates/design_spec_reference.md

Present to user for confirmation:

1. Canvas format
2. Page count
3. Audience
4. Style / color / typography / icons / images

⛔ BLOCKING — wait for user confirmation.

Output:

• <project>/design_spec.md
• <project>/spec_lock.md

Step 5: Image & Icon Acquisition (Conditional)

Skip if design uses no images and no icons.

Images — backgrounds, illustrations, photos:

Use the agent's native image generation capability (e.g. imagegen skill, DALL-E, or host tool) to generate backgrounds, illustrations, and spot graphics. Save all images to <project>/images/.

Alternatively, if image_gen.py is configured with an API key:

python3 ${SKILL_DIR}/scripts/image_gen.py --manifest <project>/images/image_prompts.json

After all images are ready:

python3 ${SKILL_DIR}/scripts/analyze_images.py <project>/images

Icons — use inline SVG paths directly in the page SVG:

No icon library is bundled. Instead:

• Draw simple icons as inline <path> / <circle> / <rect> elements directly in the SVG
• For complex icons, download from open icon sets (e.g. Lucide, Heroicons, Tabler) via curl/fetch into <project>/icons/, then reference in SVG as <image> or inline the <path d="..."> data

The executor should prefer SVG-native shapes over external icon files whenever possible.

Step 6: Executor Phase

Read references/executor-base.md
Read references/shared-standards.md

1. Output design parameters
2. Generate SVG pages sequentially → <project>/svg_output/
3. Re-read spec_lock.md before each page
4. Quality check:

python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project>

5. Generate speaker notes → <project>/notes/total.md

Step 7: Export

Three commands, run one at a time:

# 7.1 Split notes
python3 ${SKILL_DIR}/scripts/total_md_split.py <project>

# 7.2 SVG finalization (icon embed, image crop, text flatten)
python3 ${SKILL_DIR}/scripts/finalize_svg.py <project>

# 7.3 Export PPTX
python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project>

Output: exports/<name>_<timestamp>.pptx

Few-Shot SVG References

Before generating SVG pages, read 1–2 relevant examples from references/few-shot/:

File	Page Type
cover_minimalist.svg	Clean cover (Swiss grid)
cover_academic.svg	Academic paper cover
content_grid.svg	Multi-column content layout
chinese_content.svg	Chinese text content page
diagram_flow.svg	Flow/process diagram
diagram_architecture.svg	Architecture diagram
diagram_lifecycle.svg	Lifecycle/state diagram
dark_tech.svg	Dark theme technical page
tech_blueprint.svg	Technical blueprint layout
chart_bubble.svg	Data visualization (bubble chart)
table_data.svg	Data table layout
kpi_dashboard.svg	KPI/metrics dashboard
stats_memphis.svg	Statistics with Memphis style
color_palette.svg	Color/palette showcase
roadmap_timeline.svg	Roadmap/timeline (glassmorphism)
roadmap_business.svg	Business roadmap
brutalist_overview.svg	Brutalist overview page
brutalist_timeline.svg	Brutalist timeline
glassmorphism_cards.svg	Glassmorphism card layout
map_infographic.svg	Map/geographic infographic

Pick the closest match to the current page type. These are the structural patterns to follow.

Reference Index

File	Purpose
references/strategist.md	Strategist role definition
references/executor-base.md	Executor guidelines
references/shared-standards.md	SVG/PPTX technical constraints
references/canvas-formats.md	Canvas dimension specs
references/few-shot/	SVG page examples for executor
templates/design_spec_reference.md	Design spec template
templates/spec_lock_reference.md	Spec lock template