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(image-layout): require action-bearing image compositions
hugohe35bf789f1641a
diff --git a/skills/ppt-master/references/executor-image.md b/skills/ppt-master/references/executor-image.mdindex ebb568e6..27eae26e 100644--- a/skills/ppt-master/references/executor-image.md+++ b/skills/ppt-master/references/executor-image.md@@ -27,7 +27,9 @@ Handle images by status; enum and lifecycle: [`svg-image-embedding.md`](svg-imag**Template-bundled images**: [`apply-template-workspace.md`](../workflows/stages/apply-template-workspace.md) copies them into project `images/`. Outside `mirror`, reference `../images/<name>` and never copy a template SVG's bare sibling href: the rendered page lives in `svg_output/`. `mirror` ([`executor-structured.md`](./executor-structured.md) §1.1) keeps hrefs verbatim; export resolves them against `images/`.-**Reference — layout catalog is optional recall**: Load [`image-layout-patterns.md`](./image-layout-patterns.md) only when an active suggestion cites `#<id>` or inspiration is useful; resolve only cited ids. Free-form suggestions need no catalog lookup. Adapt or decline the suggestion when the page communicates better, while preserving resource role/source, must-use, crop/content, and explicit user/template constraints. Expression-only changes need no upstream rewrite.+**Reference — layout catalog is optional recall**: Load [`image-layout-patterns.md`](./image-layout-patterns.md) for a cited `#<id>` or useful recall; free-form suggestions need no lookup.++**Default — action-bearing image composition (may override only for an upstream-documented restraint or explicit user/template/content boundary)**: On a `page_role: hero_page` or otherwise image-led page, realize the suggestion or replace it with another concrete image/content or image/shape relationship. Position, size, routine crop, and a legibility-only scrim alone do not constitute that relationship. A direct split or full-bleed treatment remains valid only when matching §IX `Layout` / `Images` records deliberate restraint or an explicit boundary requires it. Preserve role/source, must-use, crop/content, and explicit user/template constraints; expression-only changes need no upstream rewrite.**Reference — motion-ready image layering, not a constraint**: For adopted §IX or an explicit focus, comparison, evidence, reveal-order, or cross-page requirement, decide during SVG authoring whether the final composition needs separate visible units. Keep ordinary stable framing/background static and wrap each independently revealed or continuing Slide-local unit in a descriptive direct-root `<g id>`; structured atoms/slots retain their boundaries. Existing units or a page transition may suffice. The motion stage owns effects, pairing, order, and timing.diff --git a/skills/ppt-master/references/strategist-image.md b/skills/ppt-master/references/strategist-image.mdindex 8a7de821..bedf2815 100644--- a/skills/ppt-master/references/strategist-image.md+++ b/skills/ppt-master/references/strategist-image.md@@ -53,7 +53,9 @@ Add §VIII rows for the image resources actually planned from the confirmed sour**Prepared-user fast path**: For initial imported or user-supplied assets confirmed as `provided`, copy the exact `Filename` basename and derive `Dimensions` / `Ratio` from that row's EXIF-corrected `Width` / `Height` / native `AspectRatio` in the latest `analysis/image_analysis.csv`; `SourceDisplayRatio` is source-context metadata, not the bitmap crop ratio. Drop source-side directories, set `Acquire Via: user` and `Status: Existing`, and decide the remaining §VIII fields normally. Existing §VIII / lock / provenance-manifest records override this inference. Assets declared as `ai`, `web`, `slice`, `formula`, or manual fulfillment retain that provenance and advance through their own status lifecycle after entering `images/`; location never reclassifies them as `user / Existing`.-**Mandatory**: write one concise, non-empty, executable `Layout pattern` value per non-formula row in ordinary language. It may cite stable ids from [`image-layout-patterns.md`](./image-layout-patterns.md), but reading the library or using ids is not required. Preserve any cited id accurately; otherwise describe the composition without inventing one.+**Mandatory**: write one concise, non-empty, executable `Layout pattern` per non-formula row in ordinary language; optional ids from [`image-layout-patterns.md`](./image-layout-patterns.md) must be exact.++**Default — action-bearing image composition (may override when deliberate restraint is documented for the page)**: For a `page_role: hero_page` or otherwise image-led row, name a concrete image/content or image/shape relationship. Position, size, routine crop, and a legibility-only scrim alone do not constitute that relationship. A plain split or full-bleed treatment remains valid only when page-specific restraint is deliberate; state why in the matching §IX `Layout` / `Images`.**Reference — not a constraint**: open [`image-layout-patterns.md`](./image-layout-patterns.md) only when its vocabulary would expand the current options. Techniques needing a cutout, blurred crop, or desaturated copy require that prepared asset. Executor may adapt, replace, or decline the suggestion while preserving resource role, file/source, must-use status, crop boundary, content, and explicit user/template constraints; layout-only changes need no upstream rewrite.diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 1f2ae61b..1e987741 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -12,7 +12,7 @@"skills/ppt-master/templates/schemas/*.json"],"exclude": [],- "max_tokens": 399925+ "max_tokens": 400200},"file_budgets": {"AGENTS.md": 2400,@@ -20,7 +20,7 @@"skills/ppt-master/references/executor-base.md": 8250,"skills/ppt-master/references/executor-structured.md": 5300,"skills/ppt-master/references/executor-chart.md": 3100,- "skills/ppt-master/references/executor-image.md": 1500,+ "skills/ppt-master/references/executor-image.md": 1600,"skills/ppt-master/references/executor-web-image.md": 500,"skills/ppt-master/references/executor-notes.md": 900,"skills/ppt-master/references/shared-standards.md": 250,@@ -29,7 +29,7 @@"skills/ppt-master/references/native-data-interface.md": 6200,"skills/ppt-master/references/pptx-structure-interface.md": 4300,"skills/ppt-master/references/strategist.md": 14225,- "skills/ppt-master/references/strategist-image.md": 2500,+ "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,"skills/ppt-master/templates/spec_lock_reference.md": 2375,@@ -184,7 +184,7 @@"skills/ppt-master/references/artifact-ownership.md","skills/ppt-master/references/shared-standards-core.md"],- "max_tokens": 36525+ "max_tokens": 36650},"route.generate.quick-generate.topic-research": {"description": "Quick Generate with gap-targeted factual research before direct resource preparation and SVG authoring.",@@ -194,7 +194,7 @@"stage.generate.topic-research"],"files": [],- "max_tokens": 38025+ "max_tokens": 38150},"route.generate.quick-generate.icon": {"description": "Quick Generate with project-local bundled icon selection and synchronization.",@@ -205,7 +205,7 @@"files": ["skills/ppt-master/templates/icons/README.md"],- "max_tokens": 38425+ "max_tokens": 38550},"route.generate.quick-generate.in-hand-image": {"description": "Quick Generate with supplied, extracted, or placeholder image resources prepared before SVG authoring.",@@ -215,7 +215,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 43450+ "max_tokens": 43675},"route.generate.quick-generate.formula": {"description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",@@ -227,7 +227,7 @@"files": ["skills/ppt-master/scripts/docs/image.md"],- "max_tokens": 46650+ "max_tokens": 46850},"route.generate.quick-generate.ai-two-types": {"description": "Quick Generate with AI resource preparation, representative rendering inputs, and two local image types.",@@ -238,7 +238,7 @@"stage.generate.executor.image"],"files": [],- "max_tokens": 66500+ "max_tokens": 66700},"route.generate.quick-generate.web-image": {"description": "Quick Generate with web resource preparation, provenance, attribution, and image execution.",@@ -249,7 +249,7 @@"stage.generate.executor.web-image"],"files": [],- "max_tokens": 51200+ "max_tokens": 51425},"route.generate.planning-image": {"description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed; layout-catalog recall remains optional.",@@ -269,7 +269,7 @@"stage.generate.strategist.image"],"files": [],- "max_tokens": 64650+ "max_tokens": 64750},"route.generate.planning-ai": {"description": "Generate-PPTX planning when AI image direction is available, including representative multi-source custom rendering synthesis.",@@ -790,7 +790,7 @@"files": ["skills/ppt-master/references/strategist-image.md"],- "max_tokens": 2500+ "max_tokens": 2525},"stage.generate.strategist.image-layout": {"description": "Optional image-layout catalog recall layered on image planning when the Strategist wants additional composition vocabulary.",diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex a5524fa8..2b3a3175 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -59,11 +59,14 @@ Before writing P01, resolve in active context:- the slide roster, canvas, visual direction, palette, typography, and wording;- a transient resource roster with page, filename, purpose, visual intent,- acquisition path, crop behavior, and status;+ acquisition path, crop behavior, and status; for a hero page or other+ image-led use, the visual intent includes an action-bearing composition;- the implementation path for each resource. An explicit user path wins;otherwise choose the registered automatic/default path without anotherinteraction.+**Default — action-bearing image composition (may override only for an explicit user/material boundary or a page-specific restraint decision)**: For a hero page or otherwise image-led resource, resolve one concrete image/content or image/shape relationship before SVG authoring. Position, size, routine crop, and a legibility-only scrim alone do not constitute that relationship. A plain split or full-bleed treatment remains valid only when the explicit boundary requires it or the agent records a page-specific restraint reason in active context; decide and continue without another interaction.+Prepare only the resource paths that the roster triggers:| Resource | Required preparation |