AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
docs(executor): promote chart calibration to independent pipeline gate
hugohe309d846b075dc
diff --git a/AGENTS.md b/AGENTS.mdindex 62cd94d2..64d5a106 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -8,7 +8,7 @@ Before any PPT generation task, **you MUST first read [`skills/ppt-master/SKILL.PPT Master is an AI-driven presentation generation system. Multi-role collaboration (Strategist → Image_Generator → Executor) converts source documents (PDF/DOCX/URL/Markdown) into natively editable PPTX with real PowerPoint shapes (DrawingML).-**Core Pipeline**: `Source Document → Create Project → Template Option → Strategist Eight Confirmations → [Image_Generator] → Executor → Post-processing → Export PPTX`+**Core Pipeline**: `Source Document → Create Project → Template Option → Strategist Eight Confirmations → [Image_Generator] → Executor → Quality Check → Chart Calibration → Post-processing → Export PPTX`## Execution Requirements@@ -47,6 +47,14 @@ python3 skills/ppt-master/scripts/analyze_images.py <project_path>/imagespython3 skills/ppt-master/scripts/image_gen.py "prompt" --aspect_ratio 16:9 --image_size 1K -o <project_path>/imagespython3 skills/ppt-master/scripts/svg_quality_checker.py <project_path>+# Chart coordinate calibration (MANDATORY after quality check, before notes)+# Step 1: find pages with charts+grep -l "chart-plot-area" <project_path>/svg_output/*.svg+# Step 2: run calculator per chart type and update SVG coordinates+python3 skills/ppt-master/scripts/svg_position_calculator.py calc bar --data "L1:V1,L2:V2" --area "x_min,y_min,x_max,y_max" --bar-width 120+python3 skills/ppt-master/scripts/svg_position_calculator.py calc pie --data "A:35,B:25" --center "cx,cy" --radius 200+python3 skills/ppt-master/scripts/svg_position_calculator.py calc line --data "x1:y1,x2:y2" --area "x_min,y_min,x_max,y_max" --y-range "0,max"+# Post-processing pipeline: run sequentially, one command at a timepython3 skills/ppt-master/scripts/total_md_split.py <project_path>python3 skills/ppt-master/scripts/finalize_svg.py <project_path>diff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex 5d7edba0..308804cc 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -262,7 +262,9 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path>- `warning` entries (low-res image, non-PPT-safe font tail, etc.): fix when straightforward, otherwise acknowledge and release.- Run against `svg_output/` (not after `finalize_svg.py` — finalize rewrites SVG and masks violations).-**Chart Coordinate Calibration (Mandatory)** — after quality check passes, BEFORE Logic Construction:+**Chart Coordinate Calibration Gate** ⚠️ (MANDATORY) — after quality check passes, BEFORE Logic Construction:++> **STOP — This is a separate gate, not part of the quality check. Do NOT skip.**1. Enumerate chart pages:```bash@@ -280,7 +282,9 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path>## ✅ Executor Phase Complete- [x] All SVGs generated to svg_output/- [x] svg_quality_checker.py passed (0 errors)-- [x] Chart calibration completed (or no calculator-supported charts present)+- [x] Chart Calibration Gate: ran `grep -l "chart-plot-area"` → ran+ `svg_position_calculator.py calc <type>` for each result and updated+ SVG coordinates (or confirmed: no calculator-supported charts)- [x] Speaker notes generated at notes/total.md```diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 056274df..a65b3609 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -79,8 +79,9 @@ Before drawing each page, look up its entry in `page_rhythm` (key format `P<NN>`- **Generation rhythm**: lock global design context first, then generate pages sequentially in one continuous context. No batched groups (e.g., 5 at a time).- **Phased batch generation** (recommended):1. **Visual Construction Phase**: generate all SVG pages sequentially for visual consistency. Do NOT run `svg_position_calculator.py` during the initial draft — use layout judgment for chart marks. On every page that draws a `bar` / `pie` / `donut` / `line` / `area` / `radar` chart, embed the REQUIRED `<!-- chart-plot-area: x_min,y_min,x_max,y_max -->` marker so §5.1 calibration can enumerate the page.- 2. **Quality Check Gate** (between phases): run `python3 scripts/svg_quality_checker.py <project_path>` on `svg_output/`. Any `error` (banned features, viewBox mismatch, spec_lock drift, non-PPT-safe font, etc.) MUST be fixed on the offending page before proceeding — regenerate and re-check. Address `warning`s when straightforward. After passing, run §5.1 chart coordinate calibration for calculator-supported chart types. Do NOT defer to after `finalize_svg.py` — finalize rewrites SVG and masks some violations.- 3. **Logic Construction Phase**: after SVGs pass, batch-generate speaker notes for narrative continuity.+ 2. **Quality Check Gate**: run `python3 scripts/svg_quality_checker.py <project_path>` on `svg_output/`. Any `error` (banned features, viewBox mismatch, spec_lock drift, non-PPT-safe font, etc.) MUST be fixed on the offending page before proceeding — regenerate and re-check. Address `warning`s when straightforward. Do NOT defer to after `finalize_svg.py` — finalize rewrites SVG and masks some violations.+ 3. **Chart Calibration Gate** ⚠️ (MANDATORY, do NOT skip): after quality check passes, run `svg_position_calculator.py` for every page containing a `<!-- chart-plot-area -->` marker. See §5.1 for the full workflow: `grep → calc → compare → update SVG`. AI models routinely introduce 10–50 px coordinate errors; this gate eliminates that class of error. If no calculator-supported charts exist, explicitly confirm skip.+ 4. **Logic Construction Phase**: after SVGs pass quality check AND calibration, batch-generate speaker notes for narrative continuity.- **Technical specs**: see [shared-standards.md](shared-standards.md) for SVG/PPT constraints- **Visual depth — through restraint**: layered depth comes from rhythm (flat vs lifted, dense vs spacious), not from shadows everywhere. Apply shadow to at most 2-3 genuinely floating elements per page (cards on photos, primary CTA, overlays); keep peer-grid cards, dividers, body containers flat. Reach for typography weight, spacing, accent bars, subtle tints **before** shadow. Full rules in shared-standards.md §6.