Skip to content

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): refine chart coordinate calibration workflow

hugohe3e96eefeb37e4
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index b915b011..ca5cf708 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -84,8 +84,8 @@ Before drawing each page, look up its entry in `page_rhythm` (key format `P<NN>`
- **Main-agent ownership**: SVG generation must be performed by the current main agent, not delegated to sub-agents, because each page depends on shared upstream context and cross-page visual continuity
- **Generation rhythm**: First lock the global design context, then generate pages sequentially one by one in the same continuous context; grouped page batches (for example, 5 pages at a time) are not allowed
- **Phased batch generation** (recommended):
- 1. **Visual Construction Phase**: Generate all SVG pages continuously in sequential page order, ensuring high consistency in design style and layout coordinates (Visual Consistency)
- 2. **Quality Check Gate** (mandatory between phases): first run `python3 scripts/svg_quality_checker.py <project_path>` against `svg_output/`. Any `error` (banned SVG features, viewBox mismatch, spec_lock color / font / size drift, non-PPT-safe font stack, etc.) MUST be fixed on the offending page before entering the Logic Construction Phase — re-generate that page and re-run the check. `warning` entries should be reviewed and fixed when straightforward; otherwise acknowledge and release. After the SVG quality checker passes, run the chart coordinate review in §5.1 for pages containing chart types supported by `svg_position_calculator.py`. Do NOT defer these checks to after `finalize_svg.py` — finalize rewrites SVG and some violations get masked.
+ 1. **Visual Construction Phase**: Generate all SVG pages continuously in sequential page order, ensuring high consistency in design style and layout coordinates (Visual Consistency). During the initial SVG draft, do NOT run `svg_position_calculator.py`; use normal layout judgment to place charts and approximate chart marks.
+ 2. **Quality Check Gate** (mandatory between phases): first run `python3 scripts/svg_quality_checker.py <project_path>` against `svg_output/`. Any `error` (banned SVG features, viewBox mismatch, spec_lock color / font / size drift, non-PPT-safe font stack, etc.) MUST be fixed on the offending page before entering the Logic Construction Phase — re-generate that page and re-run the check. `warning` entries should be reviewed and fixed when straightforward; otherwise acknowledge and release. After the SVG quality checker passes, run the chart coordinate calibration in §5.1 for pages containing chart types supported by `svg_position_calculator.py`. Do NOT defer these checks to after `finalize_svg.py` — finalize rewrites SVG and some violations get masked.
3. **Logic Construction Phase**: After SVGs pass the quality gate, batch-generate speaker notes to ensure narrative coherence (Narrative Continuity)
- **Technical specifications**: See [shared-standards.md](shared-standards.md) for SVG technical constraints and PPT compatibility rules
- **Visual depth — through restraint, not abundance**: Layered depth comes from rhythm (flat vs lifted, dense vs spacious), not from applying shadows everywhere. Use shadow on at most 2–3 genuinely floating elements per page (cards on photos, primary CTA, overlays); keep section panels, peer-grid cards, dividers, and body-text containers flat. Reach for typography weight, spacing, accent bars, and subtle background tints **before** adding shadow. See shared-standards.md §6 for full rules including single-light-source and elevation tiers.
@@ -191,9 +191,9 @@ When the Design Spec includes a **VII. Visualization Reference List**, read the
> Visualization templates: `templates/charts/` (70 types). Index: `templates/charts/charts_index.json`
-### 5.1 Chart Coordinate Review (After SVG Quality Checker)
+### 5.1 Chart Coordinate Calibration (After SVG Quality Checker)
-> For pages containing chart types supported by `svg_position_calculator.py`, run the calculator **after** `svg_quality_checker.py` passes and **before** entering the Logic Construction Phase. The goal is to compare calculated chart coordinates against the coordinates already present in the generated SVG. Do NOT apply this requirement to every visualization; it only applies to calculator-supported chart types.
+> For pages containing chart types supported by `svg_position_calculator.py`, run the calculator **after** `svg_quality_checker.py` passes and **before** entering the Logic Construction Phase. The goal is to calibrate the already generated SVG against the actual chart plot area. Do NOT run this calculator during the initial SVG draft, and do NOT apply this requirement to every visualization; it only applies to calculator-supported chart types.
**Workflow for chart pages after `svg_quality_checker.py` passes:**