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
fix(workflows): make the first-page gate validate method, not just P01
hugohe3bb738d61241b
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex fb40b784..231e9a17 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -131,6 +131,7 @@ Before drawing each page, look up its entry in `page_rhythm` (key format `P<NN>`- **Proximity**: group related elements with tight spacing; separate unrelated groups- **Element grouping (Mandatory)**: wrap each logical Slide-local body unit in a descriptive, page-unique top-level `<g id>`. Every visible direct root `<g>` declares root-coordinate `data-pptx-bounds="x y width height"`; frame/native coordinates do not replace it, and placeholder bounds also supply the slot frame. Nested groups need no bounds and any such values are ignored. Checker compares root bounds with the `viewBox` and recursively checks only estimable text against its root module: through `1px` is ignored, through `5%` warns, above `5%` fails per side. Images, shapes, paths, `<use>`, effects, and object frames remain geometrically free. Flat pages use ordinary groups; structured slots already qualify, while titles, direct Master/Layout atoms, and canvas-level static framing may remain root primitives. On flat pages, give a root background image or full-canvas scrim/decoration rectangle a stable `id` plus `data-pptx-role="background"` / `"decoration"`; never wrap it only to silence the advisory.+- **Default — size `data-pptx-bounds` as the intended module zone, not a glyph box (may skip when no text is estimable)**: an untransformed line spans `y - 0.85 × font_size` to `y + 0.35 × font_size`, and per-character width estimates undercount CJK—most heavily on serif stacks—so leave headroom. If text does not fit, reflow or adapt; correct bounds only when that zone was recorded incorrectly. Larger bounds do not repair off-canvas text.- **Spec adherence**: follow color, layout, canvas format, and typography in the spec- **Template structure**: inherit the native visual framework only for `template_reuse_scope: mirror|layout`; `style` uses the flat route- **Main-agent ownership**: SVG generation must run in the main agent (not sub-agents) — pages share upstream context for cross-page visual continuitydiff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 12db5295..5a0c423e 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -33,7 +33,7 @@"skills/ppt-master/references/strategist-template.md": 2100,"skills/ppt-master/templates/design_spec_reference.md": 2850,"skills/ppt-master/templates/spec_lock_reference.md": 2350,- "skills/ppt-master/workflows/generate-pptx.md": 12450,+ "skills/ppt-master/workflows/generate-pptx.md": 12700,"skills/ppt-master/workflows/stages/apply-template-workspace.md": 1800},"load_sets": {@@ -322,7 +322,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 82275+ "max_tokens": 82475},"route.generate.flat-ai-two-types": {"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",@@ -335,7 +335,7 @@"stage.generate.image.ai-two-types"],"files": [],- "max_tokens": 122800+ "max_tokens": 123000},"route.generate.flat-in-hand-image": {"description": "Generate-PPTX context with provided, placeholder, or formula images and no acquisition role.",@@ -347,7 +347,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 96100+ "max_tokens": 96300},"route.generate.flat-web-image": {"description": "Generate-PPTX context with web image acquisition.",@@ -360,7 +360,7 @@"stage.generate.image.web"],"files": [],- "max_tokens": 103350+ "max_tokens": 103575},"route.enhance-native-pptx.audio": {"description": "Enhance Native PPTX with the shared narration-audio stage.",@@ -380,7 +380,7 @@"profile.generate.beautify-pptx"],"files": [],- "max_tokens": 89125+ "max_tokens": 89325},"route.generate.flat-no-image-chart": {"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",@@ -393,7 +393,7 @@"stage.generate.verify-charts"],"files": [],- "max_tokens": 106275+ "max_tokens": 106550},"route.generate.brand-flat-no-image": {"description": "Brand-preset flat Generate-PPTX path without image acquisition.",@@ -405,7 +405,7 @@"stage.generate.template.brand"],"files": [],- "max_tokens": 89275+ "max_tokens": 89500},"route.generate.deck-structured-no-image": {"description": "Deck-preset structured Generate-PPTX path without image acquisition.",@@ -417,7 +417,7 @@"stage.generate.template.deck"],"files": [],- "max_tokens": 99175+ "max_tokens": 99425},"route.generate.layout-structured-no-image": {"description": "Layout-preset structured Generate-PPTX path without image acquisition.",@@ -429,7 +429,7 @@"stage.generate.template.layout"],"files": [],- "max_tokens": 99675+ "max_tokens": 99875},"route.generate.topic-only-flat-no-image": {"description": "Topic research followed by the default flat no-image Generate-PPTX path.",@@ -439,7 +439,7 @@"route.generate.flat-no-image"],"files": [],- "max_tokens": 83675+ "max_tokens": 83875},"stage.generate.executor.flat": {"description": "Incremental flat Executor core with representative multi-source custom mode/style execution.",@@ -549,7 +549,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 58800+ "max_tokens": 59100},"stage.generate.topic-research": {"description": "Gap-targeted factual intake stage.",@@ -677,7 +677,7 @@"stage.generate.strategist.template"],"files": [],- "max_tokens": 60075+ "max_tokens": 60250},"route.generate.planning-template-ai": {"description": "Explicit template workspace plus confirmed AI-image planning.",@@ -687,7 +687,7 @@"route.generate.planning-ai"],"files": [],- "max_tokens": 72450+ "max_tokens": 72700},"stage.generate.executor.chart": {"description": "Conditional chart/table page execution rules.",diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex e45b7c36..ecb29da4 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -402,6 +402,22 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> --stage first```Run the command unfiltered—do not pipe it through `tail`, `head`, `grep`, or another output truncator. Review the complete P01 issue set from that one run before editing. Select any advisory warnings worth addressing, fix all blocking errors and selected warnings in one consolidated edit pass, then perform one verification rerun. Do not rerun merely to reveal the next issue. If verification still fails, treat its complete output as the next batch and repeat the same review → consolidated edit → single verification cycle; never check between individual fixes. If the terminal output itself is truncated, read only the relevant issue arrays from `validation/svg_quality_first_page_report.json`; do not launch another checker run for discovery. After the gate passes, draw P02 through the final page without checker calls.+**Mandatory — read P01 as a method sample, then emit the classification before editing**: the gate validates how the remaining pages will be authored, not only this page.++| Signal | Reading |+|---|---|+| Two or more issues share a category and direction | Method-level bias — resolve it to the authoritative rule before P02; a correction fitted to the observed offset only patches this sample. For text extents that rule is `svg_to_pptx.drawingml.elements.estimate_single_line_text_frame_width(runs)`, with `skills/ppt-master/scripts` on `sys.path` and every run key present — `text`, `font_size`, `font_family`, `font_weight`, `letter_spacing` — since omissions under-measure |+| One isolated issue tied to this page's structure | Page-local — fix and continue |+| A recurring element appears for the first time (page furniture, caption format, section numbering, accent discipline) | It will be copied to every later page — confirm its semantics now |++Emit one line before the consolidated edit:++```+gate-signal: method=<rule resolved, or none> | page-local=<count> | not-exercised=<list>+```++`not-exercised` names what P01 could not test — a cover typically omits multi-line text, columns, charts, image captions, and data objects. Carry every resolved rule forward as arithmetic; P02 through the final page run without further tool calls.+**Quality Check Gate (Mandatory)** — only after every planned SVG exists, BEFORE annotation handling and speaker notes:```bashpython3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> --stage final --json@@ -421,7 +437,8 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> --stage final```markdown## ✅ Executor Phase Complete- [x] Live preview started before the first SVG and kept available at the reported URL-- [x] P01 gate passed; remaining pages authored without checker calls+- [x] P01 gate passed and its `gate-signal` line emitted; any method-level finding was resolved to its authoritative rule before P02+- [x] Remaining pages authored without checker calls- [x] Each failing checker run was reviewed as one complete issue set and followed by one consolidated edit pass; checker output was not filtered- [x] `svg_output/` matches the ordered §IX roster exactly, one SVG per planned page- [x] Every wrapped prose paragraph uses one `<text>` frame with `<tspan>` line breaks