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(workflow): assign cross-page motif ownership

hugohe3e83e36f689d3
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index c7a7c9ef..1ef24341 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -142,6 +142,7 @@ Before drawing each page, look up its entry in `page_rhythm` (key format `P<NN>`
- **Generation rhythm**: P01 → first-page gate → uninterrupted remaining pages → final gate, in one context without batches or mid-run checker calls.
- **Fact provenance**: when a §IX page lists `Fact IDs`, resolve each ID from `sources/*.facts.json` and keep the claim/value unchanged. Render a compact source footnote using the source name and a short URL/domain when space permits; when speaker notes are enabled, state the attribution naturally there too. When §IX says `Data class: scenario`, place a visible localized `Scenario data` / `情景数据` label adjacent to the affected KPI/chart and, when notes are enabled, state naturally there that the number is illustrative. Never attach an external fact ID to scenario data or let an unlabeled invented KPI look factual.
- **Default — stage each page with the style's composition geometry (may override when the content genuinely calls for a plain grid)**: an SVG page is a canvas, not a DOM. Before defaulting to stacked rounded-rect cards or uniform equal columns, pick one page-scale move from the locked visual style's §1 `Composition geometry` (a bleed shape, diagonal split, oversized numeral, orbit rings, …) to stage the page's primary zone. Card grids are one option among many, not the house layout.
+- **Default — vary a planned deck motif instead of cloning it (may omit where it has no page job)**: when §III `Theme` names a cross-page motif, use the current §IX `Layout` to preserve its recognizable contour, direction, material, or relationship while varying scale, crop, density, position, and content interaction by page role. Apply it only where it supports hierarchy or continuity; do not paste identical ornament or invent a second recurring identity. Changing the motif itself requires upstream repair.
- **Containers are structural**: cards and grids express grouping, hierarchy, or capacity, not a house style. Preserve meaningful template frames; restyle radius, fill, stroke, and depth from the active Design Spec and `spec_lock.md`. Chart-catalog adaptation is owned by [`executor-chart.md`](./executor-chart.md); preview effects never override project styling or structural roles.
- **Reference — prefer semantic geometry over preset stacks**: for relationships such as ascending, converging, breaking through, or stacking, first seek a basic primitive, one exact preset, or a clear Boolean result. Only when none can faithfully express the relationship should one page-specific polygon/path replace a stack of generic arrows.
- **Reference — create depth with restraint**: use rhythm, spacing, typography, accent bars, and subtle tints before shadows. Reserve lift for a few genuinely floating elements; keep peer grids, dividers, and body containers flat.
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index d0acc4d0..daff634c 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -408,6 +408,16 @@ Lock the stable role set the deck needs, including recurring neutrals such as `s
| Core + surrounding forces | center-radiating or hub-spoke |
| Wide visual + explanation | top-bottom split |
+**Default — define one cross-page visual motif when it can carry identity or
+meaning (may omit when restraint serves the deck better)**: after the complete
+§IX roster and planned visual resources are known, choose or inherit one reusable
+page-scale geometry or material gesture—such as a directional contour, opening,
+line lattice, or oversized numeral. Fold its recognizable invariant and allowed
+variation (scale, crop, density, position, content interaction) into the
+existing §III `Theme`, and mention it only in §IX `Layout` blocks that use it.
+Vary it by page role instead of copying one ornament; create no motif field or
+lock row. This is a continuity Reference, not a decoration quota.
+
On PPT 16:9, start from a 1200×640 safe area with 40px outer margins, then adapt to content. Template workspaces may supply different geometry; when active, [`strategist-template.md`](./strategist-template.md) owns precedence.
---
diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.json
index 69a717c6..779fb1b1 100644
--- a/skills/ppt-master/scripts/prompt_audit_manifest.json
+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json
@@ -12,12 +12,12 @@
"skills/ppt-master/templates/schemas/*.json"
],
"exclude": [],
- "max_tokens": 396362
+ "max_tokens": 396701
},
"file_budgets": {
"AGENTS.md": 2400,
"skills/ppt-master/SKILL.md": 850,
- "skills/ppt-master/references/executor-base.md": 8250,
+ "skills/ppt-master/references/executor-base.md": 8253,
"skills/ppt-master/references/executor-structured.md": 5300,
"skills/ppt-master/references/executor-chart.md": 3100,
"skills/ppt-master/references/executor-image.md": 1700,
@@ -28,7 +28,7 @@
"skills/ppt-master/references/svg-effects.md": 12524,
"skills/ppt-master/references/native-data-interface.md": 6200,
"skills/ppt-master/references/pptx-structure-interface.md": 4300,
- "skills/ppt-master/references/strategist.md": 14350,
+ "skills/ppt-master/references/strategist.md": 14487,
"skills/ppt-master/references/strategist-image.md": 2525,
"skills/ppt-master/references/strategist-template.md": 2100,
"skills/ppt-master/templates/design_spec_reference.md": 3275,
@@ -170,7 +170,7 @@
"registry": "visual-styles"
}
],
- "max_tokens": 62962
+ "max_tokens": 63108
},
"route.generate.quick-generate": {
"description": "Explicit non-interactive Generate path with conditional source/resource preparation and the complete SVG visual-construction authorities.",
@@ -186,7 +186,7 @@
"skills/ppt-master/references/svg-effects.md",
"skills/ppt-master/references/native-shape-authoring.md"
],
- "max_tokens": 54187
+ "max_tokens": 54277
},
"route.generate.quick-generate.topic-research": {
"description": "Quick Generate with gap-targeted factual research before direct resource preparation and SVG authoring.",
@@ -196,7 +196,7 @@
"stage.generate.topic-research"
],
"files": [],
- "max_tokens": 55699
+ "max_tokens": 55789
},
"route.generate.quick-generate.icon": {
"description": "Quick Generate with project-local bundled icon selection and synchronization.",
@@ -207,7 +207,7 @@
"files": [
"skills/ppt-master/templates/icons/README.md"
],
- "max_tokens": 56099
+ "max_tokens": 56189
},
"route.generate.quick-generate.in-hand-image": {
"description": "Quick Generate with supplied, extracted, or placeholder image resources prepared before SVG authoring.",
@@ -217,7 +217,7 @@
"stage.generate.executor.image"
],
"files": [],
- "max_tokens": 64243
+ "max_tokens": 64333
},
"route.generate.quick-generate.formula": {
"description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",
@@ -229,7 +229,7 @@
"files": [
"skills/ppt-master/scripts/docs/image.md"
],
- "max_tokens": 67429
+ "max_tokens": 67519
},
"route.generate.quick-generate.ai-two-types": {
"description": "Quick Generate with AI resource preparation, representative rendering inputs, and two local image types.",
@@ -240,7 +240,7 @@
"stage.generate.executor.image"
],
"files": [],
- "max_tokens": 87348
+ "max_tokens": 87438
},
"route.generate.quick-generate.web-image": {
"description": "Quick Generate with web resource preparation, provenance, attribution, and image execution.",
@@ -251,7 +251,7 @@
"stage.generate.executor.web-image"
],
"files": [],
- "max_tokens": 71996
+ "max_tokens": 72086
},
"route.generate.planning-image": {
"description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed, including the compact layout math and vocabulary.",
@@ -261,7 +261,7 @@
"stage.generate.strategist.image"
],
"files": [],
- "max_tokens": 71255
+ "max_tokens": 71401
},
"route.generate.planning-formula": {
"description": "Formula-only planning context, including the shared image/formula layout math and vocabulary.",
@@ -271,7 +271,7 @@
"stage.generate.strategist.image"
],
"files": [],
- "max_tokens": 71255
+ "max_tokens": 71401
},
"route.generate.planning-ai": {
"description": "Generate-PPTX planning when AI image direction is available, including representative multi-source custom rendering synthesis.",
@@ -291,7 +291,7 @@
"registry": "image-renderings"
}
],
- "max_tokens": 75497
+ "max_tokens": 75643
},
"stage.generate.apply-template-workspace": {
"description": "Conditional Step 3 workspace validation, installation, and fusion framework.",
@@ -403,7 +403,7 @@
"stage.generate.executor.notes"
],
"files": [],
- "max_tokens": 105568
+ "max_tokens": 105817
},
"route.generate.flat-ai-two-types": {
"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",
@@ -461,7 +461,7 @@
"profile.generate.beautify-pptx"
],
"files": [],
- "max_tokens": 112575
+ "max_tokens": 112824
},
"route.generate.flat-no-image-chart": {
"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",
@@ -474,7 +474,7 @@
"stage.generate.verify-charts"
],
"files": [],
- "max_tokens": 129904
+ "max_tokens": 130153
},
"route.generate.brand-flat-no-image": {
"description": "Brand-preset flat Generate-PPTX path without image acquisition.",
@@ -486,7 +486,7 @@
"stage.generate.template.brand"
],
"files": [],
- "max_tokens": 112600
+ "max_tokens": 112849
},
"route.generate.deck-structured-no-image": {
"description": "Deck-preset structured Generate-PPTX path without image acquisition.",
@@ -498,7 +498,7 @@
"stage.generate.template.deck"
],
"files": [],
- "max_tokens": 122537
+ "max_tokens": 122786
},
"route.generate.layout-structured-no-image": {
"description": "Layout-preset structured Generate-PPTX path without image acquisition.",
@@ -510,7 +510,7 @@
"stage.generate.template.layout"
],
"files": [],
- "max_tokens": 122986
+ "max_tokens": 123235
},
"route.generate.topic-only-flat-no-image": {
"description": "Topic research followed by the default flat no-image Generate-PPTX path.",
@@ -520,7 +520,7 @@
"route.generate.flat-no-image"
],
"files": [],
- "max_tokens": 107080
+ "max_tokens": 107329
},
"stage.generate.executor.flat": {
"description": "Incremental flat Executor core with complete visual-construction authorities and representative multi-source custom mode/style execution.",
@@ -622,7 +622,7 @@
"skills/ppt-master/workflows/stages/resume-execute.md",
"skills/ppt-master/references/artifact-ownership.md"
],
- "max_tokens": 67924
+ "max_tokens": 68027
},
"stage.generate.resume-execute-image": {
"description": "Fresh-session resume when the locked resource plan contains image rows.",
@@ -768,7 +768,7 @@
"stage.generate.strategist.template"
],
"files": [],
- "max_tokens": 65038
+ "max_tokens": 65184
},
"route.generate.planning-template-ai": {
"description": "Explicit template workspace plus confirmed AI-image planning.",
diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.md
index 7d588632..a625e073 100644
--- a/skills/ppt-master/workflows/profiles/quick-generate.md
+++ b/skills/ppt-master/workflows/profiles/quick-generate.md
@@ -82,6 +82,9 @@ Design Spec or lock. Use a new path, or verify that an existing path's
Before writing P01, resolve in active context:
- the slide roster, canvas, visual direction, palette, typography, and wording;
+- when useful, one transient deck-level visual motif with an identity or
+ communication job, a recognizable invariant, and planned variation across
+ applicable page roles; omit it when restraint serves the deck better;
- a transient resource roster with page, filename, purpose, visual intent,
acquisition path, crop behavior, and status. For an image/formula, include
its page relationship plus any subject position, focus, quiet region, or
@@ -152,9 +155,12 @@ on a lock or generated font asset.
**Generation pacing**: the current main agent hand-writes the SVG roster in
order. Use P01 as the visual anchor and continue directly through the remaining
-pages without a first-page checker or confirmation stop. After the complete
-roster exists, run the one final checker below. Apply other supporting tools
-and stages only when their capability is actually needed.
+pages without a first-page checker or confirmation stop. When a motif was
+resolved, reuse it selectively and vary scale, crop, density, position, or
+content interaction instead of cloning one ornament. Keep this choice only in
+active context; create no planning artifact or approval stop. After the complete
+roster exists, run the one final checker below. Apply other supporting tools and
+stages only when their capability is actually needed.
---