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

feat(generate): add quick test SVG-to-PPTX mode

hugohe359b820c0adc4
diff --git a/AGENTS.md b/AGENTS.md
index 21879108..33cc0450 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -13,6 +13,7 @@ PPT Master is an AI-driven presentation generation system. Multi-role collaborat
- Topic-only or fact-insufficient inputs run [`topic-research`](skills/ppt-master/workflows/stages/topic-research.md) in Generate Step 1; facts only, no images.
- Raw PPTX template plus new material/topic routes to [`template-fill-pptx`](skills/ppt-master/workflows/template-fill-pptx.md), not the SVG pipeline.
- Raw PPTX cannot be consumed as a Generate Step 3 SVG template; run [`create-template`](skills/ppt-master/workflows/create-template.md) first and return with the generated template workspace root. Never add Master/Layout structure directly to an existing PPTX/SVG; generate new structured SVG pages from the workspace.
+- Explicit disposable tests with a small fixed roster of self-contained slides may use the Generate-route [`quick-test`](skills/ppt-master/workflows/profiles/quick-test.md) profile: hand-author `svg_output/` and run the test-only direct exporter, producing no normal planning, preview, notes, validation, or backup artifacts.
- PPTX beautify is a strict 1:1 main-generation [`profile`](skills/ppt-master/workflows/profiles/beautify-pptx.md), not a separate route; any split/merge/drop/reorder uses the default main-pipeline policy.
- Finished PPTX native enhancement uses [`native-enhance-pptx`](skills/ppt-master/workflows/native-enhance-pptx.md) and must not enter SVG regeneration.
- [`visual-review`](skills/ppt-master/workflows/stages/visual-review.md), [`customize-animations`](skills/ppt-master/workflows/stages/customize-animations.md), and [`generate-audio`](skills/ppt-master/workflows/stages/generate-audio.md) are supporting stages; their trigger rules remain explicit/conditional.
diff --git a/README.md b/README.md
index 3194181b..2dd4cc3c 100644
--- a/README.md
+++ b/README.md
@@ -315,7 +315,7 @@ AI: Sure. Let's confirm the design spec:
The AI handles everything — content analysis, visual design, SVG generation, and PPTX export.
-> **Output:** The SVG pipeline has one PPTX export route: PPT Master's converter reads `svg_output/` and writes a directly editable native DrawingML deck to `exports/<name>_<timestamp>.pptx`. Step 7 still always runs `finalize_svg.py`, producing self-contained files in `svg_final/` for visual inspection or manual insertion as SVG pictures; PowerPoint's manual **Convert to Shape** command is outside the supported contract. A copy of `svg_output/` is always snapshotted to `backup/<timestamp>/svg_output/` for re-export / archival. By default charts and tables export as individually editable SVG-derived DrawingML shapes, which prioritize cross-app visual consistency. Pass `--native-charts-and-tables` to replace eligible groups with PowerPoint-native Chart/Table objects backed by data, which provide **Edit Data** and object-specific controls but may render differently across apps; this variant is saved as `exports/<name>_<timestamp>_native_charts_tables.pptx`. Both routes are editable—the distinction is the PowerPoint object model, not editability itself.
+> **Output:** The SVG pipeline has one PPTX converter: it reads `svg_output/` and writes a directly editable native DrawingML deck to `exports/<name>_<timestamp>.pptx`. The normal delivery flow runs `finalize_svg.py`, produces self-contained previews in `svg_final/`, and snapshots `svg_output/` to `backup/<timestamp>/svg_output/`; PowerPoint's manual **Convert to Shape** command is outside the supported contract. Explicit disposable few-page tests may instead use [quick-test mode](./skills/ppt-master/workflows/profiles/quick-test.md), which writes only the authored SVGs and one PPTX—no planning, preview, notes, validation, or backup artifacts. By default charts and tables export as individually editable SVG-derived DrawingML shapes, which prioritize cross-app visual consistency. Pass `--native-charts-and-tables` to replace eligible groups with PowerPoint-native Chart/Table objects backed by data, which provide **Edit Data** and object-specific controls but may render differently across apps; this variant is saved as `exports/<name>_<timestamp>_native_charts_tables.pptx`. Both routes are editable—the distinction is the PowerPoint object model, not editability itself.
> **Already have a `.pptx` you want to reuse?** Hand the AI that deck plus your material and ask it to "fill this deck with the new content" — it fills text, table, and chart data into your existing design and exports only the pages you pick, staying natively editable. See the [FAQ](./docs/faq.md) and [template-fill workflow](./skills/ppt-master/workflows/template-fill-pptx.md).
diff --git a/README_CN.md b/README_CN.md
index 8d324a97..eb719fef 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -325,7 +325,7 @@ AI:好的,先确认设计规范:
AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。
-> **输出说明:** 标准导出从 `svg_output/` 经项目转换器生成原生 DrawingML `.pptx`,保存至 `exports/<name>_<timestamp>.pptx`;这是唯一的 PPTX 产物路线,文字和图形可直接编辑。`svg_output/` 始终镜像到 `backup/<timestamp>/svg_output/`,便于归档或后续重跑。流程仍会强制生成 `svg_final/`:它是一组自包含的视觉预览 SVG,可直接打开,也可作为 SVG 图片手动插入 PowerPoint;PowerPoint 手工“转换为形状”不在支持范围。图表和表格默认导出为 SVG 派生、可逐形状编辑的 DrawingML 对象,优先保证 PowerPoint / Keynote / WPS 间的视觉一致性;加 `--native-charts-and-tables` 则把符合合同的组替换为带数据源和对象专属编辑能力的 PowerPoint 原生 Chart/Table 对象,跨软件渲染可能略有差异,保存为 `exports/<name>_<timestamp>_native_charts_tables.pptx`。两条路线都可编辑,区别在于 PowerPoint 对象模型,而不是“能否编辑”。
+> **输出说明:** SVG 管线统一由项目转换器读取 `svg_output/`,生成可直接编辑的原生 DrawingML `.pptx`,保存至 `exports/<name>_<timestamp>.pptx`。正式交付流程会生成自包含预览 `svg_final/`,并把 `svg_output/` 镜像到 `backup/<timestamp>/svg_output/`;PowerPoint 手工“转换为形状”不在支持范围。明确用于临时测试的少量自包含页面可改用[快速测试模式](./skills/ppt-master/workflows/profiles/quick-test.md):只写 SVG 页面和一个 PPTX,不生成规划、预览、讲稿、验证报告或备份。图表和表格默认导出为 SVG 派生、可逐形状编辑的 DrawingML 对象,优先保证 PowerPoint / Keynote / WPS 间的视觉一致性;加 `--native-charts-and-tables` 则把符合合同的组替换为带数据源和对象专属编辑能力的 PowerPoint 原生 Chart/Table 对象,跨软件渲染可能略有差异,保存为 `exports/<name>_<timestamp>_native_charts_tables.pptx`。两条路线都可编辑,区别在于 PowerPoint 对象模型,而不是“能否编辑”。
> **已有一份想复用的 `.pptx`?** 把那份 deck 连同素材给 AI,说「套模板」即可——它会把新内容(文字、表格、图表数据)填进你现有的设计,只导出你挑选的页面,且保持原生可编辑。详见 [常见问题](./docs/zh/faq.md) 与 [套模板工作流](./skills/ppt-master/workflows/template-fill-pptx.md)。
diff --git a/docs/faq.md b/docs/faq.md
index b988ae5b..6153c7ec 100644
--- a/docs/faq.md
+++ b/docs/faq.md
@@ -77,9 +77,9 @@ Be clear on what this buys you: **web search only finds *a* relevant, downloadab
## Q: Can I edit the generated presentations?
-Yes. The only PPTX export route in the SVG pipeline is PPT Master's own `svg_output/` → DrawingML conversion. It saves a timestamped native PowerPoint deck to `exports/`, with text, graphics, and colors directly editable as PowerPoint objects. A copy of `svg_output/` (the Executor's raw SVG source) is always written to `backup/<timestamp>/svg_output/` so you can rebuild via `finalize_svg → svg_to_pptx` without re-running the LLM.
+Yes. The only PPTX converter in the SVG pipeline is PPT Master's own `svg_output/` → DrawingML conversion. It saves a timestamped native PowerPoint deck to `exports/`, with text, graphics, and colors directly editable as PowerPoint objects. In the normal delivery flow, a copy of `svg_output/` (the Executor's raw SVG source) is written to `backup/<timestamp>/svg_output/` so you can rebuild via `finalize_svg → svg_to_pptx` without re-running the LLM.
-`finalize_svg.py` remains a mandatory Step 7 operation even though native PPTX export reads `svg_output/`. It produces self-contained files in `svg_final/` for visual inspection and for manual insertion into another deck as SVG pictures. PowerPoint's manual **Convert to Shape** command is not a supported round-trip path; use the generated native PPTX when you need editable shapes.
+`finalize_svg.py` remains a mandatory Step 7 operation in the normal delivery flow even though native PPTX export reads `svg_output/`. It produces self-contained files in `svg_final/` for visual inspection and for manual insertion into another deck as SVG pictures. The explicit quick-test profile skips preview and backup artifacts. PowerPoint's manual **Convert to Shape** command is not a supported round-trip path; use the generated native PPTX when you need editable shapes.
## Q: Why is one paragraph split into multiple text boxes? Can I get one text box per paragraph instead?
@@ -197,6 +197,19 @@ A typical 10–15 page presentation takes about **10–20 minutes** with a fast
If generation feels slow, check your model's token throughput. The bottleneck is usually the model's output speed, not the scripts.
+## Q: Can I use a fast mode for a few disposable test slides?
+
+Yes. Explicitly say that this is a **quick test** and request a small fixed
+roster of self-contained slides. The Generate route then uses the
+[`quick-test` profile](../skills/ppt-master/workflows/profiles/quick-test.md):
+the agent hand-authors `svg_output/` and runs the test-only direct exporter.
+
+This mode produces only the SVG pages and one PPTX. It skips source conversion,
+research, Strategist/confirmation, templates, asset acquisition, Live Preview,
+quality-report files, notes, `svg_final/`, backup, animation, and narration. It
+is not available for normal delivery, factual/source-backed decks, external
+assets, templates, native charts/tables, or reusable output.
+
## Q: Will long decks blow out the context window in one shot?
Default recommendation: **continuous one-shot generation**. 10–15 page decks fit comfortably in a 200K window, and cross-page visual consistency is best when the Executor can see prior pages in the same session (it actively aligns style, font sizes, and rhythm).
diff --git a/docs/technical-design.md b/docs/technical-design.md
index 24bb3024..2c13da41 100644
--- a/docs/technical-design.md
+++ b/docs/technical-design.md
@@ -253,7 +253,7 @@ Two converter design choices still shape the system:
## Project Structure & Lifecycle
-`project_manager.py init` creates the fixed project working directories; a later default export creates a timestamped backup directory and then attempts to copy a `backup/` snapshot. The complete lifecycle is:
+`project_manager.py init` creates the fixed project working directories; a later default export creates a timestamped backup directory and then attempts to copy a `backup/` snapshot. The explicit test-only [`quick-test`](../skills/ppt-master/workflows/profiles/quick-test.md) profile bypasses that lifecycle and creates only `svg_output/` plus the PPTX destination. The normal delivery lifecycle is:
| Directory | Role |
|---|---|
@@ -263,7 +263,7 @@ Two converter design choices still shape the system:
| `icons/` | project-local icon set copied by `icon_sync.py`; global library fallback at export exists only for legacy compatibility |
| `templates/` | copied template specs / SVG references / non-image template assets |
| `svg_output/` | the only hand-authored SVG source directory |
-| `svg_final/` | mandatory derived visual-preview SVGs; supported bitmap/SVG resources are inlined when possible, while EMF/WMF retain an external-reference exception; used for IDE/browser preview or manual insertion as SVG pictures |
+| `svg_final/` | mandatory normal-flow derived visual-preview SVGs; supported bitmap/SVG resources are inlined when possible, while EMF/WMF retain an external-reference exception; used for IDE/browser preview or manual insertion as SVG pictures |
| `live_preview/` | preview server state, edit history, and annotation logs |
| `notes/` | `total.md` and split per-slide speaker notes |
| `validation/` | SVG quality reports and PPTX postflight audit reports |
@@ -288,7 +288,7 @@ These invariants are stronger than ordinary implementation preferences. If a cha
| Planning context is retained until invalidated | continuous execution reuses the complete Design Spec, lock, and triggered references; fresh/resumed/restarted or compacted execution reloads them once |
| `page-context` is on demand | the read-only projector supports diagnostics, deterministic routing checks, and optional usage telemetry; it is not a pre-page gate |
| `svg_output/` is the only hand-authored SVG directory | quality checks, manual edits, re-export, and `update_spec.py` target authored source |
-| `svg_final/` is mandatory but derived | it is regenerated from `svg_output/` for visual preview or manual insertion as an SVG picture; supported resources are inlined when possible while EMF/WMF retain an external-reference exception, and it never becomes the native export source of truth |
+| `svg_final/` is mandatory but derived in normal delivery | it is regenerated from `svg_output/` for visual preview or manual insertion as an SVG picture; supported resources are inlined when possible while EMF/WMF retain an external-reference exception, and it never becomes the native export source of truth; quick-test skips this artifact |
| Native PPTX export reads `svg_output/` by default | converter preserves icons, `preserveAspectRatio`, rounded rects, and native image crop metadata before finalization rewrites them |
| PowerPoint Convert to Shape is outside the compatibility contract | `svg_final/` may be inserted as an SVG picture, but the converted structure and visual result are not guaranteed and do not constrain the supported SVG feature set |
| Direct OOXML routes do not enter the SVG pipeline | preservation workflows patch native PPTX parts directly |
@@ -532,7 +532,7 @@ Validation JSON files are cold audit artifacts, not routine model inputs. The ex
This is easy to miss when reading the code. Shared cleanup modules, the local-reference expander, and the inline-geometry materializer are used both to write `svg_final/` and in memory during native conversion. The checker, editor, and structure parser also share parts of the geometry interpretation, but they are not artifact consumers in this section.
-**Disk consumer** — `finalize_svg.py` writes `svg_output/` → `svg_final/` once per run, expanding both project icon placeholders and qualified local `<use>` references. This mandatory output feeds IDE/browser preview and may be inserted manually as an SVG picture; it is not converted into a separate PPTX artifact.
+**Disk consumer** — in normal delivery, `finalize_svg.py` writes `svg_output/` → `svg_final/` once per run, expanding both project icon placeholders and qualified local `<use>` references. This mandatory normal-flow output feeds IDE/browser preview and may be inserted manually as an SVG picture; it is not converted into a separate PPTX artifact. Quick-test skips the disk consumer.
**Memory consumer** — native pptx generation reads `svg_output/` directly (no disk hop). It materializes author SVG inline geometry, expands project icon placeholders, materializes geometry injected by those icons, expands qualified local `<use>` references, and finally processes positional text runs:
diff --git a/docs/zh/faq.md b/docs/zh/faq.md
index 3fbdd437..c34fde7b 100644
--- a/docs/zh/faq.md
+++ b/docs/zh/faq.md
@@ -79,9 +79,9 @@ python3 skills/ppt-master/scripts/update_repo.py
## Q: 生成的 PPT 可以编辑吗?
-可以。唯一受支持的 PPTX 产物路线,是由项目转换器读取 `svg_output/` 并生成原生 DrawingML `.pptx`;文字、图形和颜色无需额外转换即可编辑,文件以时间戳命名保存至 `exports/`。Executor 的原始 SVG 源(`svg_output/` 副本)始终镜像到 `backup/<timestamp>/svg_output/`,便于归档或基于该版重跑 `finalize_svg → svg_to_pptx` 重建 PPTX,无需再走 LLM。
+可以。SVG 管线统一由项目转换器读取 `svg_output/` 并生成原生 DrawingML `.pptx`;文字、图形和颜色无需额外转换即可编辑,文件以时间戳命名保存至 `exports/`。在正式交付流程中,Executor 的原始 SVG 源(`svg_output/` 副本)会镜像到 `backup/<timestamp>/svg_output/`,便于归档或基于该版重跑 `finalize_svg → svg_to_pptx` 重建 PPTX,无需再走 LLM。
-Step 7 仍会强制生成 `svg_final/`。其中每页都是自包含的视觉预览 SVG,可直接在浏览器或 IDE 中打开,也可作为 SVG 图片手动插入 PowerPoint;项目只保证其作为预览或图片显示,不保证 PowerPoint 手工“转换为形状”后的结果。需要可编辑形状时,请使用 `exports/` 中由项目转换器生成的原生 PPTX。
+正式交付的 Step 7 仍会强制生成 `svg_final/`。其中每页都是自包含的视觉预览 SVG,可直接在浏览器或 IDE 中打开,也可作为 SVG 图片手动插入 PowerPoint;显式快速测试会跳过预览和备份产物。项目只保证 `svg_final/` 作为预览或图片显示,不保证 PowerPoint 手工“转换为形状”后的结果。需要可编辑形状时,请使用 `exports/` 中由项目转换器生成的原生 PPTX。
## Q: 为什么一段正文被拆成了好几个文本框?能不能一段一个文本框?
@@ -198,6 +198,12 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto --animation-t
如果感觉生成很慢,检查一下模型的 token 吞吐速度。瓶颈通常在模型的输出速度,而不是脚本本身。
+## Q: 临时测试几页 PPT,可以走快速模式吗?
+
+可以。请明确说明这是一次**快速测试**,并给出少量、固定、自包含的页面清单。Generate 路线会启用 [`quick-test` profile](../../skills/ppt-master/workflows/profiles/quick-test.md):AI 直接手写 `svg_output/`,随后调用测试专用的直接导出器。
+
+该模式只产出 SVG 页面和一个 PPTX;不会做源文件转换、事实研究、策略师规划与确认、模板套用、素材获取、Live Preview、质量报告、讲稿、`svg_final/`、备份、动画或旁白。正式交付、需要事实或源文件、依赖外部素材/模板/原生图表表格,或要求复用时,仍走标准流程。
+
## Q: 长 PPT 一次生成会不会上下文爆掉?
默认推荐**一次性连续生成**——10–15 页的 deck 在 200K 上下文窗口下完全够用,跨页视觉一致性也最好(Executor 看到前几页 SVG 后会主动对齐风格、字号、节奏)。
diff --git a/skills/ppt-master/references/shared-standards-core.md b/skills/ppt-master/references/shared-standards-core.md
index f2026642..15d483cf 100644
--- a/skills/ppt-master/references/shared-standards-core.md
+++ b/skills/ppt-master/references/shared-standards-core.md
@@ -424,8 +424,10 @@ helper cannot write a project, select layout, or generate a page.
**Authoring paint boundary**: v1 accepts `none` or six-digit solid HEX fill and
stroke, optional fill/stroke opacity, stroke width, line cap, and line join.
-Generated pages use `spec_lock.md` for stable semantic color anchors and choose
-page-local paint from the retained Design Spec, style, and composition context;
+Normal generated pages use `spec_lock.md` for stable semantic color anchors and
+choose page-local paint from the retained Design Spec, style, and composition context.
+The test-only [`quick-test`](../workflows/profiles/quick-test.md) profile has no
+lock: keep every chosen paint value explicit in the SVG.
`create-template` authored templates take their values from the confirmed brief
and template `design_spec.md`.
Use ordinary SVG for gradients, patterns, filters, or other treatments outside
@@ -528,7 +530,7 @@ continue without modification.
## 3. Canvas Format Quick Reference
-Use the already locked canvas id and exact viewBox. [`canvas-formats.md`](canvas-formats.md) owns format selection; this core owns only SVG conformance on that canvas.
+Use the already locked canvas id and exact viewBox. [`canvas-formats.md`](canvas-formats.md) owns format selection; this core owns only SVG conformance on that canvas. The test-only [`quick-test`](../workflows/profiles/quick-test.md) profile has no lock; its first SVG establishes the canvas and every remaining page must use the identical viewBox.
---
@@ -550,13 +552,15 @@ Use the already locked canvas id and exact viewBox. [`canvas-formats.md`](canvas
Semantic markers are minimal compiler hints. Flat pages declare one root `data-pptx-page-role` and omit Master/Layout/layer/placeholder markers. Structured pages carry their final root identity, layer atoms, slots, and native-object metadata from authoring start and omit `data-pptx-page-role`. Use `data-pptx-role` with a stable `id` only when no specialized marker expresses page-frame behavior. Keep ordinary visible content in SVG attributes/text; [`semantic-svg.md`](semantic-svg.md) owns the vocabulary.
- **Canvas authority**: New authoring writes `viewBox="0 0 W H"` with positive
- integer pixels from the lock. Numerically equivalent spellings and positive
+ integer pixels from the lock, or from the first SVG when the explicit
+ `quick-test` profile is active. Numerically equivalent spellings and positive
fractional imported dimensions remain compatible; export quantizes once at
`1 SVG px = 9,525 EMU`. Invalid/non-finite values, non-zero origin,
non-positive size, or unsupported PowerPoint dimensions are errors. All pages
- and Layout prototypes in one build share the numeric canvas and match
- `spec_lock.md canvas.viewBox`; standalone templates match `design_spec.md
- canvas_viewbox`. Optional root `width`/`height` do not override `viewBox`.
+ and Layout prototypes in one normal build share the numeric canvas and match
+ `spec_lock.md canvas.viewBox`; quick-test pages match the first SVG;
+ standalone templates match `design_spec.md canvas_viewbox`. Optional root
+ `width`/`height` do not override `viewBox`.
Root `<svg>` transform is forbidden; nested crop and `<symbol viewBox>` keep
their own contracts.
- **Font portability**: font families used by the deck must resolve to installed
@@ -576,7 +580,7 @@ These forms are needed only when the stated PPT behavior matters:
| One editable PPT text frame with mixed inline formatting or wrapped prose | Keep one logical paragraph in one `<text>`. Use non-positional `<tspan>` children for inline runs. Keep the first wrapped line as direct text and put each later line in a direct positioned `<tspan>` that repeats the parent `x` and uses positive relative `dy`; an all-`<tspan>` form may start with `dy="0"`. Same-size, evenly stacked lines flow in the current paragraph; a font-size change, list marker, or larger accepted gap starts another paragraph in that frame. Sibling `<text>` elements are forbidden as line breaks for one paragraph; they remain valid for semantically independent frames. |
| Stable object grouping or object-level animation anchor | Wrap the intended object in `<g id="...">`. Content grouping is **mandatory** per §4.3 — a top-level `<g id>` is also the animation anchor; it is not an optional convenience. |
| Native PowerPoint background promotion | Outside structured mode, the first eligible visual layer may be a direct full-canvas `<rect>` or one inside a simple single-child group. Its fill must have a registered native mapping (solid, linear/radial gradient, or preset pattern), and it must have no transform, filter, clip, rounding, or visible stroke. Export writes the fill as Slide `p:bg`; image elements remain pictures. Structured routes use the narrower explicit solid-background ownership contract in [`pptx-structure-interface.md`](./pptx-structure-interface.md). |
-| Free-design / brand-only PowerPoint structure | Use `pptx_structure.mode: flat`. Keep every represented object Slide-local; export materializes one clean project-owned Master plus one Blank Layout from the current lock, removes stock content placeholders/Layout inventory, and retains only the standard date/footer/slide-number capability hooks. Do not author Master/Layout identities, layers, or placeholder slots. |
+| Free-design / brand-only PowerPoint structure | Use `pptx_structure.mode: flat`. Keep every represented object Slide-local; export materializes one clean project-owned Master plus one Blank Layout from the current lock, removes stock content placeholders/Layout inventory, and retains only the standard date/footer/slide-number capability hooks. Do not author Master/Layout identities, layers, or placeholder slots. Quick-test uses the same flat object ownership but converter-default theme scaffolding because no lock exists. |
| Reusable template-based PowerPoint Layout | Select one complete authoring SVG per page in `page_layouts`, declare each unique Master/Layout definition once, and assign pages through `page_pptx_layouts`. Strict preserves the prototype contract; adaptive retains its Master and uses a current or new Layout key already declared and assigned by Strategist. Construction cannot extend or mutate that mapping downstream. Non-mirror skin follows `spec_lock`. |
**Hard rule — supported shape conversion**: Every PPT editability claim in this specification refers to the project converter reading `svg_output/` and emitting native DrawingML. `svg_final/` is a self-contained visual preview that may be inserted into PowerPoint as an SVG picture. PowerPoint's manual Convert-to-Shape operation is unsupported; do not narrow the authoring contract to its undocumented SVG subset.
@@ -640,9 +644,12 @@ separate parent content group; never put them inside the preset group itself.
## 5. Workflow Authority
-The serial post-processing and export workflow belongs to
-[`generate-pptx.md`](../workflows/generate-pptx.md) Step 7. This file defines SVG authoring boundaries
-and intentionally does not mirror commands, flags, or output behavior.
+The normal serial post-processing and export workflow belongs to
+[`generate-pptx.md`](../workflows/generate-pptx.md) Step 7. The explicit
+test-only exception belongs to
+[`quick-test.md`](../workflows/profiles/quick-test.md). This file defines SVG
+authoring boundaries and intentionally does not mirror commands, flags, or
+output behavior.
---
@@ -650,5 +657,5 @@ and intentionally does not mirror commands, flags, or output behavior.
## 8. Scope Boundary
Generate project structure, commands, quality-gate order, and export products
-are owned by [`generate-pptx.md`](../workflows/generate-pptx.md). They are
-intentionally outside this SVG authoring policy.
+are owned by [`generate-pptx.md`](../workflows/generate-pptx.md) and its
+selected profile. They are intentionally outside this SVG authoring policy.
diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.md
index 03246d65..21e9cb62 100644
--- a/skills/ppt-master/scripts/docs/svg-pipeline.md
+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md
@@ -304,18 +304,33 @@ warning and uses `flat`; no SVG regeneration is required. A missing `spec_lock.m
an explicit legacy/unknown mode, or a requested `structured` export without an
explicit current structured contract remains blocking.
+Disposable few-page converter/layout tests may use the explicit
+[`quick-test`](../../workflows/profiles/quick-test.md) profile:
+
+```bash
+python3 scripts/svg_to_pptx.py <project_path> --quick-test
+```
+
+This test-only flag reads `svg_output/` directly, infers one consistent canvas,
+uses flat converter-default package scaffolding, disables notes and motion, and
+does not read or require `spec_lock.md`. It writes the PPTX only: no
+`backup/`, conversion trace, or `validation/` report. ZIP integrity and Slide
+count are checked in memory and reported through
+`[QUICK-TEST] status=passed`. The flag rejects options that would add native
+data objects, motion, narration, alternate SVG sources, or diagnostic sidecars.
+
For generated-project narration, follow the
[`generate-audio`](../../workflows/stages/generate-audio.md) stage. It owns voice
selection, audio generation, and the narrated re-export workflow.
Behavior:
-- Default output (default-flow mode, no `-o`):
+- Default output (normal flow, no `-o`):
- `exports/<project_name>_<timestamp>.pptx` — native editable pptx (canonical output)
- `validation/<project_name>_<timestamp>.report.json` — package postflight, quality-gate linkage, unresolved resource audit, and published part counts
- `backup/<timestamp>/svg_output/` — copy of Executor SVG source, always written so the pptx can be rebuilt via `finalize_svg → svg_to_pptx` without re-running the LLM
- `exports/` contains only final PPTX deliverables; machine-readable quality and postflight reports belong in `validation/`.
-- `finalize_svg.py` always creates `svg_final/` before export. This directory is the self-contained SVG visual preview; it is not packaged as a second PPTX.
-- Explicit `-o/--output` changes the native PPTX destination and skips `backup/`; its postflight report still uses the output stem under the project `validation/` directory.
+- Normal flow always runs `finalize_svg.py` before export. This directory is the self-contained SVG visual preview; it is not packaged as a second PPTX. Quick-test deliberately skips it.
+- In normal flow, explicit `-o/--output` changes the native PPTX destination and skips `backup/`; its postflight report still uses the output stem under the project `validation/` directory. Quick-test writes no report.
- Postflight reruns ZIP integrity and published Slide count. Internal relationships,
structured-package validation, transitions, and animations are enforced before the
builder publishes the PPTX and are reported as `enforced-at-build`, not as repeated
@@ -350,11 +365,11 @@ Behavior:
- `[Content_Types].xml` is generated from the actual media extensions written into the PPTX. Unknown media extensions fail unless Python's `mimetypes` can identify them.
- Native export writes to a temporary file first and publishes the requested PPTX only after conversion succeeds. A failed conversion does not replace the main output file.
- `--conversion-trace` without a path writes `validation/<output_stem>.trace.json`. `--conversion-trace <path>` respects the explicit destination; relative paths are resolved from the project root, so `exports/<name>.trace.json` remains available when intentionally requested.
-- After publication, native export writes `validation/<output_stem>.report.json`. The report distinguishes authored Slides from internal Layout definitions, reruns ZIP integrity and published Slide-count checks, records slide/layout/master/notes part counts, labels relationship/structured/transition/animation validation as enforced at build time, links the final SVG quality report only when its SHA-256 source fingerprint matches the exact export inputs, and surfaces stale/unverified gates, unresolved template tokens, generic-only font stacks, and external image references. A matching final quality report with introduced warnings yields `passed-with-warnings` and a `quality_introduced_warnings=<N>` receipt instead of a clean `passed` claim.
+- After normal-flow publication, native export writes `validation/<output_stem>.report.json`. The report distinguishes authored Slides from internal Layout definitions, reruns ZIP integrity and published Slide-count checks, records slide/layout/master/notes part counts, labels relationship/structured/transition/animation validation as enforced at build time, links the final SVG quality report only when its SHA-256 source fingerprint matches the exact export inputs, and surfaces stale/unverified gates, unresolved template tokens, generic-only font stacks, and external image references. A matching final quality report with introduced warnings yields `passed-with-warnings` and a `quality_introduced_warnings=<N>` receipt instead of a clean `passed` claim.
- By default, a successful command also prints a compact receipt instead of requiring a report read: `[POSTFLIGHT] status=<...> quality_gate=<...> slides=<N> warning_categories=<N>`, followed by one compact line per warning category and the `[PPTX]` / `[REPORT]` paths. Resource-warning lines carry counts; a non-passing quality gate carries its status. Routine agents use this receipt and do not load either complete validation JSON into model context. Full reports remain cold audit artifacts; failure investigation and explicit audits extract only the required fields. `--quiet` keeps suppressing successful-run output.
- Before publishing structured template output, export reopens the temporary PPTX and validates the Slide → Layout → Master graph and registrations, Layout identity, placeholder identity, reusable bounds, and prompt/level-one sizes. A mismatch aborts publication. Flat release instead validates its single referenced Master/Layout shell and exact date/footer/slide-number hook roster before packaging.
- SVG clip paths are still restricted for authored SVGs, but nested crop wrappers generated by PPTX import are mapped back to native picture crop / geometry when possible.
-- Speaker notes are embedded automatically unless `--no-notes` is used
+- Normal flow embeds speaker notes automatically unless `--no-notes` is used; quick-test always disables them
- Recorded narration is opt-in:
- `notes_to_audio.py` uses `edge-tts` by default, or a configured cloud TTS provider (`elevenlabs`, `minimax`, `qwen`, `cosyvoice`), and generates one audio file per slide into `audio/`
- Narration text is read strictly from the matching `notes/*.md` file; the script only skips Markdown heading lines (`# ...`) and does not summarize, rewrite, or filter delivery notes
diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
index 0a276c91..b296d732 100644
--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py
@@ -469,6 +469,30 @@ def _print_postflight_receipt(receipt: _PostflightReceipt) -> None:
print(f' [REPORT] {receipt.report_path}')
+def _validate_quick_test_output(
+ output_path: Path,
+ *,
+ expected_slide_count: int,
+) -> dict[str, object]:
+ """Validate a quick-test PPTX without writing a report sidecar."""
+ try:
+ package = _package_part_counts(output_path)
+ except (OSError, zipfile.BadZipFile) as exc:
+ raise PptxPostflightValidationError(
+ f"quick-test PPTX is not a readable ZIP package: {exc}"
+ ) from exc
+ if package['zip_integrity'] != 'passed':
+ raise PptxPostflightValidationError(
+ f"quick-test PPTX ZIP integrity failed at {package['corrupt_member']}"
+ )
+ if package['slides'] != expected_slide_count:
+ raise PptxPostflightValidationError(
+ "Quick-test Slide count does not match authored SVG count: "
+ f"{package['slides']} != {expected_slide_count}"
+ )
+ return package
+
+
def _declared_pptx_structure_mode(project_path: Path) -> str | None:
"""Return the explicitly locked SVG export mode, if the lock declares one."""
lock_path = project_path / 'spec_lock.md'
@@ -666,6 +690,7 @@ def main(argv: list[str] | None = None) -> int:
Examples:
%(prog)s examples/ppt169_demo # Default: native pptx -> exports/, svg_output -> backup/<ts>/
%(prog)s examples/ppt169_demo -o out.pptx # Explicit path (no backup/)
+ %(prog)s projects/_smoke_quick --quick-test # Test-only: svg_output/ -> PPTX, no sidecars
# Disable transition / change transition effect
%(prog)s examples/ppt169_demo -t none
@@ -740,6 +765,17 @@ Recorded narration:
choices=list(CANVAS_FORMATS.keys()), default=None,
help='Require SVG canvases to match this registered format')
parser.add_argument('-q', '--quiet', action='store_true', help='Quiet mode')
+ parser.add_argument(
+ '--quick-test',
+ action='store_true',
+ help=(
+ 'Test-only direct export of a small fixed SVG roster from '
+ 'svg_output/. Infer one consistent canvas from the SVGs, use a flat '
+ 'package with converter defaults, and skip spec_lock.md, notes, '
+ 'animations, backup, conversion trace, and validation report '
+ 'artifacts.'
+ ),
+ )
merge_group = parser.add_mutually_exclusive_group()
merge_group.add_argument('--merge-paragraphs', action='store_true', dest='merge_paragraphs',
@@ -906,6 +942,49 @@ Recorded narration:
file=sys.stderr,
)
+ if args.quick_test:
+ conflicts: list[str] = []
+ if args.source not in {None, 'output'}:
+ conflicts.append('--source must be omitted or output')
+ if args.pptx_structure not in {None, 'flat'}:
+ conflicts.append('--pptx-structure must be omitted or flat')
+ if args.conversion_trace is not None:
+ conflicts.append('--conversion-trace')
+ if args.native_objects:
+ conflicts.append('--native-charts-and-tables')
+ if args.animation_config:
+ conflicts.append('--animation-config')
+ if args.recorded_narration:
+ conflicts.append('--recorded-narration')
+ if args.narration_audio_dir:
+ conflicts.append('--narration-audio-dir')
+ if args.use_narration_timings:
+ conflicts.append('--use-narration-timings')
+ if args.auto_advance is not None:
+ conflicts.append('--auto-advance')
+ if args.transition is not None or args.transition_duration is not None:
+ conflicts.append('transition overrides')
+ if any(
+ value is not None
+ for value in (
+ args.animation,
+ args.animation_duration,
+ args.animation_trigger,
+ args.animation_stagger,
+ )
+ ):
+ conflicts.append('animation overrides')
+ if conflicts:
+ print(
+ "Error: --quick-test cannot be combined with: "
+ + ", ".join(conflicts),
+ file=sys.stderr,
+ )
+ return 1
+ args.no_notes = True
+ args.no_animations = True
+ args.pptx_structure = 'flat'
+
project_path = Path(args.project_path)
if not project_path.exists():
print(f"Error: Path does not exist: {project_path}")
@@ -915,13 +994,17 @@ Recorded narration:
native_structure_contract = None
pptx_structure = args.pptx_structure
lock_path = project_path / 'spec_lock.md'
- if not lock_path.is_file():
+ if not args.quick_test and not lock_path.is_file():
print(
"Error: spec_lock.md is required for release SVG export",
file=sys.stderr,
)
return 1
- declared_structure_mode = _declared_pptx_structure_mode(project_path)
+ declared_structure_mode = (
+ None
+ if args.quick_test
+ else _declared_pptx_structure_mode(project_path)
+ )
if pptx_structure in _LEGACY_PPTX_STRUCTURE_MODES:
_print_structure_contract_error(pptx_structure)
return 1
@@ -968,7 +1051,7 @@ Recorded narration:
theme_font_spec = None
master_text_style_spec = None
theme_color_spec = None
- if pptx_structure in {'flat', 'structured'}:
+ if pptx_structure in {'flat', 'structured'} and not args.quick_test:
try:
theme_font_spec = load_theme_font_spec(project_path)
master_text_style_spec = load_master_text_style_spec(project_path)
@@ -1008,8 +1091,12 @@ Recorded narration:
project_name = project_path.name
canvas_format = args.format
- expected_viewbox = _declared_canvas_viewbox(project_path)
- if expected_viewbox is None:
+ expected_viewbox = (
+ None
+ if args.quick_test
+ else _declared_canvas_viewbox(project_path)
+ )
+ if expected_viewbox is None and not args.quick_test:
print(
"Error: spec_lock.md must contain canvas.viewBox for release export",
file=sys.stderr,
@@ -1140,7 +1227,8 @@ Recorded narration:
narrated_tag = "_narrated" if (args.recorded_narration or args.narration_audio_dir) else ""
native_path = exports_dir / f"{project_name}_{timestamp}{native_tag}{narrated_tag}.pptx"
# Preserve the authored svg_output/ beside every default-flow export.
- backup_dir = project_path / "backup" / timestamp
+ if not args.quick_test:
+ backup_dir = project_path / "backup" / timestamp
native_path.parent.mkdir(parents=True, exist_ok=True)
@@ -1445,7 +1533,7 @@ Recorded narration:
# are still stamped at export; only the authored fields stay blank.
doc_metadata = None
metadata_path = project_path / 'metadata.json'
- if metadata_path.is_file():
+ if metadata_path.is_file() and not args.quick_test:
try:
loaded = json.loads(metadata_path.read_text(encoding='utf-8'))
except (json.JSONDecodeError, OSError) as exc:
@@ -1569,6 +1657,31 @@ Recorded narration:
print(f" [info] svg_output/ not found, backup skipped")
if success:
+ if args.quick_test:
+ try:
+ package = _validate_quick_test_output(
+ native_path,
+ expected_slide_count=len(native_files),
+ )
+ except PptxPostflightValidationError as exc:
+ print(
+ "Error: quick-test PPTX failed in-memory validation and "
+ f"must not be used: {exc}",
+ file=sys.stderr,
+ )
+ print(
+ f" Invalid output remains at: {native_path}",
+ file=sys.stderr,
+ )
+ return 1
+ if verbose:
+ print(
+ " [QUICK-TEST] "
+ f"status=passed slides={package['slides']} "
+ "sidecars=none"
+ )
+ print(f" [PPTX] {native_path}")
+ return 0
try:
receipt = _write_postflight_report(
output_path=native_path,
diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.md
index be17a582..ae57a454 100644
--- a/skills/ppt-master/workflows/generate-pptx.md
+++ b/skills/ppt-master/workflows/generate-pptx.md
@@ -6,7 +6,7 @@ description: Generate PPTX route authority for source intake, planning, SVG auth
> Load only after [`routing.md`](./routing.md) selects Generate PPTX. This file owns the route's Step 1–7 sequence, gates, role switching, and mandatory commands.
-**Core Pipeline**: `Initial Materials → [Fact Research] → Create Project → [Template] → Strategist Structured Plan → [Image Acquisition] → Executor Live Preview → Quality Check → Post-processing → Export`
+**Default Core Pipeline**: `Initial Materials → [Fact Research] → Create Project → [Template] → Strategist Structured Plan → [Image Acquisition] → Executor Live Preview → Quality Check → Post-processing → Export`
**Generate-specific execution discipline**:
@@ -15,6 +15,18 @@ description: Generate PPTX route authority for source intake, planning, SVG auth
- `preset_shape_svg.py` and `shape_boolean_svg.py` may provide only their documented stdout fragment(s) after the main agent chooses the object's role, operands, paint, and z-order; neither helper chooses layout or writes a page.
- Gate checklists are internal verification, not user-facing output. On success, continue automatically and emit at most one compact status line when useful; on failure, report only the blocking items and required recovery.
+### Quick Test Profile Short Circuit
+
+When the user explicitly requests quick/fast mode for a disposable test with a
+small fixed roster of self-contained slides, load and follow
+[`quick-test.md`](./profiles/quick-test.md). That profile owns the complete
+test-only sequence and skips this route's Steps 1–7.
+
+**Hard rule — no implicit downgrade**: page count alone never selects quick
+test. Normal delivery, source conversion, factual research, template use,
+external assets, native data objects, notes, animation, narration, and reusable
+output remain on the default pipeline below.
+
### SVG Page-Design Boundary
| Scope | Contract |
@@ -22,7 +34,7 @@ description: Generate PPTX route authority for source intake, planning, SVG auth
| Any route that authors or regenerates slide visuals through SVG | `svg_output/` is the complete page-design source: every visible text, image, shape, chart/table fallback, and layout element that should appear on the exported slide is present in that page SVG or referenced by it. |
| Templates, `design_spec.md`, and `spec_lock.md` | Authoring/control inputs. They guide SVG creation but MUST NOT supply visible slide content that is absent from the completed SVG during export. |
| Semantic SVG markers | Minimal rendering-neutral compiler hints used only after existing Layout/Layer/Placeholder/Native metadata has been considered. They never replace native SVG geometry, text, styles, grouping, or asset references. |
-| `svg_final/` | Mandatory derived, self-contained SVG visual preview. It may be opened directly or inserted into PowerPoint as an SVG picture, but it is not a supported PPTX source and carries no manual Convert-to-Shape compatibility contract. |
+| `svg_final/` | Mandatory derived, self-contained SVG visual preview in the default pipeline. It may be opened directly or inserted into PowerPoint as an SVG picture, but it is not a supported PPTX source and carries no manual Convert-to-Shape compatibility contract. Quick-test skips it. |
| SVG-to-PPTX export | The only supported generated-PPTX route reads `svg_output/` and maps its content through the project converter to DrawingML/native objects. It compiles only the selected route's explicit structure contract: `flat` keeps represented content Slide-local, while `structured` may place explicitly scoped content in Master/Layout/Slide parts. It MUST NOT infer structure, upgrade `flat`, or invent new visible page content. |
| Native PPTX routes and presentation-behavior stages | Remain outside SVG page-design closure. `template-fill-pptx`, `native-enhance-pptx`, animations, transitions, speaker notes, narration, and package relationships are not required to round-trip through SVG. |
@@ -146,7 +158,7 @@ Bare names, style descriptions, brand mentions, vague template intent, and silen
---
-### Step 4: Strategist Phase (MANDATORY — cannot be skipped)
+### Step 4: Strategist Phase (MANDATORY in the default pipeline)
🚧 **GATE**: Step 3 complete; default free-design path taken, or (if triggered) template files copied or confirmed in place in the project.
diff --git a/skills/ppt-master/workflows/profiles/quick-test.md b/skills/ppt-master/workflows/profiles/quick-test.md
new file mode 100644
index 00000000..a14df386
--- /dev/null
+++ b/skills/ppt-master/workflows/profiles/quick-test.md
@@ -0,0 +1,105 @@
+---
+description: Test-only Generate profile for authoring a few SVG slides and exporting one PPTX without normal planning or sidecar artifacts.
+---
+
+# Quick Test Profile
+
+> Generate-PPTX profile, not a top-level route. Use it only for disposable
+> converter/layout tests; normal presentation delivery stays on
+> [`generate-pptx.md`](../generate-pptx.md) Steps 1–7.
+
+**Trigger**: the user explicitly requests quick/fast test mode, identifies the
+deck as a test, and asks for a small fixed slide roster. A small page count alone
+never activates this profile.
+
+---
+
+## 1. Eligibility
+
+| Condition | Required state |
+|---|---|
+| Intent | Explicit disposable test, not a presentation delivery |
+| Page roster | Small, fixed, and named or directly inferable |
+| Content | Supplied in chat and sufficient to draw without conversion or research |
+| Visual inputs | Plain SVG geometry/text, or already supplied self-contained data; no asset acquisition |
+| Output | Only authored SVG pages and one native PPTX |
+
+**Missing eligibility** → use the normal Generate pipeline. Do not ask the user
+to weaken a normal delivery request so it can enter this profile.
+
+**Hard rule — explicit scope only**: this profile never activates for a factual
+deck, a template-backed deck, source-file conversion, native charts/tables,
+external images/icons/fonts, speaker notes, animation, narration, visual
+review, or any reusable deliverable.
+
+---
+
+## 2. Minimal Authoring Contract
+
+Read only [`shared-standards-core.md`](../../references/shared-standards-core.md).
+Load one of its conditional modules only when the user's exact SVG test needs
+that registered feature; otherwise keep the SVG surface to solid paint, basic
+geometry, text, and semantic groups.
+
+Create only:
+
+```text
+<project_path>/
+├── svg_output/
+│ └── <ordered-page>.svg
+└── exports/
+ └── <project_name>_<timestamp>.pptx
+```
+
+**Hard rule — no normal-pipeline artifacts**: do not run source conversion,
+`project_manager.py init`, topic research, template application, Strategist,
+Confirm UI, image/icon acquisition, Live Preview, SVG quality checker,
+speaker-note generation, `finalize_svg.py`, chart verification, animation,
+narration, or any supporting stage. Do not create `design_spec.md`,
+`spec_lock.md`, `sources/`, `analysis/`, `images/`, `icons/`, `templates/`,
+`confirm_ui/`, `notes/`, `svg_final/`, `validation/`, `backup/`, or metadata
+sidecars.
+
+**Canvas**: write `viewBox="0 0 W H"` on every page. The first SVG establishes
+the test canvas; every remaining page must match it exactly.
+
+**Structure**: author flat, Slide-local SVG only. Include the complete visible
+page in each SVG; set one root `data-pptx-page-role` from `cover`, `toc`,
+`section`, `content`, or `ending`, and omit Master/Layout/layer/placeholder
+metadata.
+
+**Typography**: name an installed concrete font family in the SVG; do not depend
+on a lock or generated font asset.
+
+**Generation pacing**: the current main agent hand-writes the fixed SVG roster
+in order. Skip the normal first-page and final checker gates.
+
+---
+
+## 3. Direct Export
+
+Run one export command after every requested SVG exists:
+
+```bash
+python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> --quick-test
+```
+
+`--quick-test` reads only `svg_output/`, infers one consistent canvas, uses a
+flat PowerPoint package with converter defaults, disables notes and motion,
+skips lock/theme sidecars, and writes no backup, conversion trace, or validation
+report. An explicit `-o <path>.pptx` may replace the default `exports/`
+destination without changing the artifact boundary.
+
+**Validation**: success requires `[QUICK-TEST] status=passed`, the authored SVG
+count to equal the published Slide count, and the PPTX to pass in-memory ZIP
+integrity. On failure, repair the owning SVG and rerun this command; do not
+create planning or validation artifacts.
+
+```markdown
+## ✅ Quick Test Complete
+
+- [x] Requested SVG pages exist under `svg_output/`
+- [x] One native PPTX exists under `exports/` or the explicit output path
+- [x] No normal-pipeline artifacts were created
+- [ ] **Next**: Report the PPTX path
+```
diff --git a/skills/ppt-master/workflows/routing.md b/skills/ppt-master/workflows/routing.md
index 40371439..eeff3437 100644
--- a/skills/ppt-master/workflows/routing.md
+++ b/skills/ppt-master/workflows/routing.md
@@ -30,7 +30,7 @@ route selection. After selection, the route authority owns execution.
| Route | Request shape | Authority | Preconditions | Mutation model | Output contract |
|---|---|---|---|---|---|
-| Generate PPTX | Create a new presentation; regenerate an existing deck visually; use source material or a topic; optionally apply an explicit template workspace | [`generate-pptx`](./generate-pptx.md) | Source facts exist or the topic-research stage can gather them | Author new SVG pages and export a new PPTX | New project with `design_spec.md`, `spec_lock.md`, `svg_output/`, `validation/`, and `exports/` |
+| Generate PPTX | Create a new presentation; regenerate an existing deck visually; use source material or a topic; optionally apply an explicit template workspace | [`generate-pptx`](./generate-pptx.md) | Source facts exist or the topic-research stage can gather them; explicit `quick-test` supplies self-contained test content | Author new SVG pages and export a new PPTX | Default pipeline: project with `design_spec.md`, `spec_lock.md`, `svg_output/`, `validation/`, and `exports/`; explicit `quick-test`: only `svg_output/` plus one PPTX |
| Create Template | Create a reusable brand/layout/deck template from one or more PPTX/SVG files, images/PDFs, direct or file-based text, documents/websites, brand assets, or a mixed reference bundle | [`create-template`](./create-template.md) | A reusable-template request exists; reference material is optional, and project scope additionally requires an initialized target project | Author a new portable workspace; never modify any reference file in place | Workspace with required `templates/`, optional `images/` / `icons/`, and optional review `exports/` |
| Fill Native PPTX | Use a raw PPTX's native slide shells and replace/fill content | [`template-fill-pptx`](./template-fill-pptx.md) | Source PPTX plus new material/topic | Clone and patch PPTX through OOXML; no SVG pipeline | New filled PPTX in project `exports/` |
| Enhance Native PPTX | Keep a finished PPTX's visible slides stable while adding notes, audio, timings, or transitions | [`native-enhance-pptx`](./native-enhance-pptx.md) | Finished source PPTX exists | Append/update scoped OOXML parts; no slide regeneration | New enhanced PPTX in project `exports/` |
@@ -41,6 +41,7 @@ route selection. After selection, the route authority owns execution.
| Request condition | Generate-route behavior |
|---|---|
+| Explicit disposable test intent + explicit quick/fast mode + small fixed roster of self-contained slides | Activate [`quick-test`](./profiles/quick-test.md) inside Generate PPTX; author SVG pages and run the test-only direct exporter without entering normal Steps 1–7 |
| Topic only, or supplied sources leave planning-critical factual gaps | Run [`topic-research`](./stages/topic-research.md) inside [`generate-pptx`](./generate-pptx.md) Step 1: immediately for topic-only input, or after conversion and reading for source-backed input; research only the identified gaps, then continue Step 2 |
| Existing PPTX may be split, merged, dropped, reordered, or re-outlined | Treat the PPTX as source content through [`generate-pptx`](./generate-pptx.md) Step 1 and its PPTX intake; use the default Generate pipeline |
| Existing PPTX must preserve wording, page count, and page order 1:1 | Activate the [`beautify-pptx`](./profiles/beautify-pptx.md) profile inside the main pipeline |
@@ -57,6 +58,12 @@ route selection. After selection, the route authority owns execution.
**Hard rule — profile, not fifth route**: The 1:1 beautify behavior uses the same Strategist → Executor → SVG export lifecycle as Generate PPTX. It changes content/page invariants; it does not define a separate artifact lifecycle.
+**Hard rule — test profile, not a release shortcut**: `quick-test` stays inside
+Generate PPTX but owns a test-only SVG → PPTX short circuit. A small page count
+alone never activates it, and any reusable, factual, source-backed,
+template-backed, asset-dependent, or package-behavior request stays on the
+normal Generate pipeline.
+
---
## 4. Template and Master/Layout Boundary