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(quick-generate): preserve resource preparation without strategy
hugohe37f33d177eb71
diff --git a/AGENTS.md b/AGENTS.mdindex 7e950b7c..f295ffd6 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -6,14 +6,14 @@ This file is the project entry point for general AI agents.## Project Overview-PPT Master turns source material into natively editable DrawingML PPTX. Generate owns a default Strategist → Image_Generator → Executor pipeline and an explicit quick-generation bypass.+PPT Master turns source material into natively editable DrawingML PPTX. Generate owns the default Strategist → Image_Generator → Executor pipeline and an explicit Quick profile without a separate strategy/confirmation phase.**Route selection authority**: [`skills/ppt-master/workflows/routing.md`](skills/ppt-master/workflows/routing.md) owns the four top-level artifact routes: Generate PPTX, Create Template, Fill Native PPTX, and Enhance Native PPTX. Child workflows, profiles, stages, and governance documents refine one selected route; they are not competing top-level routes.- 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 quick/fast generation from fact-sufficient self-contained content may use [`quick-generate`](skills/ppt-master/workflows/profiles/quick-generate.md): decide structure in context, skip Strategist/confirmation, hand-author `svg_output/`, and export directly without default sidecars.+- Explicit quick/fast or skip-strategy generation may use [`quick-generate`](skills/ppt-master/workflows/profiles/quick-generate.md): prepare sources and page resources as needed, let the current agent decide without interaction, omit Strategist/confirmation/spec/lock, hand-author `svg_output/`, and export directly.- 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.@@ -28,7 +28,7 @@ PPT Master turns source material into natively editable DrawingML PPTX. Generate## Required Conventions- **Repo-wide style rules** — when editing prompt files under [`skills/ppt-master/references/`](skills/ppt-master/references/), Python under [`skills/ppt-master/scripts/`](skills/ppt-master/scripts/), or any other code/prose in the repo, follow the matching style rule in [`docs/rules/`](docs/rules/).-- **Prompt decision ownership** — follow [`docs/rules/prompt-style.md`](docs/rules/prompt-style.md) §4.1: Strategist readies project-local resources; Executor realizes the plan from that prepared pool. For icons, every SVG under `<project>/icons/` is prepared execution material, while `icons.inventory` records the Strategist's planned bundled selection rather than an execution whitelist. Never move acquisition or reselection downstream.+- **Prompt decision ownership** — follow [`docs/rules/prompt-style.md`](docs/rules/prompt-style.md) §4.1. Default Strategist prepares project-local resources and Executor realizes them; Quick's current agent decides and prepares before SVG authoring. This is not downstream acquisition. Every project icon is prepared material; `icons.inventory` records only the default plan's bundled selection.- **Markdown language consistency** — Markdown files under `skills/ppt-master/workflows/`, `skills/ppt-master/references/`, and `docs/` are currently single-language per directory. New files mirror the language of their siblings; do not mix English scaffolding with Chinese paragraphs (or vice versa) inside one file. Chat replies are unaffected.## Compatibility Boundary@@ -60,7 +60,7 @@ python3 skills/ppt-master/scripts/confirm_ui/server.py <project_path> --wait-onl# Image tools and SVG quality checkpython3 skills/ppt-master/scripts/analyze_images.py <project_path>/images-# Formula rendering — manifest written by Strategist after typography confirmation:+# Formula rendering — manifest written by Default Strategist after confirmation or by the Quick main agent during resource preparation:python3 skills/ppt-master/scripts/latex_render.py <project_path>python3 skills/ppt-master/scripts/latex_render.py <project_path> --dry-runpython3 skills/ppt-master/scripts/latex_render.py <project_path> --providers codecogs,quicklatex,mathpad,wikimediadiff --git a/README.md b/README.mdindex 133e16e2..467783cc 100644--- a/README.md+++ b/README.md@@ -316,7 +316,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 converter: it reads `svg_output/` and writes a directly editable native DrawingML deck to `exports/<name>_<timestamp>.pptx`. The default Generate 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 quick generation from fact-sufficient self-contained content may instead use [quick-generate mode](./skills/ppt-master/workflows/profiles/quick-generate.md): the agent decides the page structure in active context, skips Strategist and confirmation, writes the SVG pages, and exports one PPTX without preview, notes, validation reports, 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 chart/table export variants 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 default Generate 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 [quick generation](./skills/ppt-master/workflows/profiles/quick-generate.md) still converts sources, researches factual gaps, and prepares required images, icons, formulas, and resource manifests when needed. The current agent makes the content, page, visual, and resource decisions in context, skips Strategist, confirmation, `design_spec.md`, and `spec_lock.md`, then hand-authors the SVG pages and exports one PPTX without preview, notes, validation reports, or backup artifacts. By default charts and tables export as individually editable SVG-derived DrawingML shapes, which prioritize cross-app visual consistency. In the default flow, 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`. The quick exporter does not accept native-object flags. Both chart/table export variants 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.mdindex 67d530b9..7cbd59ff 100644--- a/README_CN.md+++ b/README_CN.md@@ -325,7 +325,7 @@ AI:好的,先确认设计规范:AI 全程处理——内容分析、视觉设计、SVG 生成、PPTX 导出。-> **输出说明:** SVG 管线统一由项目转换器读取 `svg_output/`,生成可直接编辑的原生 DrawingML `.pptx`,保存至 `exports/<name>_<timestamp>.pptx`。默认 Generate 流程会生成自包含预览 `svg_final/`,并把 `svg_output/` 镜像到 `backup/<timestamp>/svg_output/`;PowerPoint 手工“转换为形状”不在支持范围。对事实充分、内容自包含的材料,用户可显式启用[快速生成模式](./skills/ppt-master/workflows/profiles/quick-generate.md):AI 在当前上下文直接决定页结构,跳过策略师和确认,按规范手写 SVG 后导出一个 PPTX,不生成预览、讲稿、验证报告或备份。图表和表格默认导出为 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`。默认 Generate 流程会生成自包含预览 `svg_final/`,并把 `svg_output/` 镜像到 `backup/<timestamp>/svg_output/`;PowerPoint 手工“转换为形状”不在支持范围。用户可显式启用[快速生成模式](./skills/ppt-master/workflows/profiles/quick-generate.md):仍按需转换来源、研究事实缺口,并准备图片、图标、公式和资源 manifest;当前 Agent 在上下文中自动决定内容、页结构、视觉和资源,跳过 Strategist、确认、`design_spec.md` 与 `spec_lock.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.mdindex 632dda1b..b8978160 100644--- a/docs/faq.md+++ b/docs/faq.md@@ -203,18 +203,22 @@ If generation feels slow, check your model's token throughput. The bottleneck is## Q: Can I generate directly without the Strategist phase?-Yes. Explicitly request **quick generation** and provide fact-sufficient,-self-contained content. The Generate route then uses the+Yes. Explicitly request **quick generation**. The Generate route then uses the[`quick-generate` profile](../skills/ppt-master/workflows/profiles/quick-generate.md):-the agent decides the page structure in active context, hand-authors-`svg_output/` to the shared standards, and runs the direct exporter.--This profile 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. Requests needing any skipped capability stay on the default-pipeline. Page count alone neither activates nor blocks quick generation. This-is a workflow shortcut, not a wall-clock or default-quality-equivalence promise.+source conversion and research for identified factual gaps still run when+needed, but the current agent decides the content, page structure, visual+system, and resource roster in active context without invoking Strategist,+confirmation, `design_spec.md`, or `spec_lock.md`.++The profile still prepares every resource the deck needs: supplied or extracted+images, AI/web/sliced images, project icons, rendered formulas, and the required+manifests or provenance records. After preparation, the current agent+hand-authors `svg_output/` to the shared standards and runs the direct exporter.+The shortcut still omits structured template reuse, native chart/table+replacement, Live Preview, visual-review delivery, quality-report files, notes,+`svg_final/`, backup, animation, and narration. Page count alone neither+activates nor blocks quick generation. This is a workflow shortcut, not a+wall-clock or default-quality-equivalence promise.## Q: Will long decks blow out the context window in one shot?diff --git a/docs/rules/prompt-style.md b/docs/rules/prompt-style.mdindex 2938fea4..727b303c 100644--- a/docs/rules/prompt-style.md+++ b/docs/rules/prompt-style.md@@ -97,7 +97,7 @@ Boundary cases go by this test, not by how strong the verb feels: "never split a### 4.1 Ownership Contract: Ingredients → Plan + Preparation → Realization-Constraint strength and decision ownership are independent. Preserve this chain whenever writing, compressing, or reviewing multi-role prompts:+Constraint strength and decision ownership are independent. Preserve this chain whenever writing, compressing, or reviewing the default multi-role Generate prompts:| Layer | Owns ||---|---|@@ -105,13 +105,15 @@ Constraint strength and decision ownership are independent. Preserve this chain| Strategist / plan + preparation | Assess material sufficiency; trigger permitted fact research; decide the approved content, resources, keys, identity anchors, and exact page roster; record optional capability/expression recommendations; materialize the planned project-local inventory or record an explicit `Needs-Manual` dependency before execution || Executor / realization | Use only prepared project-local assets; preserve approved content, resources, and identity anchors; realize them through geometry, composition, hierarchy, and treatment. Fields explicitly labeled `suggestion` or Reference are preferred expression rather than binding selections: Executor may adapt or decline them when content and explicit constraints remain intact. For icons, the complete `<project>/icons/` pool is prepared material and `icons.inventory` is not a whitelist; sparse local font/color garnish is allowed only while non-structural and non-recurring |-**Preparation timing**: Fact research required for planning may run before final confirmation. AI / web / slice acquisition runs only from the completed `design_spec.md §VIII` and `spec_lock.md`, after final confirmation and before Executor. Image_Generator, Image_Searcher, and icon-sync tooling execute Strategist-owned preparation; they are not independent decision owners.+**Preparation timing**: In the default pipeline, fact research required for planning may run before final confirmation. AI / web / slice acquisition runs only from the completed `design_spec.md §VIII` and `spec_lock.md`, after final confirmation and before Executor. Image_Generator, Image_Searcher, and icon-sync tooling execute Strategist-owned preparation; they are not independent decision owners.-**Hard rule**: downstream freedom exists only in dimensions left open upstream, including fields explicitly labeled `suggestion` or Reference. A named binding outcome retains identity; a broad semantic request or expression recommendation permits in-class choice. Once the plan resolves a binding choice, execution cannot reopen or substitute it. Executor never searches, generates, downloads, syncs, invents, or replaces a resource; missing material returns to Strategist-owned preparation or upstream repair.+**Hard rule — default pipeline**: downstream freedom exists only in dimensions left open upstream, including fields explicitly labeled `suggestion` or Reference. A named binding outcome retains identity; a broad semantic request or expression recommendation permits in-class choice. Once the plan resolves a binding choice, execution cannot reopen or substitute it. Executor never searches, generates, downloads, syncs, invents, or replaces a resource; missing material returns to Strategist-owned preparation or upstream repair.++**Explicit Quick Generate exception**: [`quick-generate`](../../skills/ppt-master/workflows/profiles/quick-generate.md) removes the separate Strategist/confirmation handoff. The current main agent therefore owns both its active-context decisions and the preparation of project-local sources, images, icons, formulas, and provenance before it begins SVG realization. This exception does not move acquisition into a default-pipeline Executor and does not permit resource reselection while a page is being realized. Explicit user facts, choices, exclusions, and permissions remain upstream authority; unspecified routine choices are resolved automatically without a confirmation stop.> Mnemonic — restaurant contract: the customer supplies initial ingredients and the desired dish; Strategist plans the dish and prepares the complete mise en place; Executor cooks from that prepared inventory. “Mapo tofu” cannot become tomato-and-eggs or tofu soup, while “a tofu dish” leaves deliberate in-class freedom.-**Review gate**: treat any prompt refactor that erases this ownership chain, moves acquisition into Executor, turns a permission into a quota, or turns flexible realization into silent resource/identity reselection as a semantic regression even when the compressed wording is shorter.+**Review gate**: treat any prompt refactor that erases the selected profile's ownership chain, moves acquisition into the default-pipeline Executor, turns a permission into a quota, or turns flexible realization into silent resource/identity reselection as a semantic regression even when the compressed wording is shorter.---diff --git a/docs/technical-design.md b/docs/technical-design.mdindex 44ea6f04..7a598528 100644--- a/docs/technical-design.md+++ b/docs/technical-design.md@@ -38,9 +38,11 @@ The three layers have separate responsibilities and cannot substitute for one anThe diagram below covers the default Generate PPTX lifecycle, including its`beautify-pptx` profile. The explicit `quick-generate` profile stays inside the-same route but bypasses this lifecycle. Create Template has its own workspace-lifecycle, while Fill Native PPTX and Enhance Native PPTX operate directly on-OOXML; the route table later in this document covers all four.+same route but bypasses its separate planning/confirmation and default delivery+gates; source understanding and resource preparation still run as needed.+Create Template has its own workspace lifecycle, while Fill Native PPTX and+Enhance Native PPTX operate directly on OOXML; the route table later in this+document covers all four.```User Input (PDF/DOCX/XLSX/PPTX/URL/Markdown/topic text)@@ -96,17 +98,26 @@ Output:└── svg_output/ ← A successful copy can rebuild the PPTX from frozen authored SVG```-The explicit shortcut is deliberately smaller:+The explicit shortcut removes the separate planning and confirmation phase, not+the inputs or resources needed to build the deck:```text-Fact-sufficient self-contained content- -> decide page structure and visual system in active context+Source material or topic+ -> convert/read sources and research identified factual gaps as needed+ -> decide content, page structure, visual system, and resources in active context+ -> prepare required images/icons/formulas and resource manifests-> hand-author svg_output/ under the shared SVG standards-> svg_to_pptx.py --quick-generate-> exports/<name>_<timestamp>.pptx```-Without an explicit `-o`, the native-object and narration flags may combine into `<project_name>_<timestamp>_native_charts_tables_narrated.pptx`; explicit `-o` preserves the caller-supplied filename.+These decisions are made automatically by the current agent without Strategist,+Confirm UI, `design_spec.md`, or `spec_lock.md`.++In the default flow, without an explicit `-o`, the native-object and narration+flags may combine into+`<project_name>_<timestamp>_native_charts_tables_narrated.pptx`; explicit `-o`+preserves the caller-supplied filename. Quick generation accepts neither flag.### SVG as a Constrained Page-Design Language@@ -146,7 +157,7 @@ Use this table before reasoning about implementation details. Most failed runs s|---|---|---|| Topic only, or supplied material lacks facts required by the requested outcome | Generate PPTX + `topic-research` inside Step 1 | topic-only research starts immediately; source-backed research follows conversion/read and fills only identified factual gaps || Source files or conversation text, deck structure may be rethought | Generate PPTX | Strategist may split, merge, drop, reorder, and redesign |-| Explicit quick generation from fact-sufficient self-contained text | Generate PPTX + `quick-generate` profile | decide page structure in active context, skip Strategist/confirmation/spec/lock, hand-author SVG, and export one PPTX directly |+| Explicit quick generation | Generate PPTX + `quick-generate` profile | convert/read sources, research factual gaps, and prepare required resources as needed; the current agent decides content, pages, visuals, and resources in active context, skips Strategist/confirmation/spec/lock, hand-authors SVG, and exports one PPTX directly || PPTX as source material, user allows a new story/page structure | Generate PPTX via `ppt_to_md` + `pptx_intake` | PPTX identity/geometry are facts and candidates, not replica constraints || Raw PPTX template plus new material/topic | Fill Native PPTX (`template-fill-pptx`) | clone/fill native slides; no SVG generation || Existing PPTX, preserve page count/order/wording 1:1, improve layout | Generate PPTX + `beautify-pptx` profile | regenerate through SVG; content and pagination are locked |@@ -175,9 +186,12 @@ The Executor role generates each slide as an SVG file. The output of this stage**Stage 3 — Engineering Conversion**Post-processing scripts convert supported SVG vector elements to DrawingML. Text and vector shapes stay native PowerPoint objects — clickable, editable, and restylable — while raster assets are copied as PPT picture media instead of flattening the slide into one image.-`quick-generate` skips Stage 1 and the default report-producing gates. It still-authors under the shared SVG standards and uses the same DrawingML converter,-which performs in-memory ZIP and published-Slide-count validation.+`quick-generate` retains the source-understanding and resource-preparation work+needed by the deck, but skips the separate Strategist planning/confirmation+phase and the default report-producing gates. The current agent makes those+content, page, visual, and resource decisions automatically in active context,+then authors under the shared SVG standards and uses the same DrawingML+converter, which performs in-memory ZIP and published-Slide-count validation.---@@ -204,9 +218,12 @@ design_spec.md + spec_lock.md + images/ + icons/ + templates/backup/<ts>/svg_output/ [default output path; copy is best-effort after directory creation]Quick Generate:-conversation or directly readable text/Markdown- └─> active-context page/design decisions -> svg_output/- └─> svg_to_pptx.py --quick-generate -> exports/*.pptx+source material or topic+ └─> conversion/read + factual-gap research [as needed]+ └─> active-context content/page/visual/resource decisions+ └─> images/ + icons/ + formula/resource manifests [as needed]+ └─> hand-authored svg_output/+ └─> svg_to_pptx.py --quick-generate -> exports/*.pptxDirect OOXML routes:analysis/<stem>.slide_library.json + source PPTX + fill_plan.json@@ -277,7 +294,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 explicit [`quick-generate`](../skills/ppt-master/workflows/profiles/quick-generate.md) profile bypasses that lifecycle and creates only `svg_output/` plus the PPTX destination. The default delivery 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 [`quick-generate`](../skills/ppt-master/workflows/profiles/quick-generate.md) profile omits the planning artifacts and default delivery sidecars, but its project may still contain converted sources, analysis, images, icons, rendered formulas, and required resource manifests. It then hand-authors `svg_output/` and writes the PPTX destination directly. The default delivery lifecycle is:| Directory | Role ||---|---|@@ -306,9 +323,9 @@ These invariants are stronger than ordinary implementation preferences. If a cha| Invariant | Practical consequence ||---|---|-| `sources/` content-type files are the main-pipeline content contract | text, tables, and chart values come from content-type files in `sources/` (Markdown is primary, but `.txt` / `.csv` / `.json` / `.yaml` / … count too); known sidecars (`*.conversion_profile.json`, `*_files/image_manifest.json`) are excluded |-| `analysis/` stores machine facts, not design contracts | `source_profile.json` and intake artifacts inform Strategist; they do not lock page count/order except in workflows that say so |-| `design_spec.md` explains the design; `spec_lock.md` executes it in the default pipeline | both remain owning artifacts there; `quick-generate` persists neither and keeps its minimal choices in active context |+| `sources/` content-type files are the Generate content contract | text, tables, and chart values come from content-type files in `sources/` (Markdown is primary, but `.txt` / `.csv` / `.json` / `.yaml` / … count too); known sidecars (`*.conversion_profile.json`, `*_files/image_manifest.json`) are excluded |+| `analysis/` stores machine facts, not design contracts | `source_profile.json` and intake artifacts inform Strategist in the default pipeline and the current agent in `quick-generate`; they do not lock page count/order except in workflows that say so |+| `design_spec.md` explains the design; `spec_lock.md` executes it in the default pipeline | both remain owning artifacts there; `quick-generate` persists neither, and the current agent keeps its content, page, visual, and resource decisions in active context || 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 |@@ -316,7 +333,7 @@ These invariants are stronger than ordinary implementation preferences. If a cha| 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 |-| Image facts come from regenerated metadata | `analysis/image_analysis.csv` is re-derived from the live `images/` folder; Strategist uses source context first and inspects only a specifically ambiguous asset when semantics or safe placement cannot otherwise be resolved; Executor does not re-read source pixels |+| Image facts come from regenerated metadata | `analysis/image_analysis.csv` is re-derived from the live `images/` folder; in the default pipeline Strategist uses source context first and inspects only a specifically ambiguous asset when semantics or safe placement cannot otherwise be resolved, while in `quick-generate` the current agent applies the same bounded analysis while preparing resources; SVG authoring does not rescan source pixels || Raw PPTX templates are not Step 3 templates | Step 3 consumes reusable template directories only |---@@ -390,7 +407,7 @@ The three Stage 3 proactive values remain independent raw evidence. Inparticular, enabling narration may enable the effective Speaker Notes outcomein the Design Spec, but it never rewrites the raw speaker-notes choice.-**Image analysis is metadata-first, with a narrow Strategist visual fallback.** When images exist, `analyze_images.py` supplies the regenerated measured facts in `analysis/image_analysis.csv`; the CSV is a view over the live `images/` folder, not a durable cache. Strategist first resolves supplied images from source placement and nearby prose, captions / alt text / titles, filenames, user notes, existing resource records, and that metadata. It may inspect one specific image only when a material ambiguity remains about selection, factual identity, page role, crop safety, or focal placement—never as a bulk inventory scan. The answer is written into Design Spec §VIII, after which Executor uses the plan and measured geometry without reopening source pixels for semantic discovery. User images, extracted images, web images, AI outputs, formulas, and sliced elements still converge into the same measured fact table.+**Image analysis is metadata-first, with a narrow visual fallback.** When images exist, `analyze_images.py` supplies the regenerated measured facts in `analysis/image_analysis.csv`; the CSV is a view over the live `images/` folder, not a durable cache. In the default pipeline, Strategist first resolves supplied images from source placement and nearby prose, captions / alt text / titles, filenames, user notes, existing resource records, and that metadata. It may inspect one specific image only when a material ambiguity remains about selection, factual identity, page role, crop safety, or focal placement—never as a bulk inventory scan. The answer is written into Design Spec §VIII, after which Executor uses the plan and measured geometry without reopening source pixels for semantic discovery. In `quick-generate`, the current agent applies the same bounded analysis while automatically preparing the resource roster in active context; no Design Spec projection is written. User images, extracted images, web images, AI outputs, formulas, and sliced elements still converge into the same measured fact table.**Retained planning context** carries continuity; the on-demand page projector is only a diagnostic described below.@@ -434,8 +451,8 @@ The tool refuses to back up: it relies on git for revert. Adding a backup mechan## Materials → Plan → Realization: the Kitchen ContractThe cooking analogy is the canonical ownership model for the default Generate-pipeline, not just explanatory prose. `quick-generate` deliberately omits its-planning and preparation layers under the narrower profile contract.+pipeline, not just explanatory prose. `quick-generate` removes the separate+Strategist and confirmation layer; it does not remove preparation.| Restaurant | PPT Master | Authority ||---|---|---|@@ -443,15 +460,23 @@ planning and preparation layers under the narrower profile contract.| Menu planner and preparation lead | Strategist, `design_spec.md`, `spec_lock.md`, and Strategist-owned acquisition stages | Assesses sufficiency; fills permitted factual gaps; selects the content, resources, page roster, chart-reference/template-layout keys, fonts, palette anchors, icons, and crop boundaries; records optional capability/expression recommendations; readies the complete project-local inventory before execution || Cook | Executor | Uses only prepared project-local assets and realizes the plan through geometry, composition, hierarchy, spacing, and treatment without changing the selected “dish” or acquiring/substituting ingredients; may adapt fields explicitly labeled as suggestions or References |-**Preparation has two clocks.** Topic Research supplies facts before final confirmation: it starts immediately for topic-only input, or after supplied material is converted/read when planning-critical factual gaps remain. It supplements only those gaps and acquires no images. AI / web / slice image acquisition runs only after final confirmation and the completed `design_spec.md §VIII` / `spec_lock.md`, then reaches a terminal status before Executor starts. Strategist also resolves, syncs, and validates the icon inventory while authoring the final plan. Image_Generator, Image_Searcher, and icon-sync tooling are preparation mechanisms under Strategist ownership, not independent decision owners.+**Quick generation collapses planning into the current agent.** Source conversion,+factual-gap research, and resource preparation still run when needed. The agent+automatically selects the content, page roster, visual system, and resource+needs in active context, prepares supplied/extracted/AI/web/sliced images,+icons, and formulas with their required manifests or provenance records, and+then hand-authors SVG. It does not invoke Strategist, Confirm UI,+`design_spec.md`, or `spec_lock.md`.++**Default preparation has two clocks.** Topic Research supplies facts before final confirmation: it starts immediately for topic-only input, or after supplied material is converted/read when planning-critical factual gaps remain. It supplements only those gaps and acquires no images. AI / web / slice image acquisition runs only after final confirmation and the completed `design_spec.md §VIII` / `spec_lock.md`, then reaches a terminal status before Executor starts. Strategist also resolves, syncs, and validates the icon inventory while authoring the final plan. Image_Generator, Image_Searcher, and icon-sync tooling are preparation mechanisms under Strategist ownership, not independent decision owners. Quick generation uses those preparation mechanisms as needed under the current agent's in-context decisions, without inserting a confirmation gate.-**Prepared project-local assets are the boundary.** Images and other declared resources remain available only when Strategist has selected them, recorded them in the planning artifacts, and made their project paths resolvable or explicitly `Needs-Manual`. Icons are prepared when their SVG files exist under `<project>/icons/`; `spec_lock.icons.inventory` records the Strategist's planned bundled selection but is not an exhaustive execution whitelist. Files elsewhere on disk are not authorized. Missing material returns upstream; Executor never searches, generates, downloads, syncs, or substitutes it.+**Prepared project-local assets are the boundary.** In the default pipeline, images and other declared resources remain available only when Strategist has selected them, recorded them in the planning artifacts, and made their project paths resolvable or explicitly `Needs-Manual`. Icons are prepared when their SVG files exist under `<project>/icons/`; `spec_lock.icons.inventory` records the Strategist's planned bundled selection but is not an exhaustive execution whitelist. In quick generation, the active-context resource roster and its project-local files/manifests replace that planning projection; the current agent may acquire and prepare those resources before SVG authoring. Files elsewhere on disk are not authorized. Missing material returns to the owning preparation step; SVG authoring never silently substitutes it.-**Specificity controls freedom.** “Make Mapo tofu” fixes the result's identity: technique and presentation may vary, but tomato-and-eggs or tofu soup is a substitution. “Make a tofu dish” leaves an in-class choice. Strategist may resolve that choice; if the Design Spec deliberately leaves a dimension broad, Executor may realize it within that envelope. Once the Design Spec names a binding choice, execution cannot reopen it. Fields explicitly labeled as suggestions or References—including a preferred page-local image pattern—remain expression guidance that Executor may adapt without changing content, resources, identity, or explicit constraints.+**Specificity controls freedom.** “Make Mapo tofu” fixes the result's identity: technique and presentation may vary, but tomato-and-eggs or tofu soup is a substitution. “Make a tofu dish” leaves an in-class choice. In the default pipeline, Strategist may resolve that choice; if the Design Spec deliberately leaves a dimension broad, Executor may realize it within that envelope. Once the Design Spec names a binding choice, execution cannot reopen it. In quick generation, the current agent resolves the equivalent choice in active context and keeps it stable while authoring. Fields explicitly labeled as suggestions or References—including a preferred page-local image pattern—remain expression guidance that may be adapted without changing content, resources, identity, or explicit constraints.-**Garnish remains local.** Sparse page-local font or color accents may add hierarchy, differentiation, or atmosphere without becoming a second visual system. Structural/recurring fonts, palette roles, resources, or recurring cross-page identity patterns remain Strategist decisions and require an upstream Design Spec/lock update before reuse. A page-local §VIII image pattern remains a preferred composition reference.+**Garnish remains local.** Sparse page-local font or color accents may add hierarchy, differentiation, or atmosphere without becoming a second visual system. In the default pipeline, structural/recurring fonts, palette roles, resources, or recurring cross-page identity patterns remain Strategist decisions and require an upstream Design Spec/lock update before reuse; in quick generation, the current agent establishes those anchors in active context and preserves them across pages. A default-pipeline page-local §VIII image pattern remains a preferred composition reference.-**Prompt-refactor invariant.** Compression must preserve initial materials, user confirmation, Strategist-owned preparation, planning ownership, and execution freedom as separate layers. Moving acquisition into Executor, turning permission into quota, flexible realization into silent resource/identity reselection, or an exact binding plan into an approximate target is a semantic regression. Runtime authority lives in [`strategist.md`](../skills/ppt-master/references/strategist.md) and [`executor-base.md`](../skills/ppt-master/references/executor-base.md); prompt-writing governance lives in [`prompt-style.md`](./rules/prompt-style.md).+**Prompt-refactor invariant.** In the default pipeline, compression must preserve initial materials, user confirmation, Strategist-owned preparation, planning ownership, and execution freedom as separate layers. Moving acquisition into Executor, turning permission into quota, flexible realization into silent resource/identity reselection, or an exact binding plan into an approximate target is a semantic regression. The explicit quick profile consolidates the first layers under the current agent; it does not erase source or resource work. Default runtime authority lives in [`strategist.md`](../skills/ppt-master/references/strategist.md) and [`executor-base.md`](../skills/ppt-master/references/executor-base.md); Quick runtime authority starts at [`quick-generate.md`](../skills/ppt-master/workflows/profiles/quick-generate.md) and conditionally loads the same resource references. Prompt-writing governance lives in [`prompt-style.md`](./rules/prompt-style.md).---diff --git a/docs/zh/faq.md b/docs/zh/faq.mdindex 18fcf152..f43db916 100644--- a/docs/zh/faq.md+++ b/docs/zh/faq.md@@ -204,9 +204,9 @@ python3 skills/ppt-master/scripts/svg_to_pptx.py <project> -a auto --animation-t## Q: 可以跳过策略师阶段直接生成吗?-可以。请显式要求**快速生成**,并提供事实充分、内容自包含的材料。Generate 路线会启用 [`quick-generate` profile](../../skills/ppt-master/workflows/profiles/quick-generate.md):AI 在当前上下文直接决定页结构,按共享规范手写 `svg_output/`,随后调用直接导出器。+可以。请显式要求**快速生成**。Generate 路线会启用 [`quick-generate` profile](../../skills/ppt-master/workflows/profiles/quick-generate.md):仍按需转换来源并研究已识别的事实缺口,但当前 Agent 会在上下文中自动决定内容、页结构、视觉系统和资源清单,不进入 Strategist、确认、`design_spec.md` 或 `spec_lock.md`。-该 profile 只产出 SVG 页面和一个 PPTX;不会做源文件转换、事实研究、策略师规划与确认、模板套用、素材获取、Live Preview、质量报告、讲稿、`svg_final/`、备份、动画或旁白。需要任一被跳过能力时仍走默认流程;页数本身既不会自动触发,也不会阻止快速生成。这是工作流短路,不承诺具体耗时,也不承诺与默认流程质量等价。+该 profile 仍会按需备齐生成 deck 所需的资源:用户提供或源文件抽取的图片、AI / 网络 / 切片图片、项目图标、渲染公式,以及对应的必要 manifest 或来源记录。备料完成后,当前 Agent 按共享规范手写 `svg_output/`,随后调用直接导出器。短路流程仍不包含结构化模板复用、原生图表 / 表格替换、Live Preview、视觉复核交付、质量报告、讲稿、`svg_final/`、备份、动画或旁白;页数本身既不会自动触发,也不会阻止快速生成。这是工作流短路,不承诺具体耗时,也不承诺与默认流程质量等价。## Q: 长 PPT 一次生成会不会上下文爆掉?diff --git a/docs/zh/technical-design.md b/docs/zh/technical-design.mdindex 9f053d35..91bde3b1 100644--- a/docs/zh/technical-design.md+++ b/docs/zh/technical-design.md@@ -36,7 +36,7 @@ PPT Master 不以“任意 SVG 都能转成 PPTX”为目标。`svg_output/` 使## Generate PPTX 路线架构-下图描述 Generate PPTX 的默认生命周期,也包含其 `beautify-pptx` profile。显式 `quick-generate` profile 仍属于同一路线,但会绕过这套生命周期。Create Template 有独立的工作区生命周期;Fill Native PPTX 与 Enhance Native PPTX 直接操作 OOXML。本文后续路线表会覆盖全部四条顶层路线。+下图描述 Generate PPTX 的默认生命周期,也包含其 `beautify-pptx` profile。显式 `quick-generate` profile 仍属于同一路线,但只绕过其中独立的规划 / 确认与默认交付门禁;来源理解和资源准备仍按需运行。Create Template 有独立的工作区生命周期;Fill Native PPTX 与 Enhance Native PPTX 直接操作 OOXML。本文后续路线表会覆盖全部四条顶层路线。```用户输入 (PDF/DOCX/XLSX/PPTX/URL/Markdown/主题文本)@@ -92,17 +92,24 @@ PPT Master 不以“任意 SVG 都能转成 PPTX”为目标。`svg_output/` 使└── svg_output/ ← 成功复制时可由冻结作者源重建 pptx```-显式短路流程更小:+显式短路只去掉独立规划和确认阶段,不去掉生成 deck 所需的输入与资源:```text-事实充分、内容自包含的材料- -> 在当前上下文决定页结构与视觉系统+来源材料或主题+ -> 按需转换 / 阅读来源,并研究已识别的事实缺口+ -> 在当前上下文决定内容、页结构、视觉系统和资源+ -> 准备所需图片 / 图标 / 公式与资源 manifest-> 按共享 SVG 规范手写 svg_output/-> svg_to_pptx.py --quick-generate-> exports/<name>_<timestamp>.pptx```-未显式指定 `-o` 时,native 与 narration 标记可以组合成 `<project_name>_<timestamp>_native_charts_tables_narrated.pptx`;显式 `-o` 则保留调用者给定的文件名。+这些决策由当前 Agent 自动完成,不进入 Strategist、Confirm UI、+`design_spec.md` 或 `spec_lock.md`。++默认流程未显式指定 `-o` 时,native 与 narration 标记可以组合成+`<project_name>_<timestamp>_native_charts_tables_narrated.pptx`;显式 `-o`+则保留调用者给定的文件名。快速生成不接受这两类标记。### SVG 是受约束的页面设计语言@@ -142,7 +149,7 @@ PPT Master 不以“任意 SVG 都能转成 PPTX”为目标。`svg_output/` 使|---|---|---|| 只有主题,或现有材料缺少实现用户目标所需的事实 | Generate PPTX Step 1 内运行 `topic-research` | 只有主题时立即研究;有材料时先转换 / 阅读,只补已识别的事实缺口 || 有源文件或对话文本,deck 结构可以重想 | Generate PPTX | Strategist 可以拆分、合并、删除、重排和重设计 |-| 对事实充分、自包含的文本显式要求快速生成 | Generate PPTX + `quick-generate` profile | 在当前上下文决定页结构,跳过 Strategist / 确认 / spec / lock,手写 SVG 后直接导出一个 PPTX |+| 显式要求快速生成 | Generate PPTX + `quick-generate` profile | 按需转换 / 阅读来源、研究事实缺口并准备所需资源;当前 Agent 在上下文中决定内容、页结构、视觉与资源,跳过 Strategist / 确认 / spec / lock,手写 SVG 后直接导出一个 PPTX || PPTX 作为源材料,用户允许重构故事和页结构 | Generate PPTX,经 `ppt_to_md` + `pptx_intake` | PPTX 身份和几何是事实与候选,不是复刻约束 || 原生 PPTX 模板 + 新材料 / 新主题 | Fill Native PPTX(`template-fill-pptx`) | 克隆并填充原生页面;不生成 SVG || 现有 PPTX,页数 / 页序 / 措辞 1:1 保留,只改善排版 | Generate PPTX + `beautify-pptx` profile | 通过 SVG 重新生成;内容和分页锁定 |@@ -171,7 +178,7 @@ Executor 角色逐页生成演示文稿的视觉内容,输出为 SVG 文件。**第三阶段:工程化转换**后处理脚本将受支持的 SVG 向量元素转换为 DrawingML。文本和向量形状会保持为 PowerPoint 原生对象——可点击、可编辑、可改样式;位图资源则复制为 PPT picture media,而不是把整页压平成一张图片。-`quick-generate` 跳过第一阶段及默认流程中生成报告的门禁,但仍按共享 SVG 规范创作,并使用同一个 DrawingML 转换器;转换器继续在内存中校验 ZIP 完整性和已发布 Slide 数量。+`quick-generate` 保留 deck 所需的来源理解与资源准备,但跳过独立的 Strategist 规划 / 确认阶段,以及默认流程中生成报告的门禁。当前 Agent 在有效上下文中自动完成内容、页结构、视觉和资源决策,随后仍按共享 SVG 规范创作,并使用同一个 DrawingML 转换器;转换器继续在内存中校验 ZIP 完整性和已发布 Slide 数量。---@@ -198,9 +205,12 @@ design_spec.md + spec_lock.md + images/ + icons/ + templates/backup/<ts>/svg_output/ [默认输出路径;目录创建后复制为 best-effort]Quick Generate:-对话或可直接读取的文本 / Markdown- └─> 当前上下文中的页结构与设计决策 -> svg_output/- └─> svg_to_pptx.py --quick-generate -> exports/*.pptx+来源材料或主题+ └─> 转换 / 阅读 + 事实缺口研究 [按需]+ └─> 当前上下文中的内容 / 页结构 / 视觉 / 资源决策+ └─> images/ + icons/ + 公式 / 资源 manifest [按需]+ └─> 手写 svg_output/+ └─> svg_to_pptx.py --quick-generate -> exports/*.pptx直接 OOXML 路由:analysis/<stem>.slide_library.json + 源 PPTX + fill_plan.json@@ -271,7 +281,7 @@ SVG 也是唯一同时满足流程中所有角色需要的格式:**AI 能可## 项目结构与生命周期-`project_manager.py init` 创建固定的项目工作目录;默认导出随后创建带时间戳的备份目录,再尝试复制 `backup/` 快照。显式 [`quick-generate`](../../skills/ppt-master/workflows/profiles/quick-generate.md) profile 绕过该生命周期,只创建 `svg_output/` 和 PPTX 目标。默认交付生命周期如下:+`project_manager.py init` 创建固定的项目工作目录;默认导出随后创建带时间戳的备份目录,再尝试复制 `backup/` 快照。显式 [`quick-generate`](../../skills/ppt-master/workflows/profiles/quick-generate.md) profile 省略规划产物和默认交付 sidecar,但项目中仍可按需存在已转换来源、分析结果、图片、图标、渲染公式及必要资源 manifest;随后手写 `svg_output/` 并直接写入 PPTX 目标。默认交付生命周期如下:| 目录 | 职责 ||---|---|@@ -300,9 +310,9 @@ CLI 支持 `--move`、`--copy` 和自动默认,但共享同一条固定的所| 不变量 | 实际后果 ||---|---|-| `sources/` 内容型文件是主流水线内容契约 | 主 SVG 路线中的文本、表格和图表数值来自 `sources/` 内容型文件(Markdown 为主,`.txt` / `.csv` / `.json` / `.yaml` 等同样计入);已知 sidecar(`*.conversion_profile.json`、`*_files/image_manifest.json`)排除在外 |-| `analysis/` 存机器事实,不存设计契约 | `source_profile.json` 和 intake artifact 辅助 Strategist;除非工作流明确规定,否则不锁定页数 / 页序 |-| 默认流程由 `design_spec.md` 解释设计、`spec_lock.md` 执行设计 | 两者在默认流程中始终是权威产物;`quick-generate` 不落盘二者,只在当前上下文保留最小设计选择 |+| `sources/` 内容型文件是 Generate 内容契约 | 文本、表格和图表数值来自 `sources/` 内容型文件(Markdown 为主,`.txt` / `.csv` / `.json` / `.yaml` 等同样计入);已知 sidecar(`*.conversion_profile.json`、`*_files/image_manifest.json`)排除在外 |+| `analysis/` 存机器事实,不存设计契约 | `source_profile.json` 和 intake artifact 在默认流程中辅助 Strategist,在 `quick-generate` 中辅助当前 Agent;除非工作流明确规定,否则不锁定页数 / 页序 |+| 默认流程由 `design_spec.md` 解释设计、`spec_lock.md` 执行设计 | 两者在默认流程中始终是权威产物;`quick-generate` 不落盘二者,由当前 Agent 在上下文中保留内容、页结构、视觉和资源决策 || 规划上下文有效时持续复用 | 连续执行直接使用完整 Design Spec、lock 与已触发引用;fresh/resumed/restarted 或压缩后才重新读取一次 || `page-context` 按需调用 | 只读投影器用于诊断、确定性路由检查和可选的用量统计,不是逐页门禁 || `svg_output/` 是唯一手写 SVG 目录 | 质量检查、手工编辑、重导出和 `update_spec.py` 都面向作者源 |@@ -310,7 +320,7 @@ CLI 支持 `--move`、`--copy` 和自动默认,但共享同一条固定的所| native PPTX 标准导出读取 `svg_output/` | 唯一受支持的可编辑形状路线由项目转换器执行;它要在 finalize 重写前保留图标、`preserveAspectRatio`、圆角矩形和原生图片裁剪语义 || PowerPoint 手工“转换为形状”不属于兼容性契约 | `svg_final/` 可以作为 SVG 图片插入,但转换后的结构与视觉结果不做保证,也不反向约束 SVG 允许能力 || 直接 OOXML 路由不进入 SVG 流水线 | 保留型工作流直接 patch 原生 PPTX parts |-| 图片事实来自重算元数据 | `analysis/image_analysis.csv` 从实时 `images/` 目录重算;Strategist 先用源文上下文,只在图片语义或安全放置仍无法确定时查看那一张具体图片;Executor 不重新读取源图像素 |+| 图片事实来自重算元数据 | `analysis/image_analysis.csv` 从实时 `images/` 目录重算;默认流程由 Strategist 先用源文上下文,只在图片语义或安全放置仍无法确定时查看那一张具体图片;`quick-generate` 由当前 Agent 在备料时采用同样的有界分析,SVG 创作阶段不重新扫描源图像素 || 原生 PPTX 模板不是 Step 3 模板 | Step 3 只消费可复用模板目录 |---@@ -378,7 +388,7 @@ Stage 3 的三个主动执行值始终保留为相互独立的原始证据。尤启用旁白可以在 Design Spec 中启用 Speaker Notes 的最终有效结果,但绝不会改写原始的备注选择。-**图片分析以重算元数据为先,Strategist 只保留小范围视觉兜底。** 当项目里存在图片时,`analyze_images.py` 把可度量事实重算到 `analysis/image_analysis.csv`;该 CSV 是实时 `images/` 目录的派生视图,不是持久缓存。Strategist 先根据图片在源文中的位置与前后文、图注 / alt / 标题、文件名、用户说明、已有资源记录和这些元数据判断。只有当某一张具体图片在选用、事实身份、页面角色、裁剪安全或焦点放置上仍有实质歧义时,才可单独查看它,绝不得扫描整个图片目录。结论写入 Design Spec §VIII 后,Executor 只消费该计划与几何数据,不会重新打开源图进行语义探索。用户图、抽取图、网络图、AI 图、公式图和切片图仍统一汇入同一张可度量事实表。+**图片分析以重算元数据为先,只保留小范围视觉兜底。** 当项目里存在图片时,`analyze_images.py` 把可度量事实重算到 `analysis/image_analysis.csv`;该 CSV 是实时 `images/` 目录的派生视图,不是持久缓存。默认流程中,Strategist 先根据图片在源文中的位置与前后文、图注 / alt / 标题、文件名、用户说明、已有资源记录和这些元数据判断。只有当某一张具体图片在选用、事实身份、页面角色、裁剪安全或焦点放置上仍有实质歧义时,才可单独查看它,绝不得扫描整个图片目录。结论写入 Design Spec §VIII 后,Executor 只消费该计划与几何数据,不会重新打开源图进行语义探索。`quick-generate` 则由当前 Agent 在上下文中自动准备资源清单时采用同样的有界分析,不写 Design Spec 投影。用户图、抽取图、网络图、AI 图、公式图和切片图仍统一汇入同一张可度量事实表。**保留的规划上下文**负责跨页连续性;按需逐页投影只承担下文所述的诊断用途。@@ -421,7 +431,7 @@ Generate 执行以 [`workflows/generate-pptx.md`](../../skills/ppt-master/workfl## 材料 → 规划 → 实现:餐厅合同-“做饭”不是临时解释,而是默认 Generate 流程的正式所有权模型。`quick-generate` 按更窄的 profile 合同显式省略规划与备料层:+“做饭”不是临时解释,而是默认 Generate 流程的正式所有权模型。`quick-generate` 只去掉独立的 Strategist 与确认层,不去掉备料:| 餐厅角色 | PPT Master 对应项 | 决策权 ||---|---|---|@@ -429,15 +439,17 @@ Generate 执行以 [`workflows/generate-pptx.md`](../../skills/ppt-master/workfl| 菜单策划与备料负责人 | Strategist、`design_spec.md`、`spec_lock.md` 及其负责的材料获取阶段 | 判断材料是否充分;补齐获准补充的事实;选定内容、资源、页面清单、图表参考 key / 模板版式 key、字体、色板锚点、图标和裁剪边界;记录可选的能力 / 表达建议;在执行前备齐项目级材料清单 || 厨师 | Executor | 只使用项目中已备好的材料,以几何、构图、层级、间距和视觉处理实现方案;不得改变所选“菜品”,也不得自行找料、换料;可以调整明确标为 suggestion 或 Reference 的字段 |-**备料有两个时点。** Topic Research 在最终确认前补充规划所需的事实:只有主题时立即运行;已有材料时先转换 / 阅读,仅在仍有关键事实缺口时补齐,而且不获取任何图片。AI / web / slice 图片只能在最终确认以及完整的 `design_spec.md §VIII` / `spec_lock.md` 之后获取,并在 Executor 开始前进入终态。Strategist 还会在编写最终方案时解析、同步并验证图标 inventory。Image_Generator、Image_Searcher 与图标同步工具只是 Strategist 负责的备料机制,不是独立决策者。+**快速生成把规划职责合并到当前 Agent。** 来源转换、事实缺口研究和资源准备仍按需运行。当前 Agent 在上下文中自动选择内容、页面清单、视觉系统和资源需求,准备用户提供 / 来源抽取 / AI / 网络 / 切片图片、图标和公式及其必要 manifest 或来源记录,随后手写 SVG;不进入 Strategist、Confirm UI、`design_spec.md` 或 `spec_lock.md`。++**默认备料有两个时点。** Topic Research 在最终确认前补充规划所需的事实:只有主题时立即运行;已有材料时先转换 / 阅读,仅在仍有关键事实缺口时补齐,而且不获取任何图片。AI / web / slice 图片只能在最终确认以及完整的 `design_spec.md §VIII` / `spec_lock.md` 之后获取,并在 Executor 开始前进入终态。Strategist 还会在编写最终方案时解析、同步并验证图标 inventory。Image_Generator、Image_Searcher 与图标同步工具只是 Strategist 负责的备料机制,不是独立决策者。快速生成则由当前 Agent 根据上下文决策按需使用这些备料机制,不插入确认门禁。-**项目中已备好的材料就是边界。** 图片和其他声明型资源,仍须由 Strategist 选定、写入规划产物,并保证项目路径可解析或明确标为 `Needs-Manual`。图标 SVG 只要已位于 `<project>/icons/` 就属于已备材料;`spec_lock.icons.inventory` 记录 Strategist 计划选用的内置图标,但不是穷尽式执行白名单。其他目录中的文件不构成使用许可。缺料必须返回上游;Executor 不得搜索、生成、下载、同步或替换资源。+**项目中已备好的材料就是边界。** 默认流程中,图片和其他声明型资源须由 Strategist 选定、写入规划产物,并保证项目路径可解析或明确标为 `Needs-Manual`。图标 SVG 只要已位于 `<project>/icons/` 就属于已备材料;`spec_lock.icons.inventory` 记录 Strategist 计划选用的内置图标,但不是穷尽式执行白名单。快速生成以当前上下文中的资源清单及其项目级文件 / manifest 代替该规划投影;当前 Agent 可以在手写 SVG 前获取并准备这些资源。其他目录中的文件不构成使用许可。缺料必须回到所属备料步骤;SVG 创作阶段不得静默换料。-**具体程度决定自由度。** “做麻婆豆腐”锁定成品身份:火候、口感和摆盘可以发挥,但不能换成番茄炒蛋或豆腐汤。“做一道豆腐菜”则保留了品类内选择空间。Strategist 可以把这个开放要求收敛成具体方案;如果 Design Spec 有意保留某个维度的开放性,Executor 可以在该范围内实现。一旦 Design Spec 已经选定具有约束力的结果,执行阶段不得重新打开选择。明确标为 suggestion 或 Reference 的字段——包括页面级首选图片 pattern——仍是表达建议;Executor 可以在不改变内容、资源、身份和显式约束的前提下调整。+**具体程度决定自由度。** “做麻婆豆腐”锁定成品身份:火候、口感和摆盘可以发挥,但不能换成番茄炒蛋或豆腐汤。“做一道豆腐菜”则保留了品类内选择空间。默认流程中,Strategist 可以把这个开放要求收敛成具体方案;如果 Design Spec 有意保留某个维度的开放性,Executor 可以在该范围内实现。一旦 Design Spec 已经选定具有约束力的结果,执行阶段不得重新打开选择。快速生成则由当前 Agent 在上下文中解决同等选择,并在手写 SVG 时保持稳定。明确标为 suggestion 或 Reference 的字段——包括页面级首选图片 pattern——仍是表达建议;只要不改变内容、资源、身份和显式约束,就可以调整。-**点缀只能保持局部。** 零星的页面级字体或颜色可以用于增加层级、区分和氛围,但不能发展成第二套视觉系统。结构性或重复出现的字体、色板角色、资源与跨页身份 pattern 仍属于 Strategist 决策;复用前必须先更新 Design Spec/lock。页面级 §VIII 图片 pattern 仍是首选构图参考。+**点缀只能保持局部。** 零星的页面级字体或颜色可以用于增加层级、区分和氛围,但不能发展成第二套视觉系统。默认流程中,结构性或重复出现的字体、色板角色、资源与跨页身份 pattern 仍属于 Strategist 决策,复用前必须先更新 Design Spec/lock;快速生成由当前 Agent 在上下文中建立这些锚点,并在跨页创作中保持。默认流程的页面级 §VIII 图片 pattern 仍是首选构图参考。-**提示词重构不变量。** 压缩提示词时,必须继续区分初始材料、用户确认、Strategist 负责的备料、策略规划和执行自由。把材料获取下放给 Executor、把许可变成配额、把灵活实现变成静默更换资源 / 身份,或把精确的约束计划降级成近似目标,均属于语义回归。运行时权威位于 [`strategist.md`](../../skills/ppt-master/references/strategist.md) 与 [`executor-base.md`](../../skills/ppt-master/references/executor-base.md),提示词编写规则位于 [`prompt-style.md`](../rules/prompt-style.md)。+**提示词重构不变量。** 默认流程压缩提示词时,必须继续区分初始材料、用户确认、Strategist 负责的备料、策略规划和执行自由。把材料获取下放给 Executor、把许可变成配额、把灵活实现变成静默更换资源 / 身份,或把精确的约束计划降级成近似目标,均属于语义回归。显式快速生成 profile 会把前几层合并到当前 Agent,但不会删除来源处理或备料。默认流程的运行时权威位于 [`strategist.md`](../../skills/ppt-master/references/strategist.md) 与 [`executor-base.md`](../../skills/ppt-master/references/executor-base.md);快速生成从 [`quick-generate.md`](../../skills/ppt-master/workflows/profiles/quick-generate.md) 开始,并按需加载同一组资源参考。提示词编写规则位于 [`prompt-style.md`](../rules/prompt-style.md)。---diff --git a/skills/ppt-master/references/artifact-ownership.md b/skills/ppt-master/references/artifact-ownership.mdindex fa023f4b..52df0fa5 100644--- a/skills/ppt-master/references/artifact-ownership.md+++ b/skills/ppt-master/references/artifact-ownership.md@@ -1,21 +1,26 @@# Artifact Ownership SpecificationGlobal artifact ownership rules for PPT Master projects. A selected route or-profile may explicitly omit an artifact without transferring its facts.+profile may explicitly omit an artifact without erasing its facts.**Hard rule**: Read each fact from its owning artifact. Do not merge multiple channels into a second source of truth.+**Quick Generate projection**: Quick omits confirmation, Design Spec, and lock.+Its current main agent reads source/analysis facts, keeps routine decisions in+active context, and prepares images/icons/formulas plus required manifests+before SVG authoring. Those artifacts retain their factual/provenance roles.+---## 1. Ownership Matrix| Artifact | Owner | Role | Read/write contract ||---|---|---|---|-| `sources/` content-type files | Content contract | Main pipeline factual/text origin for tables, chart data values, SmartArt node wording, and presentation content | Strategist reads content-type files (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`), judges by content, and resolves approved semantic content plus complete preferred on-slide wording into §IX. Executor opens source passages only for explicit verification/resolution; do not replace values with PPTX geometry JSON in the main pipeline. |-| `sources/*.facts.json` | Fact provenance contract | Stable external `fact_id` → claim/source mapping created by topic research | Strategist cites IDs in §IX; Executor resolves them for visible footnotes / natural notes attribution. Scenario data never enters this file. |+| `sources/` content-type files | Content contract | Main pipeline factual/text origin for tables, chart data values, SmartArt node wording, and presentation content | Default Strategist reads content-type files (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`), judges by content, and resolves approved semantics plus preferred on-slide wording into §IX; Quick's current agent resolves them in active context. Default Executor opens source passages only for explicit verification/resolution. Never replace values with PPTX geometry JSON. |+| `sources/*.facts.json` | Fact provenance contract | Stable external `fact_id` → claim/source mapping created by topic research | Default Strategist cites IDs in §IX and Executor resolves them for attribution; Quick's current agent carries the same IDs into visible attribution. Scenario data never enters this file. || `sources/` converted-source originals | Source archive | Imported source files that have a converted content contract (`.pdf` / `.pptx` / `.docx` / `.xlsx` / `.html` / `.epub` / `.tex` / `.rst` / `.ipynb` / `.typ`, etc.) and source-adjacent extracted assets | Read via the converted `<stem>.md` in the main pipeline; direct-PPTX workflows read the `.pptx` by route || `sources/*.conversion_profile.json`, `sources/*_files/image_manifest.json` | Pipeline sidecar | Conversion audit record / asset index | NOT read as slide content; open only to audit a conversion or resolve assets |-| `analysis/source_profile.json` | Machine fact index | Compact Strategist-facing PPTX intake digest | Main pipeline reads as factual context and recommendation candidates |+| `analysis/source_profile.json` | Machine fact index | Compact PPTX intake digest | Default Strategist or Quick's current agent reads it as factual context and recommendation candidates || `analysis/<stem>.identity.json` | Native deck identity facts | Canvas, theme palette/fonts, observed usage | Read selectively when detailed identity facts are needed || `analysis/<stem>.slide_library.json` | Native PPTX structure facts | Text slots, geometry, native tables, native chart caches, SmartArt nodes/connections | Direct PPTX workflows use as native fill/structure contract || `analysis/image_analysis.csv` | Regenerated image fact view | Measured facts about the current `images/` folder | Re-run `analyze_images.py` before reading image facts after changes |@@ -23,8 +28,9 @@ profile may explicitly omit an artifact without transferring its facts.| `spec_lock.md` | Execution anchor and routing contract | Machine-readable stable color/type roles, icons, images, page rhythm, charts, `template_reuse_scope`, and the route's PowerPoint structure mode; mirror/layout template routes additionally own input prototypes, the Master roster, and the complete page-to-Master/Layout mapping | Strategist authors the route-specific anchors from the audited Design Spec plus current project/page/template context. Executor retains the complete lock once per valid execution context; local uncertainty consults that retained copy before the owning Design Spec fragment. Sparse page-local color/font garnish needs no lock row; a recurring semantic role or new adaptive Layout identity requires Strategist repair before reuse. || `project_manager.py page-context` stdout | Derived on-demand page context | Read-only model-facing anchor set + current-page delta + fingerprints for large references | Use only for explicit diagnostics/telemetry or an unresolved page/template/chart path-SHA projection. Never edit or persist it as a replacement source of truth, and never run it as a routine pre-page gate. `global` is a bounded anchor set, not a whitelist. `reference_set` carries path/SHA/load policy but never appends reference payloads. || `analysis/page-context/P<NN>.usage.json` | Derived optional context telemetry | Measured on-demand page-context size plus hashes of owning inputs/references | `page-context --record-usage` deterministically replaces only the invoked page's snapshot; `page-context-report` summarizes existing snapshots. Telemetry may be partial. Use token data to evaluate context cost, never as content or an execution contract. |-| `images/` | Runtime image pool | User, extracted, AI, web, formula, slice, EMF/WMF assets | Step 5 writes here; `analysis/image_analysis.csv` derives from current contents |-| `icons/` | Prepared project icon pool | Bundled icons copied by `icon_sync.py` plus user-provided, template, imported, or custom icon SVGs | Executor may use any icon in this project-local pool; `spec_lock.icons.inventory` records planned bundled choices rather than an exhaustive whitelist. Exporter global fallback is legacy compatibility only. |+| `images/` | Runtime image pool | User, extracted, AI, web, formula, slice, EMF/WMF assets | Default Step 5 or Quick Generate resource preparation writes here; `analysis/image_analysis.csv` derives from current contents |+| `images/image_prompts.json`, `image_queries.json`, `image_sources.json`, `formula_manifest.json` | Conditional resource contracts | AI/web/formula execution status and provenance | Create only for a triggered path, including Quick. They guide preparation/attribution, never page design. |+| `icons/` | Prepared project icon pool | Bundled icons copied by `icon_sync.py` plus user-provided, template, imported, or custom icon SVGs | SVG authoring may use any icon in this project-local pool; `spec_lock.icons.inventory` records the default plan's bundled choices rather than an exhaustive whitelist. Exporter global fallback is legacy compatibility only. || `templates/` | Project template reference | Step 3 imported specs, template SVGs, and non-image assets | Strategist reads the template Design Spec and actual SVG roster during planning. Continuous Executor reuses that context; fresh Executor reads the Design Spec once and each selected complete SVG only before first use or after its SHA changes. || `templates/template_execution_manifest.json` (`v1`) + `templates/template_execution/*.text-slots.json` (`v2-min`) | Derived template index | Compact prototype/source-import summary plus per-prototype text-slot diagnostics; the sidecar integrity hash is tool-only | Materialization may publish these deterministic records, but page-context does not inject or require them and models do not read them during page authoring. The complete prototype SVG is the sole visual/template authority; never author from either JSON artifact. || `<import_workspace>/svg/` | Imported native-payload backing | Complete PPTX-derived metadata, hidden carriers, fallback evidence, and source structure | Keep immutable; create-template materialization may resolve a validated source ref against these files, but models do not edit or bulk-read them |@@ -39,11 +45,11 @@ profile may explicitly omit an artifact without transferring its facts.| `svg_output/` | Page-design author source | Main-agent handwritten SVG pages containing the complete visible design | Quality checker and native PPTX export read this as the canonical visual/page-layout source; templates and locks do not add missing visible objects at export || `notes/total.md` | Conditional speaker-note source | Complete notes before splitting | Step 6 writes only when the effective Speaker Notes outcome is enabled; Step 7.1 splits || `notes/slide_*.md` | Conditional split notes | Per-slide notes generated from `total.md` | Derived by `total_md_split.py` only when speaker notes are enabled |-| `svg_final/` | Derived visual preview | Self-contained post-processed SVGs that may be opened directly or inserted as SVG pictures | Rebuild from `svg_output/` with `finalize_svg.py`; do not use as a supported PPTX source |-| `validation/svg_quality_report.json` | Quality provenance | Final SVG gate split into blocking / introduced / inherited / source-import categories, bound to the checked SVG bytes by SHA-256 | `svg_quality_checker.py --stage final --json` writes before export; the exporter reads it programmatically and links it only when the export-source fingerprint matches. Agents use successful command output and do not load the full JSON except for targeted failure/audit reads. |-| `validation/<output_stem>.report.json` | Published-package audit | PPTX package/resource postflight status, part counts, and quality-gate linkage | Step 7.3 writes after the PPTX passes package validation and emits a compact `[POSTFLIGHT]` receipt. Agents use the receipt on routine success and keep the full JSON cold unless targeted failure/audit evidence is required. |-| `exports/` | Delivery artifacts | Native DrawingML PPTX and explicit native-object/narration variants | Step 7.3 writes only final deliverables from `svg_output/`. |-| `backup/<timestamp>/svg_output/` | Frozen author-source archive | Re-export source without re-running LLM | `svg_to_pptx.py` writes a snapshot during export |+| `svg_final/` | Default-only derived visual preview | Self-contained post-processed SVGs that may be opened directly or inserted as SVG pictures | Default rebuilds it from `svg_output/` with `finalize_svg.py`; Quick omits it. Never use it as a supported PPTX source. |+| `validation/svg_quality_report.json` | Default quality provenance | Final SVG gate split into blocking / introduced / inherited / source-import categories, bound to the checked SVG bytes by SHA-256 | Default `svg_quality_checker.py --stage final --json` writes before export; the exporter links it only when fingerprints match. Quick omits this report. |+| `validation/<output_stem>.report.json` | Default published-package audit | PPTX package/resource postflight status, part counts, and quality-gate linkage | Default Step 7.3 writes it and emits `[POSTFLIGHT]`; Quick instead performs in-memory package sanity and emits `[QUICK-GENERATE]` without a report. |+| `exports/` | Delivery artifacts | Native DrawingML PPTX and explicit native-object/narration variants | Default Step 7.3 or Quick direct export writes final deliverables from `svg_output/`. |+| `backup/<timestamp>/svg_output/` | Default frozen author-source archive | Re-export source without re-running LLM | Default export writes a snapshot; Quick direct export omits it. || `animations.json` | Optional animation config | Page-transition and object-animation sidecar | Existing files activate intent resolution: Stage 3 `false` preserves, explicit objects-off exports `-a none`, and all-motion-off bypasses with `--no-animations`. Creation requires explicit instruction or enabled outcome; §IX advice never activates it |---@@ -52,7 +58,7 @@ profile may explicitly omit an artifact without transferring its facts.| Invariant | Rule ||---|---|-| Content authority | Content-type files in `sources/` (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`) own the factual/text origin for main-pipeline content, tables, chart values, and SmartArt node wording; Strategist resolves approved semantic content plus complete preferred on-slide wording into §IX. Executor realizes §IX under [`executor-base.md`](./executor-base.md) §2.1's content-vs-expression contract and opens sources only for explicit verification/resolution, never to draft a second outline. `slide_library.json` does not own content values. |+| Content authority | Content-type files in `sources/` own the factual/text origin for content, tables, chart values, and SmartArt wording. Default Strategist resolves them into §IX and Executor realizes that contract without drafting a second outline. Quick's current agent resolves them once in active context before SVG authoring. `slide_library.json` does not own content values. || Sources read policy | In `sources/`, read content-type files (`.md` / `.markdown` / `.txt` / `.csv` / `.tsv` / `.json` / `.jsonl` / `.yaml` / `.yml`) and judge by content — a `.json` / `.csv` may be core content or just data. Exclude known sidecars: `*.conversion_profile.json` and `*_files/image_manifest.json`. `analysis/` facts (`source_profile.json`, `<stem>.slide_library.json`) are read per Step 4 / direct-PPTX workflow, not in the `sources/` content scan. || PPTX structure | `slide_library.json` owns native geometry, slot facts, and SmartArt layout/relationships for direct PPTX workflows. || Design contract | Final confirmation once → audited `design_spec.md` → optional same-file refinement/approval → context-authored lock. Never maintain a parallel draft/lock. Executor may apply `Template Application` prose but never replace identity. Repair divergence from the approved Design Spec/context unless it fails active-decision fidelity. |@@ -65,7 +71,7 @@ profile may explicitly omit an artifact without transferring its facts.| SVG source | `svg_output/` is the only author source for generated pages. || Page-design closure | On SVG-authoring routes, every visible exported-slide object exists in the corresponding page SVG or an explicitly referenced visual asset. || Package-behavior separation | Speaker notes, animations, transitions, narration, and direct native-PPTX workflows keep their owning artifacts; do not force them into SVG metadata. |-| Post-processed SVG | `svg_final/` is disposable, must be rebuilt in Step 7.2, and serves only as a self-contained visual preview / manually insertable SVG picture. |+| Post-processed SVG | In Default Generate, `svg_final/` is disposable, must be rebuilt in Step 7.2, and serves only as a self-contained visual preview / manually insertable SVG picture. Quick omits it. || Export source | The only supported generated-PPTX route reads `svg_output/` through the project SVG-to-DrawingML converter. A diagnostic `-s final` override does not change ownership or create a supported release route. || Shape-conversion boundary | PowerPoint's manual Convert-to-Shape operation on `svg_final/` is outside the project compatibility contract. || Confirmation | Final UI/chat confirmation overrides recommendations and is consumed once into `design_spec.md`. Enabled refinement applies arbitrary revisions there and requires approval; only then may active-decision fidelity release lock authoring. |@@ -85,5 +91,6 @@ profile may explicitly omit an artifact without transferring its facts.| `svg_final/` | `svg_output/` plus project assets | `python3 ${SKILL_DIR}/scripts/finalize_svg.py <project_path>` || `validation/svg_quality_report.json` | `svg_output/`, locks, template provenance | `python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> --stage final --json` || Native PPTX + `validation/<output_stem>.report.json` | `svg_output/` plus notes/assets and final quality report | `python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path>` |+| Quick native PPTX | `svg_output/` plus prepared project-local resources | `python3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> --quick-generate` |**Default - regenerate derived views**: When a source artifact changes, regenerate the derived artifact at the owning step instead of patching the derived file directly.diff --git a/skills/ppt-master/references/executor-image.md b/skills/ppt-master/references/executor-image.mdindex 381526a3..ebb568e6 100644--- a/skills/ppt-master/references/executor-image.md+++ b/skills/ppt-master/references/executor-image.md@@ -1,14 +1,18 @@-> See [`executor-base.md`](./executor-base.md) for the always-loaded Executor core.+> Default Generate also loads [`executor-base.md`](./executor-base.md). Quick+> Generate deliberately does not; this branch supplies its conditional image+> realization rules directly.# Executor Image BranchConditional Executor authority for image status handling, placement, crop behavior, formula images, and template-bundled images.-**Trigger**: load when `design_spec.md §VIII` or `spec_lock.md images` contains any image/formula row, or when a selected template carries bitmap assets.+**Trigger**: load for any image/formula in §VIII, the lock, a Quick Generate roster, or a selected template.## 1. Image Handling-Handle images by their status in the Design Spec's Image Resource List. Status enum and lifecycle: [`svg-image-embedding.md`](svg-image-embedding.md).+Handle images by status; enum and lifecycle: [`svg-image-embedding.md`](svg-image-embedding.md).++**Mode boundary**: Default keeps Strategist → Executor with no downstream acquisition/reselection. Quick substitutes the main agent's prepared transient roster for §VIII/lock below; the same boundary starts at SVG authoring.| Status | Source | Handling ||--------|--------|----------|@@ -16,7 +20,7 @@ Handle images by their status in the Design Spec's Image Resource List. Status e| **Generated** | Generated by Image_Generator | Reference images directly from `../images/` directory || **Sourced** | Web-acquired by Image_Searcher | Reference from `../images/`. **Read [`image_sources.json`](image-searcher.md) to decide attribution** — load [`executor-web-image.md`](./executor-web-image.md). || **Rendered** | Deterministic formula PNG | Reference from `../images/`; use a legal anchor with `meet` (centered default: `xMidYMid meet`) |-| **Needs-Manual** | Acquisition failed and file is absent | Use dashed border placeholder unless the expected file exists; the Step 7 readiness gate swaps placeholders for real files before export |+| **Needs-Manual** | Acquisition or suitability remains unresolved | Default uses a placeholder until Step 7. Quick blocks every required row in this status; file presence alone does not bypass it. || **Placeholder** | Not yet prepared | Use dashed border placeholder |**Reference syntax**: see [`svg-image-embedding.md`](svg-image-embedding.md).@@ -52,4 +56,4 @@ positions and heights must change the source-unit `x`, `y`, `width`, andrescaling the scene. A compound clip on one `<image>` is pattern `#82`, not asubstitute when the objects must remain independently editable or Morphable.-**Formula images — declared-inference fallback for a missing `no-crop` flag**: rows with `Acquire Via: formula` or `Type: Latex Formula` MUST be treated as no-crop. For a rendered file, use dimensions in this order: current `analysis/image_analysis.csv`, `design_spec.md §VIII`, then `images/formula_manifest.json`. For a `Needs-Manual` row, size the dashed placeholder from the planned dimensions in §VIII, then the manifest; the Step 7 readiness gate re-analyzes the supplied file and reconciles the container before export. Do not normalize all formulas to one height unless the spec explicitly states that layout choice.+**Formula images — declared-inference fallback for a missing `no-crop` flag**: rows with `Acquire Via: formula` or `Type: Latex Formula` MUST be treated as no-crop. For a rendered file, use dimensions in this order: current `analysis/image_analysis.csv`, `design_spec.md §VIII`, then `images/formula_manifest.json`. For a `Needs-Manual` row, size the dashed placeholder from the planned dimensions in §VIII, then the manifest; the readiness gate re-analyzes the supplied file and reconciles the container before export. Do not normalize all formulas to one height unless the spec explicitly states that layout choice.diff --git a/skills/ppt-master/references/executor-web-image.md b/skills/ppt-master/references/executor-web-image.mdindex 38650626..49fdf497 100644--- a/skills/ppt-master/references/executor-web-image.md+++ b/skills/ppt-master/references/executor-web-image.md@@ -4,7 +4,7 @@Conditional Executor authority for inline attribution on web-sourced images.-**Trigger**: load when at least one placed image has `Status: Sourced`.+**Trigger**: load for any placed `Status: Sourced` image. Quick Generate uses the same `image_sources.json` contract without interaction.## 1. Inline Attribution for Sourced Images@@ -20,6 +20,6 @@ The credit is **not** rendered by post-processing or export — it must be preseUse `attribution_text` from the manifest entry as the **starting point**. You may omit the filename and full URL when the visible source/provider remains clear, but retain that image's author and CC BY / CC BY-SA license so the quality checker can bind the credit to the referenced asset. For CC0/PD images that landed in the `attribution-required` tier only because of upstream metadata quirks (rare), credits are still safe to render.-`svg_quality_checker.py` treats a missing image-specific author + license credit as an **error**; one generic CC token does not cover multiple files. An unreadable/missing manifest or missing per-file provenance is also blocking. Fix the manifest or SVG before post-processing.+`svg_quality_checker.py` treats a missing image-specific author + license credit as an **error**; one generic CC token does not cover multiple files. An unreadable/missing manifest or missing per-file provenance is also blocking. Fix the manifest or SVG before Default Generate post-processing or Quick Generate direct export.**The manifest is the single source of truth for credits.** Do not duplicate license info into speaker notes or any other artifact.diff --git a/skills/ppt-master/references/image-base.md b/skills/ppt-master/references/image-base.mdindex b73cb49c..d48474a7 100644--- a/skills/ppt-master/references/image-base.md+++ b/skills/ppt-master/references/image-base.md@@ -8,25 +8,28 @@ Shared baseline for both acquisition paths. Path-specific behavior lives in the## 1. Trigger Condition-Active when at least one resource list row has `Acquire Via: ai` / `web` / `slice`. Rows with `user` / `formula` / `placeholder` are skipped.+Active when at least one resource row has `Acquire Via: ai` / `web` / `slice`. Rows with `user` / `formula` / `placeholder` are tracked but skipped by these acquisition roles.| Mode | Trigger ||---|---|-| In-pipeline | `generate-ppt` workflow, image rows present |+| Default Generate | `generate-ppt` workflow, `design_spec.md §VIII` image rows present |+| Quick Generate | [`quick-generate`](../workflows/profiles/quick-generate.md) is active and its transient resource roster contains image rows || Standalone | Direct request against an existing project |---## 2. Image Resource List Format-Defined in `design_spec.md §VIII`. Status enum: see [`svg-image-embedding.md`](svg-image-embedding.md).+Default Generate uses Strategist-owned `design_spec.md §VIII` plus its lock projection. Quick Generate substitutes a transient active-context roster; it creates neither planning artifact. Status enum: [`svg-image-embedding.md`](svg-image-embedding.md).| Filename | Dimensions | Purpose / Type | Layout pattern | Crop Policy | Acquire Via | Status | Reference ||---|---|---|---|---|---|---|---|-| `<planned file>` | `<planned size>` | `<planned role>` | `<Strategist recommendation>` | `adaptive` / `no-crop` | `ai` / `web` / `slice` | Pending | `<acquisition brief>` |+| `<planned file>` | `<planned size>` | `<planned role>` | `<owner-resolved recommendation>` | `adaptive` / `no-crop` | `ai` / `web` / `slice` | Pending | `<acquisition brief>` |**Required per non-skipped row**: `Acquire Via` and `Status`. `Reference` is required for every `web` / `slice` row and every newly authored `ai` row. An existing `ai` row whose `Reference` is omitted or blank may continue only through the declared inference in [`image-generator.md`](./image-generator.md) §8; no other path may infer it.+**Quick Generate ownership**: explicit user assets, URLs, and path instructions win. Otherwise the main agent chooses required `user` / `ai` / `web` / `slice` / `formula` rows and AI path `auto`, without interaction.+---## 3. Path Dispatch@@ -50,9 +53,10 @@ For each row with `Status: Pending`:Before processing any row:-1. `read_file <project_path>/design_spec.md` — extract color scheme, canvas format, target audience+1. Read the Default Design Spec/lock, or reuse Quick's transient roster and active visual/page decisions2. Group resource list rows by `Acquire Via`3. Confirm `project/images/` exists+4. Materialize explicit user assets, render declared formulas, and finish triggered ai/web/slice acquisition before SVG authoring begins---@@ -66,18 +70,28 @@ After all rows reach terminal status:- `image_prompts.json` exists when ≥1 ai row processed; every entry has `status ∈ {Generated, Needs-Manual}` (no `Pending` or `Failed` remaining)- `image_sources.json` exists when ≥1 web row processed; every entry has `license_tier ∈ {no-attribution, attribution-required, manual}` (`manual` = a user-supplied `--from-url` replacement)-> `Needs-Manual` is a legitimate terminal state for ai rows — Step 7 entry waits for the user to place the file. See [`image-generator.md`](./image-generator.md) §7 Offline Manual Mode.+> `Needs-Manual` is terminal for acquisition, not export readiness. A later+> supplied/replaced file must be validated and its row reconciled to+> `Generated`, `Sourced`, or `Rendered` with the matching manifest evidence.+> Quick blocks every required row that still says `Needs-Manual`, regardless of+> whether an unverified candidate file happens to exist. See+> [`image-generator.md`](./image-generator.md) §7.---## 6. Failure Handling-**Hard rule**: acquisition failures MUST NOT halt the pipeline.+**Hard rule — automatic exhaustion before blocking**: acquisition failures MUST NOT open an interactive choice or stop while an untried permitted strategy remains.1. Run the selected path's initial strategy2. On recoverable failure (network, no candidates, license rejection, rate limit), continue through materially different strategies that remain inside that path's confirmed permissions; never loop an already exhausted strategy3. When the path-specific query/provider/license-stage or backend/retry strategy is exhausted, set `Status: Needs-Manual`, log the reason in conversation, and continue-4. After the phase completes, summarize all `Needs-Manual` rows for the user — list filenames, where prompts live (`images/image_prompts.md` paste-ready blocks for ai rows; refresh via `image_gen.py --render-md` if stale), and where to place generated files (`project/images/<filename>`). For `slice` rows, list the parent sheet filename and target element names; the user places the sheet, then the agent reruns `slice_images.py`.+4. After the phase completes, summarize all `Needs-Manual` rows for the user — list filenames, where prompts live (`images/image_prompts.md` paste-ready blocks for ai rows; refresh via `image_gen.py --render-md` if stale), and where to place generated files (`project/images/<filename>`). After supply/replacement, validate the file and reconcile the owning row plus manifest to its usable status. For `slice` rows, list the parent sheet filename and target element names; the user places the sheet, then the agent reruns `slice_images.py`.++**Quick Generate export gate**: exhaust allowed automation without asking; stop+before `--quick-generate` when a required row is not both backed by its+validated file/provenance and in a usable status. File presence alone never+bypasses `Needs-Manual`.`Needs-Manual` is also the entry status for **Offline Manual Mode** (no `IMAGE_BACKEND` configured, no host-native image tool in use). Affected ai rows are marked `Needs-Manual` from the start without a failed attempt — see [`image-generator.md`](./image-generator.md) §7 Offline Manual Mode.@@ -100,9 +114,9 @@ Executor reads the manifest per slide and renders inline credits when needed —----## 8. Handoff with Strategist+## 8. Intent Ownership-The `Reference` field is **intent**, not a query. Strategist writes free-form intent; the receiving role translates.+The `Reference` field is **intent**, not a query. Strategist owns it by default; Quick's main agent owns it in the transient roster. The receiving role translates without reopening it.| ✅ Intent | ❌ Pre-processed ||---|---|@@ -111,19 +125,24 @@ The `Reference` field is **intent**, not a query. Strategist writes free-form in----## 9. Handoff with Executor+## 9. Handoff with SVG Authoring-Executor consumes the resource list plus:+SVG authoring consumes the resource roster plus:| Artifact | Path | Purpose ||---|---|---|| Image files | `project/images/*.{jpg,png,webp}` | `<image>` references || Manifest | `project/images/image_sources.json` | `license_tier` per Sourced image |-Executor does NOT invoke `image_gen.py` / `image_search.py` / `slice_images.py`.+**Default Generate boundary**: Executor does NOT invoke `image_gen.py` / `image_search.py` / `slice_images.py`; missing material returns to Strategist-owned preparation.++**Quick Generate boundary**: the main agent finishes acquisition before SVG authoring, then neither acquires nor reselects while drawing.---## 10. Task Completion Checkpoint-Verify internally that every row was processed, all triggered manifests/sidecars were written, and each result is `Generated`, `Sourced`, or `Needs-Manual`. Do not print a checklist. On success, auto-proceed to Executor and emit at most one compact status line when useful; on failure, report only the blocking rows and required recovery.+Verify every row, file, triggered manifest/sidecar, and provenance record.+Default proceeds to Executor. Quick proceeds without interaction after+preparation and exports only when every required row has validated evidence and+a usable status. Report only blocking recovery.diff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex 6762c30f..6decc4f2 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -2,9 +2,9 @@# Image_Generator Reference Manual-Role definition for the **AI image generation path**: convert each `Acquire Via: ai` row into an optimized prompt, generate the image, and save it to `project/images/`; also defines the `slice` derivation path for AI-generated illustration sheets.+Role definition for the **AI image generation path**: convert each active `Acquire Via: ai` row into an optimized prompt, generate the image, and save it to `project/images/`; also defines the `slice` derivation path for AI-generated illustration sheets.-**Trigger**: resource list rows with `Acquire Via: ai` or `slice`. The role is loaded only when at least one such row exists.+**Trigger**: the Default Generate resource list or Quick Generate transient roster contains `Acquire Via: ai` or `slice`. The role is loaded only when at least one such row exists.---@@ -45,7 +45,7 @@ Every AI image uses one deck-wide rendering, the deck's stable color anchors/sem| Dimension | Decides | When fixed ||---|---|---|| **Rendering** | Visual style family (vector / sketch-notes / 3d-isometric / corporate-photo / …) | Once per deck — every AI image in the deck shares one rendering |-| **Deck colors** | Core background / primary / accent / secondary-accent / text anchors from `spec_lock.md colors`, interpreted with the Design Spec and per-image context; these are not reconfirmed | Anchored after Stage 2 |+| **Deck colors** | Core background / primary / accent / secondary-accent / text anchors from `spec_lock.md colors` in Default Generate, or from the active-context visual decisions in Quick Generate | Default: anchored after Stage 2; Quick: resolved before acquisition || **Type** | Optional recall for a local structural infographic's internal skeleton (infographic / flowchart / framework / matrix / cycle / funnel / pyramid / comparison / timeline / map / scene). Use it when one template fits; otherwise omit type and write the composition directly in §4.1 E prose. Local single-subject/portrait and `hero_page` images also omit type. | Per image |> Rendering decides *how the image is drawn* (line quality, texture, depth). Color instructions begin from the deck roles: background / secondary background usually dominate, primary carries main forms, and accents stay scarce. Adjust proportions and derive coherent lighting/material/tint transitions for the image context; do not replace the deck's identity with an unrelated image-only palette.@@ -80,7 +80,7 @@ read_file references/image-type-templates/_index.md### Step 2 — Resolve deck-wide rendering + deck colors-**Primary path — Strategist already recorded rendering and core deck color anchors in `spec_lock.md colors`**:+**Default Generate path — Strategist already recorded rendering and core deck color anchors in `spec_lock.md colors`**:```image_rendering: vector-illustration@@ -91,11 +91,13 @@ accent: #D4AF37Use them as identity anchors. Do not create another user-facing image-color choice. The rendering and image subject may derive coherent tonal transitions, material colors, lighting, and atmospheric hues when the context requires them, while the core roles keep their established meaning.+**Quick Generate path**: the main agent resolves one active-context rendering/color set, honoring explicit user values and deciding the rest without interaction. Write it to `image_prompts.json`; create no planning artifacts.+**Hard rule — `custom` catalog basis**: when `image_rendering` is `custom`, first inspect the optional `image_rendering_references` row. If present, read every exact `image-renderings/<id>.md` it lists and synthesize their line, texture, depth, material, and mood guidance under `image_rendering_behavior` before assembling prompts. If absent, the custom is genuinely novel: read no preset file and use `image_rendering_behavior` directly. Never infer or add adjacent references during execution. The deck color-role rows remain authoritative.**Declared-inference fallback — when an existing `spec_lock.md` omits the `image_rendering` key** (see [`failure-recovery.md`](../workflows/governance/failure-recovery.md) §2):-This fallback covers a missing key only. An empty or invalid value stops for lock repair. If `spec_lock.md` itself is absent, stop at [`generate-pptx.md`](../workflows/generate-pptx.md) Step 5 before prompt assembly or image generation; do not use `design_spec.md` as a substitute.+This fallback covers a missing key only. An empty or invalid value stops for lock repair. Outside the active [`quick-generate`](../workflows/profiles/quick-generate.md) profile, if `spec_lock.md` itself is absent, stop at [`generate-pptx.md`](../workflows/generate-pptx.md) Step 5 before prompt assembly or image generation; do not use `design_spec.md` as a substitute.| Signal | Maps to ||---|---|@@ -118,25 +120,25 @@ Derive color behavior from the available roles and image context: background / s### Step 3 — Per-image type + assembly-For each `Acquire Via: ai` row in `design_spec.md §VIII`:+For each `Acquire Via: ai` row, use Strategist-owned §VIII/lock by default or the main agent's transient Quick roster. Explicit values remain binding; Quick resolves omissions automatically.-1. **Determine `page_role`** — Strategist's explicit value wins; a blank or omitted value resolves to `local`. `hero_page` must be explicit.-2. **Determine `text_policy`** — Strategist's value wins when set. **Declared-inference fallback for a blank or omitted value**: pick `none` or `embedded` from the row's `Purpose`, `Reference`, and page intent based on whether in-image text serves the page. Long body / data / lists stay in SVG.+1. **Determine `page_role`** — the owning row's explicit value wins; a blank or omitted value resolves to `local`. In Default Generate, `hero_page` must be Strategist-explicit; in Quick Generate, the main agent may resolve it while building the transient roster.+2. **Determine `text_policy`** — the owning row's value wins when set. **Declared-inference fallback for a blank or omitted value**: pick `none` or `embedded` from the row's `Purpose`, `Reference`, and page intent based on whether in-image text serves the page. Long body / data / lists stay in SVG.3. **Determine type or free composition** — an Illustration Sheet omits manifest `type` and follows §4.3's grid composition. For another local structural infographic, use one of the 11 types only when the `_index.md` offers a real match; otherwise omit type and author the intended structure directly with §4.1 E. A local single-subject/portrait image omits type and uses §4.1 A/B inside its actual region. A `hero_page` omits type and uses §4.1 A/B/C/D/E.4. `read_file references/image-type-templates/<type>.md` only when a type was selected (and only if not already read).5. **Assemble the prompt** by combining:- The rendering's style paragraph (from Step 2)- Color-role instructions anchored by the deck HEX values and refined for the image context (from Step 2)- The selected type's structural layout, or the no-type composition prose (from Step 3)- - The image's specific `Reference` intent (from `design_spec.md §VIII`)+ - The image's specific `Reference` intent (from `design_spec.md §VIII` or the Quick Generate transient roster)- Container sizing from the selected type file, or the row's Dimensions for no-type prose- The hard rules from §5 below (HEX-not-as-text, rendering-aligned human depiction and likeness authorization, text policy)The assembled prompt is **one cohesive paragraph**, not a bulleted list of tags. See §4 for the assembly template.-### Step 4 — Write the manifest and execute the confirmed path+### Step 4 — Write the manifest and execute the selected path-Write `project/images/image_prompts.json` per §6. Then follow §7 Path Selection. `image_gen.py --manifest` is Path A only; confirmed `host-native` runs the host image tool directly, and confirmed `manual` renders the Markdown sidecar and hands off without API generation.+Write `project/images/image_prompts.json` per §6, then follow §7. Default uses its confirmed path; Quick uses an explicit active-context path or `auto` without asking.---@@ -250,7 +252,7 @@ An illustration sheet can produce several small **spot illustrations** in one ge**Default — one sheet for a compatible spot family (may override when separate generation serves the assets better)**: Prefer a sheet when several elements share similar proportions, detail, quality, and semantic precision. Generate elements separately when those needs differ materially; quantity alone neither requires nor forbids a sheet. A single hero/local image stays with the normal one-row-per-image flow (§4.1).-**Hard rule**: a spot sheet is a generation source, not a slide asset. The sheet row is never listed in `spec_lock.md images` and never referenced from SVG. Only the sliced element rows are placed.+**Hard rule**: a spot sheet is a generation source, not a slide asset. In Default Generate, keep the sheet row out of `spec_lock.md images`; in Quick Generate, mark it generation-only in the transient roster. The sheet is never referenced from SVG. Only sliced element rows are placed.**Sheet prompt convention** (one manifest item, `page_role: local`, `text_policy: none`, `image_size` chosen from final placement size):@@ -276,10 +278,10 @@ Use that deliberately. On a wide sheet (`16:9`, `21:9`, `4:1`, `8:1`), `1xN` makIf one deck needs mixed shapes, create separate sheets per shape family unless one carefully designed grid gives every element enough room. Keep the visual family consistent through the same `deck_rendering` and `color_scheme`, not by forcing all cells into one square sheet.-**Resource contract — the sheet and its elements are different row kinds.** A sliced element can only be placed if it exists as a resource the Executor is allowed to reference (`spec_lock.md images`). So §VIII carries two row kinds (planning authority: [`strategist-image.md`](./strategist-image.md)):+**Resource contract — the sheet and its elements are different row kinds.** A sliced element can only be placed if it exists in the active placeable-resource authority: `spec_lock.md images` in Default Generate or the transient roster in Quick Generate. Default Generate keeps both row kinds in §VIII under [`strategist-image.md`](./strategist-image.md); Quick Generate resolves the same distinction in active context without creating planning artifacts:- **Sheet row** — `Acquire Via: ai`, `Type: Illustration Sheet`, the intent prompt, named as the slice source with its intended cell shape and placement purpose (`Reference: landscape footer-vignette spot set`). It is generated in Step 5 but **never placed on a slide** — keep it **out of** `spec_lock.md images`. Image_Generator resolves the exact `aspect_ratio`, grid, and slice command from this intent.-- **Element rows** — one per used element, `Acquire Via: slice`, filename matching a `--names` output, `Reference` naming the parent sheet + cell/element. These **are** placed — list every one in `spec_lock.md images`, normally with `crop=no-crop` (a tight-trimmed transparent spot should be fit, not cover-cropped). Their dimensions are filled in after slicing (Step 5 re-runs `analyze_images.py`). Each row carries a Strategist layout recommendation; Executor may realize it as a direct cutout or inside an appropriate container while preserving the resource and crop/content constraints.+- **Element rows** — one per used element, `Acquire Via: slice`, filename matching a `--names` output, `Reference` naming the parent sheet + cell/element. These **are** placed — list every one in the active placeable-resource authority, normally with `crop=no-crop` (a tight-trimmed transparent spot should be fit, not cover-cropped). Their dimensions are filled in after slicing (the preparation pass re-runs `analyze_images.py`). Each row carries an owner-resolved layout recommendation; SVG authoring may realize it as a direct cutout or inside an appropriate container while preserving the resource and crop/content constraints.For traceability, add optional `slice_grid` and `slice_names` fields to the sheet item in `image_prompts.json` after choosing the geometry. `image_gen.py` validates, preserves, and displays these metadata fields; it does not run the separate slicing command.@@ -296,7 +298,7 @@ python3 scripts/slice_images.py <project>/images/illus_sheet.png --grid 2x3 \2. **Clean grid, or it cuts ugly.** State the exact row/column structure and cell shape so the model does not invent a square matrix; `--trim` absorbs smaller placement variance. Do not generate several sheets or read them back merely to choose a favorite; re-roll only when user/live-preview feedback exposes an unusable slice.3. **Generate only as large as needed.** Each cell is a fraction of the sheet. Pick the smallest sheet size that keeps each sliced cell at least **1.5-2x** the intended display size. `1K` is usually enough for small 80-160px decorative spots; use `2K` for medium 180-320px placements; reserve `4K` for large, cropped, or potentially enlarged elements.-**Reference — sliced-asset placement is not a constraint**: A transparent slice may remain an unboxed cutout or enter a card, evidence frame, label, panel, or other suitable container. Strategist's layout text is an expression recommendation; Executor owns the actual geometry and treatment while preserving the resource role and crop/content constraints.+**Reference — sliced-asset placement is not a constraint**: A transparent slice may remain an unboxed cutout or enter a card, evidence frame, label, panel, or other suitable container. The owner-resolved layout text is an expression recommendation; SVG authoring owns the actual geometry and treatment while preserving the resource role and crop/content constraints.**Through-line — one family, many roles.** A spot sheet pays off more when the same motif family also drives the cover and section dividers. A large cover / divider anchor is not a giant sheet cell—generate it as its own `hero_page` image sharing the sheet's `deck_rendering`, `color_scheme`, and subject world. Plan this only when the deck leans into illustration, never as a quota.@@ -360,7 +362,7 @@ The font for in-image text is a free natural-language description, not an enum.The table below is **a reference for the one case where stable in-image lettering should read as the same typographic family as the SVG body** (e.g. an artistic cover wordmark should feel like the body Helvetica, not a surprise blackletter). Use it as a starting point, not a constraint.-| `spec_lock typography.font_family` contains | Optional descriptor if you want to echo the SVG body |+| Active typography source contains | Optional descriptor if you want to echo the SVG body ||---|---|| `KaiTi` / `FangSong` / `Georgia` / serif families | "elegant serif lettering, refined letterforms" || `Microsoft YaHei` / `PingFang SC` / `Arial` / sans-serif families | "clean geometric sans-serif, modern letterforms" |@@ -446,9 +448,9 @@ Write `project/images/image_prompts.json` with this shape:| Field | Required | Source | Description ||---|---|---|---|-| `deck_rendering` | yes | Step 2 lock | Single rendering name shared by all items in this deck |-| `color_scheme` | yes | `spec_lock.md colors` | Core deck color anchors shared by every item; prompts may add contextual tonal behavior, but no separate image palette |-| `items[].filename` | yes | `§VIII` resource list | Output filename with extension |+| `deck_rendering` | yes | Step 2 active authority | Single rendering name shared by all items in this deck |+| `color_scheme` | yes | Step 2 active authority | Core deck color anchors shared by every item; prompts may add contextual tonal behavior, but no separate image palette |+| `items[].filename` | yes | Active resource authority | Output filename with extension || `items[].type` | no | Step 3 per-image | Optional one-of-11 internal-composition type for a local structural infographic when a template genuinely fits. Omit it for custom §4.1 E prose, `hero_page`, an Illustration Sheet, and local single-subject/portrait prose. || `items[].page_role` | yes | Step 3 per-image | `local` (default — region block on SVG page) or `hero_page` (image is page's main voice; SVG overlay minimal or empty) || `items[].text_policy` | yes | Step 3 per-image | `none` (image carries no text — explicit visual rule) or `embedded` (image contains stable artistic lettering, hand-lettered keywords, or visual identifiers like axis labels / subplot letters / unit symbols). AI judges per image; no global default bias — see §5.3. |@@ -486,7 +488,9 @@ C (AI-generated) supports three implementation modes sharing one `image_prompts.| `IMAGE_BACKEND` not configured (or Path A fails) AND host has a native image tool | **Path B**: Host-native tool | Agent invokes the host's image capability; outputs land at `project/images/<filename>` || **Both Path A and Path B fail/unavailable** | **Offline Manual Mode** | Manifest stays on disk; user generates externally from `items[].prompt` and places files at `project/images/<filename>` |-**Selection logic — declared-procedure fallback when no path is confirmed**: the confirmed user choice wins. When neither channel confirmed a specific path, Generate Step 4 records the effective choice as `auto`; that explicit durable value uses the automatic A → B → C chain. A missing/blank/unknown project value is not an implicit API authorization:+**Quick Generate selection**: an explicit user instruction for `api`, `host-native`, or `manual` retained in active context wins. When the user did not specify a path, select `auto` and run the A → B → C chain without asking or creating a planning artifact.++**Default Generate selection — declared-procedure fallback when no path is confirmed**: the confirmed user choice wins. When neither channel confirmed a specific path, Generate Step 4 records the effective choice as `auto`; that explicit durable value uses the automatic A → B → C chain. A missing/blank/unknown project value is not an implicit API authorization:0. **Confirmed override (wins)** — honor `AI Image Acquisition Path` from `design_spec.md §I`. Generate Step 4 already consumed the final confirmation into that durable artifact; do not reopen `result.json` here. If the recorded choice is set and not `auto`, honor it directly, **even when it contradicts `IMAGE_BACKEND`**:- `api` → **Path A** (`image_gen.py --manifest`).@@ -497,7 +501,7 @@ C (AI-generated) supports three implementation modes sharing one `image_prompts.2. **Try Path B** — if `IMAGE_BACKEND` was not configured (A skipped), or A failed, and the host has a native image tool (Codex / Antigravity / Claude Code / similar), the agent invokes the host's image capability directly.3. **Fall to C (Offline Manual)** — if B is also unavailable (no host-native tool) or fails, write prompts to `images/image_prompts.json` and hand off to the user.-**Hard rule**: Step 4 is execution, not re-decision. Never present an interactive choice between paths here — image strategy was locked in Strategist Step 4 h item.+**Hard rule**: this step is execution, not re-decision. Default Generate uses the path locked in Strategist Step 4 h. Quick Generate uses the explicit active-context instruction or `auto`. Never present an interactive choice here.> All three modes share one output contract: file at `project/images/<filename>`. Step 6 SVG references are mode-agnostic.@@ -580,16 +584,21 @@ Triggered automatically when `IMAGE_BACKEND` is not configured (or Path A fails)1. Verify `images/image_prompts.json` was written2. Set `status: "Needs-Manual"` on every affected item per [`image-base.md`](./image-base.md) §6-3. Continue to Step 6 — Executor draws a dashed placeholder for each `Needs-Manual` row; the Step 7 image readiness gate verifies the supplied files and swaps them in+3. Apply the mode boundary:+ - Default Generate: continue to Step 6; Executor draws a dashed placeholder and Step 7 verifies the supplied file+ - Quick Generate: retain the prompt and `Needs-Manual` status, and block direct export until every required supplied file is validated and its row is reconciled to `Generated`4. Print one consolidated handoff to the user:- Filenames awaiting manual generation- Pointer to `images/image_prompts.md` (paste-ready `### Image N:` block per item) or `image_prompts.json` (`items[].prompt`)- Target placement: `project/images/<filename>` matching the resource list exactly- - Resume command: re-run Step 7 once all expected files exist+ - Resume: Default Generate re-runs Step 7; Quick Generate re-runs its resource gate, then `--quick-generate`-**User-initiated**: When Strategist Step 4 captured "user wants manual generation" up front, Path A is skipped from the start; the workflow above runs as a planned mode.+**User-initiated**: When Strategist Step 4 captured `manual` in Default Generate, or the user explicitly requested `manual` in the Quick Generate active context, Path A is skipped from the start.-> The pipeline tolerates `Needs-Manual` rows end-to-end. The user can leave the project, generate offline at their own pace, then resume Step 7.+> Default Generate tolerates `Needs-Manual` rows through authoring and resumes+> at Step 7. Quick Generate preserves the same manifest and handoff but does not+> run `--quick-generate` while a required row still says `Needs-Manual`; validate+> a later supplied file and update it to `Generated` first.#### AI-specific Failure Handling (extends image-base.md §6)@@ -650,7 +659,7 @@ Diagnose the failure category, adjust the **one specific dimension** responsible**Variant workflow**:1. Set the unsatisfactory item's `status` back to `Pending` and update its `prompt` in place-2. Re-run the same confirmed path used for the original item: Path A may re-run `image_gen.py --manifest` (only that item is re-processed); Path B uses the host-native tool again for that item; Offline Manual re-renders the sidecar and hands off+2. Re-run the same resolved path used for the original item: Path A may re-run `image_gen.py --manifest` (only that item is re-processed); Path B uses the host-native tool again for that item; Offline Manual re-renders the sidecar and hands off3. To try multiple stylistic approaches, append additional items with distinct filenames (e.g. `cover_bg_v2.png`) rather than overwriting---@@ -662,6 +671,6 @@ Diagnose the failure category, adjust the **one specific dimension** responsible- Mixing renderings or introducing an unrelated image-only palette across images in the same deck- Tag-soup prompts (keyword lists separated by commas without a coherent visual scene)- Globbing `image-renderings/*.md` or any subdirectory — read only the chosen preset or exact custom-reference files-- Placing an image without updating its `image_prompts.json` `status` and the resource list status+- Placing an image without updating its `image_prompts.json` `status` and the active resource authority's status- Switching rendering or core deck-color semantics for a single image—`hero_page` is not an exception to deck-wide coherence- Embedding body copy, data points, bullet lists, or long quotes inside an image — those route to SVGdiff --git a/skills/ppt-master/references/image-layout-spec.md b/skills/ppt-master/references/image-layout-spec.mdindex 46366fe7..e598e40d 100644--- a/skills/ppt-master/references/image-layout-spec.md+++ b/skills/ppt-master/references/image-layout-spec.md@@ -2,9 +2,9 @@# Image Layout Specification-Sizing reference for side-by-side or multi-image pages. Use after Strategist proposes a preferred composition; this file never locks layout or crop policy.+Sizing reference for side-by-side or multi-image pages. Use after the active resource owner proposes a preferred composition; this file never locks layout or crop policy.-**Preferred pattern, Executor-owned realization**: Let original aspect ratio inform the container. Every slide using a `no-crop` asset keeps one complete visible instance; a same-slide same-source detail crop may supplement it. An `adaptive` asset may use `meet` or a focal-safe `slice`. Rework geometry or choose another composition when the recommendation produces weak hierarchy, unsafe cropping, excessive dead space, or a poorer communication result. Preserve binding resource/content/crop constraints; a pattern-only change needs no upstream update.+**Preferred pattern, authoring-owned realization**: Let original aspect ratio inform the container. Every slide using a `no-crop` asset keeps one complete visible instance; a same-slide same-source detail crop may supplement it. An `adaptive` asset may use `meet` or a focal-safe `slice`. Rework geometry or choose another composition when the recommendation produces weak hierarchy, unsafe cropping, excessive dead space, or a poorer communication result. Preserve binding resource/content/crop constraints; a pattern-only change needs no upstream update.> **Scope**: The ratio tables and formulas are calculation aids for a selected side-by-side or multi-image plan. Hero, background, accent, and other compositions stay outside this file. Layout never overrides the `no-crop` boundary owned by [`strategist-image.md`](./strategist-image.md) and [`executor-image.md`](./executor-image.md).@@ -13,13 +13,13 @@ Sizing reference for side-by-side or multi-image pages. Use after Strategist pro## Layout Decision Flow```-1. Read the narrative intent, hierarchy, and preferred primary/modifier ids from Strategist's plan.-2. If the preferred or Executor-selected pattern is not side-by-side or multi-image, this spec does not apply.+1. Read the narrative intent, hierarchy, and preferred primary/modifier ids from the active resource authority.+2. If the preferred or authoring-selected pattern is not side-by-side or multi-image, this spec does not apply.3. Read the asset's `no-crop` boundary and original dimensions; calculate ratio (width/height).4. Use the tables as candidate structures, not an automatic selector.5. Calculate the image/text rectangles, then choose `meet` or focal-safe `slice` within the crop boundary.6. Revise geometry or choose another composition when the result weakens hierarchy, legibility, or required image content.-7. Return upstream only for a different resource, role, must-use decision, crop boundary, or another binding constraint; Executor owns pattern-only realization changes.+7. Return to the active resource owner only for a different resource, role, must-use decision, crop boundary, or another binding constraint; SVG authoring owns pattern-only realization changes.```**When to run**: after `analyze_images.py` has produced current dimensions and a side-by-side or multi-image composition is under consideration. Skip this sizing reference for other page structures.@@ -107,8 +107,8 @@ Image: 773x560 (left), Text area: 367x560 (right) → 7:3 left-right```Original: 1820x1040, R=1.75-Strategist compares top-bottom: image height=663, text area=-43 ❌-Strategist recommends left-right: image 780x446 (left), text area 360x600 (right) → 7:3 left-right+The resource owner compares top-bottom: image height=663, text area=-43 ❌+The resource owner recommends left-right: image 780x446 (left), text area 360x600 (right) → 7:3 left-right```---@@ -183,15 +183,16 @@ Image positions:## Handoff Fields-This spec only defines layout calculation. Write computed fields into the Image Resource List defined in [`svg-image-embedding.md`](svg-image-embedding.md):+This spec only defines layout calculation. Keep computed fields in the active resource authority defined in [`svg-image-embedding.md`](svg-image-embedding.md):| Field | Meaning ||-------|---------|| `Ratio` | Original image width / height |-| `Layout pattern` | Non-empty Strategist layout suggestion in free-form prose, optionally citing catalog ids; Executor-owned realization |-| `Crop Policy` | `no-crop` requires one complete instance; `adaptive` lets Executor choose `meet` or focal-safe `slice` |+| `Layout pattern` | Non-empty owner-resolved suggestion in free-form prose, optionally citing catalog ids; SVG-authoring realization |+| `Crop Policy` | `no-crop` requires one complete instance; `adaptive` lets SVG authoring choose `meet` or focal-safe `slice` || `Reference` | Optional calculated image/text rectangles, focal notes, and composition intent |-| `spec_lock.md images` value | `<path> | source=<Acquire Via> | pattern=<Layout pattern> | crop=<adaptive|no-crop>`; source/crop exactly project §VIII, while pattern preserves the normalized free-form suggestion and any optional catalog ids as a recommendation, not a geometry/realization lock |+| Default `spec_lock.md images` value | `<path> | source=<Acquire Via> | pattern=<Layout pattern> | crop=<adaptive|no-crop>`; source/crop exactly project §VIII, while pattern preserves the normalized free-form suggestion and any optional catalog ids as a recommendation, not a geometry/realization lock |+| Quick Generate transient row | Keep the same source/pattern/crop meanings in active context; do not create a lock |For SVG `<image>` syntax, path rules, `preserveAspectRatio`, external refs, and Base64 embedding: see [`svg-image-embedding.md`](svg-image-embedding.md).@@ -225,7 +226,7 @@ python3 scripts/analyze_images.py <project_path>/images --canvas ppt43 # PPTpython3 scripts/analyze_images.py <project_path>/images --canvas xiaohongshu # Xiaohongshu```-`--canvas` explicitly overrides the project-derived format; `ppt169` is only the fallback. The tool computes a top-bottom / left-right candidate, image display area, and text area from the formulas above. Treat its output as planning input; record the composition actually selected for the page.+`--canvas` explicitly overrides the project-derived format; `ppt169` is only the fallback. The tool computes a top-bottom / left-right candidate, image display area, and text area from the formulas above. Treat its output as decision input; retain the composition actually selected for the page in the active authority.---@@ -233,5 +234,6 @@ python3 scripts/analyze_images.py <project_path>/images --canvas xiaohongshu #| Role | Responsibility ||------|---------------|-| **Strategist** | Run `analyze_images.py`, recommend a catalog pattern, select resources, and record the crop boundary |-| **Executor** | Choose the actual composition for the asset/page while preserving role, source, must-use, content, and `no-crop` constraints |+| **Default Strategist** | Run `analyze_images.py`, recommend a catalog pattern, select resources, and record the crop boundary |+| **Default Executor** | Choose the actual composition for the asset/page while preserving role, source, must-use, content, and `no-crop` constraints |+| **Quick Generate main agent** | Complete the same analysis/selection in active context before SVG authoring, then keep the chosen resource/crop boundary stable while realizing the page |diff --git a/skills/ppt-master/references/image-searcher.md b/skills/ppt-master/references/image-searcher.mdindex ee439265..6be8cbaf 100644--- a/skills/ppt-master/references/image-searcher.md+++ b/skills/ppt-master/references/image-searcher.md@@ -2,9 +2,9 @@# Image_Searcher Reference Manual-Role definition for the **web image acquisition path**: translate Strategist intent into keyword queries, search openly-licensed providers, download a license-cleared image into `project/images/`, and record provenance + license metadata into `image_sources.json`.+Role definition for the **web image acquisition path**: translate the active resource owner's intent into keyword queries, search openly-licensed providers, download a license-cleared image into `project/images/`, and record provenance + license metadata into `image_sources.json`.-**Trigger**: resource list rows with `Acquire Via: web`. The role is loaded only when at least one such row exists.+**Trigger**: the Default Generate resource list or Quick Generate transient roster contains `Acquire Via: web`. The role is loaded only when at least one such row exists.---@@ -69,12 +69,13 @@ Keep two layers distinct:| Layer | Owner and grammar ||---|---|-| Design Spec §VIII `Reference` | Strategist's complete visual intent: exact subject, desired view/mood, focal or quiet region, and crop-safety constraints. Positive quality cues are valid here. |+| Default Generate `design_spec.md §VIII Reference` | Strategist's complete visual intent: exact subject, desired view/mood, focal or quiet region, and crop-safety constraints. Positive quality cues are valid here. |+| Quick Generate transient `Reference` | Current main agent's active-context intent after honoring explicit user assets, URLs, subjects, and constraints; unspecified choices are resolved automatically without confirmation. || `image_queries.json.items[].query` / positional query | Image_Searcher's concrete entity/identity keyword string. Start with the shortest phrase that preserves identity; keep exact multi-word names and necessary disambiguators even when they exceed four words. Omit mood, quality, composition, HEX, and negative wording. |Web APIs match metadata, not semantic intent. Providers try the original query first, then progressively simplified four/three/two/one-word variants. A pipeline manifest should therefore use a concise query without pre-truncating exact names. For Chinese landmarks, use the precise Chinese name with Wikimedia; for stock providers, use compact English identity terms when they retain the subject.-Image_Searcher consumes the locked Reference and never rewrites `design_spec.md` or `spec_lock.md`. A candidate either satisfies that existing subject/focal/crop intent, or the role tries materially different query/provider/permitted-license strategies until no untried strategy remains, then marks `Needs-Manual`. Never loosen `required_terms`, the license policy, or the locked intent to manufacture a match.+Image_Searcher consumes the active Reference and never rewrites its owner. In Default Generate, that means no rewrite of `design_spec.md` or `spec_lock.md`; in Quick Generate, the transient Reference remains fixed for the run. A candidate either satisfies that existing subject/focal/crop intent, or the role tries materially different query/provider/permitted-license strategies until no untried strategy remains, then marks `Needs-Manual`. Never loosen `required_terms`, the license policy, or the active intent to manufacture a match.When the subject is an exact entity (landmark / person / company / product / venue), write `required_terms` at the same time you write the row's `query`. Use one required group per identity anchor and `|` for aliases / translations, e.g. `["Chongqing|重庆", "Jiefangbei|解放碑|Liberation Monument"]`. This keeps the query short for provider search while preventing metadata-ranked wrong entities from being accepted.@@ -172,29 +173,36 @@ Do not tune this into a visual taste engine. The scorer prevents obvious metadat### Suitability review — with or without a multimodal model-A metadata-ranked top hit is *downloadable and token-relevant*, not necessarily *visually suitable* — `score_candidate` never sees pixels. Review it against the locked §VIII Reference and Crop Policy before it is trusted:+A metadata-ranked top hit is *downloadable and token-relevant*, not necessarily *visually suitable* — `score_candidate` never sees pixels. Review it against the active Reference and Crop Policy before it is trusted:-- **Multimodal model**: each download writes a downscaled review copy to `images/.review/<stem>.jpg` (the placed asset stays full-resolution). Judge subject identity, intended mood/view, focal or quiet region, and whether the locked crop policy remains safe.-- **Non-multimodal model (no vision)**: do **not** pretend to confirm. Hand off to a human — surface each web image's `source_page_url` from `image_sources.json` (live preview also shows the placed result) and let the user judge.+- **Multimodal model**: each download writes a downscaled review copy to `images/.review/<stem>.jpg` (the placed asset stays full-resolution). Judge subject identity, intended mood/view, focal or quiet region, and whether the active crop policy remains safe.+- **Non-multimodal model (no vision)**: do **not** pretend to confirm. Default Generate hands off via each `source_page_url`. Quick Generate does not open an interaction; mark a required image `Needs-Manual` when visual suitability cannot be established, preserve provenance, and let the quick export gate block.-For exact-entity rows, suitability has two gates: `required_terms` first enforces metadata identity, then the `.review` image confirms the pixels actually show the right subject and satisfy the locked focal/crop intent. Passing metadata never authorizes changing that intent downstream.+For exact-entity rows, suitability has two gates: `required_terms` first enforces metadata identity, then the `.review` image confirms the pixels actually show the right subject and satisfy the active focal/crop intent. Passing metadata never authorizes changing that intent downstream.Never treat a generic `required_terms` pass as acceptance. For example, matching `Ground Fissure` can return an unrelated transit station named Yunlong, and matching `stone pillar` can return a different scenic area. If the proper name / geography cannot be retained, stop at `Needs-Manual`.**Replacement ladder when a best match is not right** (any reviewer):1. refine the query and re-run that row while each revision tests a materially different identity phrase or disambiguator; do not repeat a semantically exhausted query;-2. **manual URL replace (universal, model-agnostic)** — the user finds a better image anywhere and gives its URL; download and swap it in:+2. **manual URL replace (universal, model-agnostic)** — use a user-supplied URL and swap it in:```bashpython3 scripts/image_search.py --from-url <image-url> --filename <name>.jpg -o <project_path>/images```- Recorded with `license_tier: manual` — verifying usage rights is the user's call. Human replacement is a legitimate outcome, not a failure. It updates the image and `image_sources.json` but does **not** rewrite `image_queries.json`, so a row fixed this way may still read `Needs-Manual` in the batch manifest — harmless: the file is present, so export proceeds ([`executor-web-image.md`](./executor-web-image.md) §1);+ Recorded with `license_tier: manual` — verifying usage rights is the user's+ call. In Quick Generate, use this step only when the URL was already+ supplied; never pause to request one. The command updates the image and+ `image_sources.json` but does **not** rewrite `image_queries.json`. Validate+ the downloaded file and matching manual-provenance entry, then reconcile+ that query row and the active roster to `Sourced` before export; a stale+ `Needs-Manual` status remains blocking+ ([`executor-web-image.md`](./executor-web-image.md) §1);3. (opt-in) `--save-candidates` to pull auto-alternatives with their own `source_page_url`s, then `--promote` the best (below);4. when the query variants, configured provider chain, and permitted license stages are exhausted and no user-confirmed manual URL is available, mark the row `Needs-Manual`.Web search is far cheaper than AI generation, so this review pass is well worth it.-**This review never halts the pipeline** (image-base §6 hard rule). It runs inside Step 5 image acquisition: an image that cannot be verified or replaced right now becomes `Needs-Manual` and the deck still builds (placeholder), so generation flows straight into Step 6. Manual `--from-url` replacement is an improvement step, not a blocking gate — do it now, or later from live preview, without stopping the run.+**This review never opens an acquisition-time interaction** ([`image-base.md`](./image-base.md) §6). Default Generate may build a placeholder and continue to Step 6. Quick Generate finishes all permitted automated strategies, records `Needs-Manual`, and blocks direct export when the unresolved image is required.### Manual review candidates (escalation, opt-in)@@ -306,11 +314,11 @@ CLI exit: `0` when all attempted rows resolve; `1` while any row remains `Failed----## 9. Handoff with Strategist+## 9. Handoff with the Intent OwnerReference field is **intent description**, not a query. See [`image-base.md`](./image-base.md) §8 for the rule.-Keep it intact as the acceptance contract. Derive a separate concise provider query that preserves exact names and necessary disambiguation; do not pass the Reference verbatim or rewrite it after search.+Keep it intact as the acceptance contract. In Default Generate the owner is Strategist; in Quick Generate it is the current main agent's transient roster. Derive a separate concise provider query that preserves exact names and necessary disambiguation; do not pass the Reference verbatim or rewrite it after search.---@@ -335,7 +343,7 @@ Executor does not interpret raw license strings — `license_tier` is sufficientIn addition to the shared checkpoint in [`image-base.md`](./image-base.md) §10:- [ ] Every web row has a downloaded file at `project/images/<filename>` OR is marked `Needs-Manual`-- [ ] Each `Sourced` web image was reviewed against the locked Reference/Crop Policy — a multimodal model via `images/.review/<stem>.jpg`, otherwise handed to the user via `source_page_url`; a mismatch was re-queried, replaced, escalated, or marked `Needs-Manual`, never repaired by rewriting the locked intent+- [ ] Each `Sourced` web image was reviewed against the active Reference/Crop Policy — a multimodal model via `images/.review/<stem>.jpg`; without vision, Default Generate hands off via `source_page_url` while Quick Generate records `Needs-Manual` without interaction. A mismatch was re-queried, replaced, escalated, or marked `Needs-Manual`, never repaired by rewriting the active intent- [ ] Each `Sourced` row has a manifest entry with valid `license_tier` and non-empty `attribution_text` (except `manual` `--from-url` rows, which carry no `attribution_text`)- [ ] Any `attribution-required` image has visible author + license credit in every SVG that references it- [ ] `metadata_dimensions` warnings surfaced when downloaded preview is much smaller than upstream-claimed sizediff --git a/skills/ppt-master/references/svg-image-embedding.md b/skills/ppt-master/references/svg-image-embedding.mdindex 7261f14a..50f36105 100644--- a/skills/ppt-master/references/svg-image-embedding.md+++ b/skills/ppt-master/references/svg-image-embedding.md@@ -8,7 +8,12 @@ Technical spec and workflow for adding images to SVG files.## Image Resource List Format-Defined in the Design Specification & Content Outline; each image carries an `Acquire Via` field plus a status annotation. This file is authoritative for status names and SVG embedding behavior. If image approach includes "B) User-provided": run `analyze_images.py` right after the Strategist confirmation stage and complete the list before outputting the design spec.+Each image carries an `Acquire Via` field plus a status annotation. This file is authoritative for status names and SVG embedding behavior.++| Mode | Resource authority and preparation timing |+|---|---|+| Default Generate | `design_spec.md §VIII` plus its lock projection; when user-provided images are selected, run `analyze_images.py` after Strategist confirmation and complete the list before Executor |+| Quick Generate | Current main agent's transient active-context roster; materialize explicit user paths first, resolve unspecified acquisition decisions automatically, and finish user/ai/web/slice/formula preparation before SVG authoring without confirmation |```markdown| Filename | Dimensions | Purpose | Type | Layout pattern | Crop Policy | Acquire Via | Status | Reference |@@ -26,7 +31,7 @@ Defined in the Design Specification & Content Outline; each image carries an `Ac| **Generated** | AI-generated file exists at expected path, or sliced element file exists at expected path | Reference from `../images/`; no on-slide credit needed. **Exception**: an `Illustration Sheet` row is only a slice source — it lives in §VIII but never in `spec_lock.md images`, so the Executor never places it || **Sourced** | Web-sourced file exists at expected path | Reference from `../images/`; check `image_sources.json` for `license_tier` — if `attribution-required`, render an inline credit element on the slide (see [`executor-web-image.md`](./executor-web-image.md) §1 and [`image-searcher.md`](./image-searcher.md) §7 for the attribution contract) || **Rendered** | Deterministic formula PNG exists at expected path (`Acquire Via: formula`) | Reference from `../images/`; use a legal anchor with `meet` for the complete placement (centered default: `xMidYMid meet`) and do not crop |-| **Needs-Manual** | Automatic acquisition is unavailable/exhausted or the confirmed path requires manual fulfillment; for `slice`, the parent sheet is unavailable | Dashed placeholder unless the user has supplied the expected file. For `slice` rows, supply the parent sheet and rerun `slice_images.py`; do not hand-place individual element files |+| **Needs-Manual** | Automatic acquisition is unavailable/exhausted or the selected path requires manual fulfillment; for `slice`, the parent sheet is unavailable | Default Generate may use a dashed placeholder until its readiness gate. Quick Generate blocks every required row still in this status, even if an unverified candidate file exists; validate a supplied replacement and reconcile it to `Generated`, `Sourced`, or `Rendered` first. For `slice`, supply the parent sheet and rerun `slice_images.py`; do not hand-place individual element files. || **Existing** | User already has image (`Acquire Via: user`) | Place in `images/`, reference with `<image>` || **Placeholder** | Intentionally not prepared yet (`Acquire Via: placeholder`) | Dashed border placeholder; replace later |@@ -35,24 +40,29 @@ Defined in the Design Specification & Content Outline; each image carries an `Ac## Workflow```-1. Strategist defines image needs → Add image resource list with Acquire Via + Status per row-2. Image Acquisition (Step 5):+1. Resolve image needs:+ - Default Generate → Strategist-owned resource list + lock projection+ - Quick Generate → current main agent builds a transient roster in active context; explicit user paths/URLs/choices win, unspecified choices use automatic resolution, no interaction+2. Prepare project-local resources before SVG authoring:+ - user → materialize the explicit source under project/images/ → Existing+ - formula → write formula_manifest.json and run latex_render.py → Rendered- Pending / Failed + ai → Image_Generator runs image_gen.py → Generated- Pending / Failed + web → Image_Searcher runs image_search.py → Sourced- Pending + slice → after parent AI sheet is Generated, slice_images.py cuts element files → Generated- - formula / user / placeholder rows are skipped-3. Executor generates SVGs (svg_output/)+3. SVG authoring consumes only prepared resources (Executor in Default Generate; current main agent in Quick Generate)├── Existing / Generated → <image href="../images/xxx.png" .../>├── Sourced + license_tier=no-attribution → <image href=...> only├── Sourced + license_tier=attribution-required → <image href=...> + small <text> credit element on the slide├── Sourced + license_tier=manual → <image href=...> only (user-supplied --from-url; rights/credit are user responsibility)├── Rendered formula → <image href="../images/formula_001.png" preserveAspectRatio="xMidYMid meet" .../>- └── Placeholder / Needs-Manual without file → Dashed border + description text+ └── Placeholder / Needs-Manual → Dashed border + description text until a supplied file is validated and status is reconciled4. Preview: python3 -m http.server -d <project_path> 8000 → /svg_output/<filename>.svg-5. Post-processing & Export → follow [`generate-pptx.md`](../workflows/generate-pptx.md) Step 7+5. Export:+ - Default Generate → follow [`generate-pptx.md`](../workflows/generate-pptx.md) Step 7+ - Quick Generate → after every required resource has a validated expected file/provenance and a usable status, run the profile's direct `--quick-generate` export```-> Keep external references in `svg_output/` during generation. `finalize_svg.py` auto-embeds images into the mandatory `svg_final/` visual preview; native PPTX export independently reads `svg_output/`.+> Keep external references in `svg_output/` during generation. Default Generate uses `finalize_svg.py` to embed images into the mandatory `svg_final/` visual preview. Quick Generate omits that preview artifact. Both native PPTX exports independently read image references from `svg_output/`.**Hard rule — export boundary**: `svg_final/` is a self-contained SVG preview for embeddable raster/SVG assets and may be manually inserted into PowerPoint as an SVG picture. EMF/WMF assets retain the documented external-reference exception for lossless native passthrough. The only supported generated-PPTX route is `svg_output/` through the project SVG-to-DrawingML converter. PowerPoint's manual Convert-to-Shape operation is unsupported.@@ -126,11 +136,11 @@ python3 -m http.server -d <project_path> 8000## Conversion Process-Follow [`generate-pptx.md`](../workflows/generate-pptx.md) Step 7; it owns the-serial post-processing and export commands. Its mandatory finalization step-embeds image references into the self-contained `svg_final/` preview, while the-supported native PPTX release still reads `svg_output/` and maps it directly to-DrawingML.+Default Generate follows [`generate-pptx.md`](../workflows/generate-pptx.md)+Step 7; it owns the serial post-processing and export commands. Quick Generate+follows [`quick-generate.md`](../workflows/profiles/quick-generate.md) after its+required-resource gate. The native PPTX converter reads `svg_output/` and maps+its project-local image references directly to DrawingML in both modes.### Standalone: align_embed_images.py (advanced)diff --git a/skills/ppt-master/scripts/docs/image.md b/skills/ppt-master/scripts/docs/image.mdindex ae6020a8..c428b4ea 100644--- a/skills/ppt-master/scripts/docs/image.md+++ b/skills/ppt-master/scripts/docs/image.md@@ -9,7 +9,11 @@ Image tools cover formula rendering, prompt-based AI generation, web image searc## `latex_render.py`-Manifest-driven LaTeX formula renderer. Strategist writes `images/formula_manifest.json` after the Typography confirmation; this script renders only those declared formulas to transparent PNGs and writes dimensions back into the manifest.+Manifest-driven LaTeX formula renderer. Default Generate has Strategist write+`images/formula_manifest.json` after Typography confirmation; Quick Generate+has the current agent write the same resource manifest without confirmation.+This script renders only those declared formulas to transparent PNGs and writes+dimensions back into the manifest.```bashpython3 scripts/latex_render.py <project_path>@@ -37,18 +41,21 @@ Manifest shape:}```-Output files land directly under `project/images/`. Formula filenames should use a shared `formula_` prefix, e.g. `formula_001.png`. The default provider chain is `codecogs,quicklatex,mathpad,wikimedia`; each provider is tried automatically until one succeeds, and the winning provider is recorded back into the manifest. `--providers` or manifest-level `providers` may override the order, but all four are available as no-key fallbacks. Formula PNGs are transparent by default. `background` is the temporary render matte and local background-removal reference; set `transparent: false` only when an opaque final formula asset is intentional. The script does not scan `spec_lock.md` or source documents for `$...$`; formula selection is a Strategist decision.+Output files land directly under `project/images/`. Formula filenames should use a shared `formula_` prefix, e.g. `formula_001.png`. The default provider chain is `codecogs,quicklatex,mathpad,wikimedia`; each provider is tried automatically until one succeeds, and the winning provider is recorded back into the manifest. `--providers` or manifest-level `providers` may override the order, but all four are available as no-key fallbacks. Formula PNGs are transparent by default. `background` is the temporary render matte and local background-removal reference; set `transparent: false` only when an opaque final formula asset is intentional. The script does not scan `spec_lock.md` or source documents for `$...$`; formula selection belongs to the active resource owner.## `image_gen.py`Unified image generation entry point.-This script is the **Path A** API/proxy executor for generated images. In the-PPT pipeline, always check `design_spec.md §I / AI Image Acquisition Path`-before running manifest mode: only `api` / `auto` permits Path A;-`host-native` uses the host's image tool directly and `manual` uses the-read-only Markdown sidecar. For a project manifest, a missing or unknown value-fails closed and returns to Generate Step 4 recovery.+This script is the **Path A** API/proxy executor for generated images. Default+Generate checks `design_spec.md §I / AI Image Acquisition Path` before manifest+mode: only `api` / `auto` permits Path A; a missing or unknown value fails+closed and returns to Step 4 recovery. Quick Generate has no Design Spec: use+the explicit active-context path when supplied, otherwise `auto` selects the+A → B → C chain defined in+[`image-generator.md`](../../references/image-generator.md) §7 without asking.+In either profile, `host-native` uses the host image tool directly and `manual`+uses the read-only Markdown sidecar.```bashpython3 scripts/image_gen.py "A modern futuristic workspace"diff --git a/skills/ppt-master/scripts/docs/svg-pipeline.md b/skills/ppt-master/scripts/docs/svg-pipeline.mdindex f8089b1d..68a06d5f 100644--- a/skills/ppt-master/scripts/docs/svg-pipeline.md+++ b/skills/ppt-master/scripts/docs/svg-pipeline.md@@ -546,20 +546,28 @@ warning and uses `flat`; no SVG regeneration is required. A missing `spec_lock.man explicit legacy/unknown mode, or a requested `structured` export without anexplicit current structured contract remains blocking.-Explicit direct generation from fact-sufficient self-contained content may use-the [`quick-generate`](../../workflows/profiles/quick-generate.md) profile:+Explicit direct generation may use the+[`quick-generate`](../../workflows/profiles/quick-generate.md) profile after the+current agent has converted/read sources, researched identified factual gaps,+and prepared the required images, icons, formulas, and resource manifests as+needed. That profile skips Strategist, Confirm UI, `design_spec.md`, and+`spec_lock.md`; it does not skip the resources required by the authored pages:```bashpython3 scripts/svg_to_pptx.py <project_path> --quick-generate```-This direct-export flag reads only `svg_output/`, 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; non-quiet runs report+This direct-export flag takes `svg_output/` as its authored page source, resolves+valid project-local resources referenced by those pages, infers one consistent+canvas, uses flat converter-default package scaffolding, disables notes and+motion, and does not read or require `spec_lock.md`. The exporter itself writes+the PPTX only: no `backup/`, conversion trace, or `validation/` report. Existing+source, analysis, image/icon/formula, and resource-manifest artifacts are+allowed and remain untouched. ZIP integrity and Slide count are checked in+memory; non-quiet runs report`[QUICK-GENERATE] status=passed`. The flag rejects options that would add native-data objects, motion, narration, alternate SVG sources, or diagnostic sidecars.+data objects, motion, narration, alternate SVG sources, or export diagnostic+sidecars.The receipt proves only ZIP integrity and equality between discovered SVG andpublished Slide counts; it is not an SVG-quality, visual, factual, or normalpostflight approval.diff --git a/skills/ppt-master/scripts/icon_sync.py b/skills/ppt-master/scripts/icon_sync.pyindex 25d572f0..4b97ad0b 100644--- a/skills/ppt-master/scripts/icon_sync.py+++ b/skills/ppt-master/scripts/icon_sync.py@@ -6,8 +6,8 @@ Copy chosen library icons into `<project>/icons/<lib>/` when selected. Missingnames exit non-zero before export. Known basenames need no separate existencecheck; search the chosen library only for unresolved concepts.-Project-local custom icons count as satisfied. In one Strategist selection-batch, `simple-icons` may accompany one of the four stylistic libraries for+Project-local custom icons count as satisfied. In one resource-selection batch,+`simple-icons` may accompany one of the four stylistic libraries forreal brand marks.Usage:diff --git a/skills/ppt-master/scripts/latex_render.py b/skills/ppt-master/scripts/latex_render.pyindex 150d4974..1ae4f9ac 100644--- a/skills/ppt-master/scripts/latex_render.py+++ b/skills/ppt-master/scripts/latex_render.py@@ -2,7 +2,7 @@"""PPT Master - LaTeX Formula Renderer-Render Strategist-declared LaTeX formulas to transparent PNG assets.+Render project-declared LaTeX formulas to transparent PNG assets.The script reads an explicit manifest; it never scans spec_lock.md or sourcecontent for dollar-delimited math.@@ -553,7 +553,7 @@ def render_manifest(def build_parser() -> argparse.ArgumentParser:"""Build the CLI parser."""parser = argparse.ArgumentParser(- description="Render Strategist-declared LaTeX formulas to PNG assets.",+ description="Render project-declared LaTeX formulas to PNG assets.",formatter_class=argparse.RawDescriptionHelpFormatter,)parser.add_argument("project_path", type=Path, help="Project directory.")diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 630addd6..1f2ae61b 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": 397825+ "max_tokens": 399925},"file_budgets": {"AGENTS.md": 2400,@@ -33,7 +33,7 @@"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,- "skills/ppt-master/workflows/generate-pptx.md": 13775,+ "skills/ppt-master/workflows/generate-pptx.md": 13825,"skills/ppt-master/workflows/stages/apply-template-workspace.md": 1800},"load_sets": {@@ -170,10 +170,10 @@"registry": "visual-styles"}],- "max_tokens": 62075+ "max_tokens": 62225},"route.generate.quick-generate": {- "description": "Explicit Generate direct-authoring short circuit with the shared SVG authoring core.",+ "description": "Explicit non-interactive Generate path with conditional source/resource preparation and the shared SVG authoring core.","scope": "cumulative","include": ["bootstrap.routing"@@ -181,9 +181,75 @@"files": ["skills/ppt-master/workflows/generate-pptx.md","skills/ppt-master/workflows/profiles/quick-generate.md",+ "skills/ppt-master/references/artifact-ownership.md","skills/ppt-master/references/shared-standards-core.md"],- "max_tokens": 31825+ "max_tokens": 36525+ },+ "route.generate.quick-generate.topic-research": {+ "description": "Quick Generate with gap-targeted factual research before direct resource preparation and SVG authoring.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate",+ "stage.generate.topic-research"+ ],+ "files": [],+ "max_tokens": 38025+ },+ "route.generate.quick-generate.icon": {+ "description": "Quick Generate with project-local bundled icon selection and synchronization.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate"+ ],+ "files": [+ "skills/ppt-master/templates/icons/README.md"+ ],+ "max_tokens": 38425+ },+ "route.generate.quick-generate.in-hand-image": {+ "description": "Quick Generate with supplied, extracted, or placeholder image resources prepared before SVG authoring.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate",+ "stage.generate.executor.image"+ ],+ "files": [],+ "max_tokens": 43450+ },+ "route.generate.quick-generate.formula": {+ "description": "Quick Generate with manifest-driven formula rendering and formula-image realization.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate",+ "stage.generate.executor.image"+ ],+ "files": [+ "skills/ppt-master/scripts/docs/image.md"+ ],+ "max_tokens": 46650+ },+ "route.generate.quick-generate.ai-two-types": {+ "description": "Quick Generate with AI resource preparation, representative rendering inputs, and two local image types.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate",+ "stage.generate.image.ai-two-types",+ "stage.generate.executor.image"+ ],+ "files": [],+ "max_tokens": 66500+ },+ "route.generate.quick-generate.web-image": {+ "description": "Quick Generate with web resource preparation, provenance, attribution, and image execution.",+ "scope": "cumulative",+ "include": [+ "route.generate.quick-generate",+ "stage.generate.image.web",+ "stage.generate.executor.web-image"+ ],+ "files": [],+ "max_tokens": 51200},"route.generate.planning-image": {"description": "Generate-PPTX planning context after a non-none image source is proposed or confirmed; layout-catalog recall remains optional.",@@ -203,7 +269,7 @@"stage.generate.strategist.image"],"files": [],- "max_tokens": 64500+ "max_tokens": 64650},"route.generate.planning-ai": {"description": "Generate-PPTX planning when AI image direction is available, including representative multi-source custom rendering synthesis.",@@ -335,7 +401,7 @@"stage.generate.executor.notes"],"files": [],- "max_tokens": 87725+ "max_tokens": 87900},"route.generate.flat-ai-two-types": {"description": "Generate-PPTX context with AI images, representative multi-source custom rendering, and two local types.",@@ -393,7 +459,7 @@"profile.generate.beautify-pptx"],"files": [],- "max_tokens": 94675+ "max_tokens": 94825},"route.generate.flat-no-image-chart": {"description": "Default flat Generate-PPTX path with chart authoring, native-data replacement, and verification.",@@ -406,7 +472,7 @@"stage.generate.verify-charts"],"files": [],- "max_tokens": 112075+ "max_tokens": 112225},"route.generate.brand-flat-no-image": {"description": "Brand-preset flat Generate-PPTX path without image acquisition.",@@ -418,7 +484,7 @@"stage.generate.template.brand"],"files": [],- "max_tokens": 94775+ "max_tokens": 94925},"route.generate.deck-structured-no-image": {"description": "Deck-preset structured Generate-PPTX path without image acquisition.",@@ -430,7 +496,7 @@"stage.generate.template.deck"],"files": [],- "max_tokens": 104700+ "max_tokens": 104875},"route.generate.layout-structured-no-image": {"description": "Layout-preset structured Generate-PPTX path without image acquisition.",@@ -442,7 +508,7 @@"stage.generate.template.layout"],"files": [],- "max_tokens": 105150+ "max_tokens": 105325},"route.generate.topic-only-flat-no-image": {"description": "Topic research followed by the default flat no-image Generate-PPTX path.",@@ -452,7 +518,7 @@"route.generate.flat-no-image"],"files": [],- "max_tokens": 89125+ "max_tokens": 89400},"stage.generate.executor.flat": {"description": "Incremental flat Executor core with representative multi-source custom mode/style execution.",@@ -528,7 +594,7 @@"registry": "image-type-templates"}],- "max_tokens": 23000+ "max_tokens": 23050},"stage.generate.image.web": {"description": "Incremental web-image acquisition role.",@@ -537,7 +603,7 @@"skills/ppt-master/references/image-base.md","skills/ppt-master/references/image-searcher.md"],- "max_tokens": 7000+ "max_tokens": 7275},"stage.generate.resume-execute": {"description": "Fresh-session resume plus the flat Executor core and post-SVG notes rules.",@@ -632,7 +698,7 @@"skills/ppt-master/scripts/docs/pptx-transitions.md","skills/ppt-master/scripts/docs/svg-pipeline.md"],- "max_tokens": 28850+ "max_tokens": 28975},"stage.generate.video-motion-plan": {"description": "Conditional resolved animation-to-video handoff contract.",@@ -698,7 +764,7 @@"stage.generate.strategist.template"],"files": [],- "max_tokens": 64150+ "max_tokens": 64300},"route.generate.planning-template-ai": {"description": "Explicit template workspace plus confirmed AI-image planning.",@@ -1120,10 +1186,6 @@"glob": "skills/ppt-master/scripts/README.md","reason": "Script inventory for maintainers; not loaded by generation roles."},- {- "glob": "skills/ppt-master/scripts/docs/image.md",- "reason": "Maintainer command reference; image roles use their owning role documents instead."- },{"glob": "skills/ppt-master/scripts/docs/project.md","reason": "Maintainer command reference; route steps carry the required project commands."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.pyindex 8df424e3..495afce1 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@@ -813,7 +813,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/quick_generate_demo --quick-generate # Direct: svg_output/ -> PPTX, no sidecars+ %(prog)s projects/quick_generate_demo --quick-generate # Direct: svg_output/ -> PPTX, no export sidecars# Disable transition / change transition effect%(prog)s examples/ppt169_demo -t none@@ -1994,7 +1994,7 @@ Recorded narration:print(" [QUICK-GENERATE] "f"status=passed slides={package['slides']} "- "sidecars=none"+ "export_sidecars=none")print(f" [PPTX] {native_path}")return 0diff --git a/skills/ppt-master/templates/icons/README.md b/skills/ppt-master/templates/icons/README.mdindex 1b6f40be..669f86b4 100644--- a/skills/ppt-master/templates/icons/README.md+++ b/skills/ppt-master/templates/icons/README.md@@ -1,6 +1,6 @@# SVG Icon Library-This directory provides **11,600+ high-quality SVG icons** across five libraries that can be directly embedded into SVG files generated by PPT Master. When the Strategist selects bundled generic icons, it chooses at most one primary library from the four stylistic libraries; the brand-logo library (`simple-icons`) may be selected alone or alongside it.+This directory provides **11,600+ high-quality SVG icons** across five libraries that can be directly embedded into SVG files generated by PPT Master. Default Strategist or the Quick Generate main agent chooses at most one primary library from the four stylistic libraries; the brand-logo library (`simple-icons`) may be selected alone or alongside it.## Libraries@@ -16,7 +16,7 @@ This directory provides **11,600+ high-quality SVG icons** across five libraries## Per-project icons folder-This directory is the **global library**. At selection time the Strategist copies the chosen icons into the deck's own `<project>/icons/<lib>/` with `icon_sync.py`:+This directory is the **global library**. The active resource owner copies chosen icons into the deck's own `<project>/icons/<lib>/` with `icon_sync.py` before SVG authoring:```bashpython3 skills/ppt-master/scripts/icon_sync.py <project_path> tabler-outline/home tabler-outline/bulb simple-icons/github@@ -97,7 +97,7 @@ Do not load a full index or enumerate broad keyword families. Re-pick from the n> 1. **Geometry**: straight lines (`chunk-filled`) vs. curves (`tabler-filled` / `phosphor-duotone`) vs. open strokes (`tabler-outline`)> 2. **Visual weight**: heavy solid (`chunk-filled`) → medium solid (`tabler-filled`) → medium layered (`phosphor-duotone`) → light stroke (`tabler-outline`)-**One primary bundled stylistic library per Strategist selection.** Pick one of `chunk-filled` / `tabler-filled` / `tabler-outline` / `phosphor-duotone` for generic icons (home, chart, users, etc.). If it lacks an exact icon, find the closest available alternative within that library instead of selecting from another bundled stylistic library. This is a catalog-selection rule, not a prohibition on combining assets that already exist in the project's `icons/` directory.+**One primary bundled stylistic library per deck selection.** Pick one of `chunk-filled` / `tabler-filled` / `tabler-outline` / `phosphor-duotone` for generic icons (home, chart, users, etc.). If it lacks an exact icon, find the closest available alternative within that library instead of selecting from another bundled stylistic library. This is a catalog-selection rule, not a prohibition on combining assets that already exist in the project's `icons/` directory.**Brand-logo exception (`simple-icons`).** `simple-icons` is **not a stylistic library** and does not participate in the "one library" rule. Its job is brand recognition — Slack's purple, GitHub's cat, AWS's color — which is intentionally heterogeneous. Use it **alone or alongside** the chosen stylistic library, but **only** for actual company / product / service brand marks. Do **not** reach for it as a substitute when the chosen stylistic library lacks a generic icon.diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.mdindex d8a52ca5..0832fe1b 100644--- a/skills/ppt-master/workflows/generate-pptx.md+++ b/skills/ppt-master/workflows/generate-pptx.md@@ -17,15 +17,18 @@ description: Generate PPTX route authority for source intake, planning, SVG auth### Quick Generate Profile Short Circuit-For an explicit quick/fast or direct-SVG request with fact-sufficient-self-contained content, follow-[`quick-generate.md`](./profiles/quick-generate.md). It owns the direct-SVG-to-PPTX sequence and skips this route's Steps 1–7.+For an explicit quick/fast, skip-strategy, or direct-SVG request, follow+[`quick-generate.md`](./profiles/quick-generate.md). It runs applicable source+conversion/research and project-local resource preparation, lets the current+agent decide content/visual/resource details in active context, then+hand-authors SVG and exports directly. It invokes no Strategist, Confirm UI,+Design Spec refinement, or lock authoring.**Hard rule — no implicit downgrade or page cap**: page count neither selects-nor blocks quick generation. Conversion, research, templates, asset-acquisition, native data objects, notes, motion, narration, or visual review-requires the default pipeline below.+nor blocks quick generation. Source preparation, images, icons, formulas, and+their manifests remain valid. Structured template reuse, native data objects,+Live Preview, notes, motion, narration, or visual-review delivery requires the+default pipeline; do not silently drop those requested capabilities.### SVG Page-Design Boundarydiff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.mdindex 7696e7f0..a5524fa8 100644--- a/skills/ppt-master/workflows/profiles/quick-generate.md+++ b/skills/ppt-master/workflows/profiles/quick-generate.md@@ -1,78 +1,106 @@----description: Generate profile for directly authoring a self-contained SVG deck and exporting one PPTX without Strategist planning or sidecar artifacts.+description: Generate profile for agent-decided source and resource preparation, direct SVG authoring, and one PPTX export without Strategist or confirmation artifacts.---# Quick Generate Profile-> Generate-PPTX profile, not a top-level route. Use it when the user explicitly-> requests a direct SVG-to-PPTX shortcut and supplies enough content to author-> the deck without the default [`generate-pptx.md`](../generate-pptx.md)-> Steps 1–7.+> Generate-PPTX profile, not a top-level route. It removes the separate+> Strategist and confirmation phase; it does not remove the facts or visible+> resources needed to build the deck.-**Trigger**: the user explicitly requests quick/fast generation or directs the-agent to skip planning/confirmation and proceed directly to SVG, and the request-contains enough content for direct authoring without conversion or research.+**Trigger**: the user explicitly requests quick/fast generation, asks to skip+strategy/confirmation, or directs the agent to proceed to SVG and export.Page count alone never activates or blocks this profile.----## 1. Eligibility+## 1. Profile Boundary-| Condition | Required state |+| Concern | Quick Generate contract ||---|---|-| Intent | Explicit direct-generation shortcut |-| Content | Supplied in chat or directly readable text/Markdown, and sufficient without conversion or research |-| Visual inputs | Basic SVG geometry/text or already supplied self-contained data; no asset acquisition |-| Output | Only authored SVG pages and one native PPTX |+| Interaction | The current main agent resolves routine content, page, visual, and resource choices in active context; do not invoke Strategist, open Confirm UI, or wait for design confirmation |+| Inputs | Any supported Generate input; convert/import sources and run bounded factual research when the input requires them |+| Resources | Prepare every project-local image, icon, formula, and required provenance/manifest artifact before the referencing SVG is authored |+| Planning artifacts | Do not create `design_spec.md`, `spec_lock.md`, confirmation payloads, or a second persisted strategy |+| Delivery | Hand-author the resolved SVG roster and export one native PPTX through `--quick-generate` |++**Hard rule — speed removes interaction, not material**: source conversion,+topic research, supplied/extracted assets, AI or web images, illustration+slices, project icons, formula rendering, and regenerated image facts remain+available whenever the deck needs them. The workspace may therefore contain+`sources/`, `analysis/`, `images/`, `icons/`, and their operational manifests.+Do not misread direct export's lack of report sidecars as a ban on resource+artifacts.++Explicit user facts, wording, choices, exclusions, and permission boundaries+still win. For every unspecified routine choice, decide directly and continue;+do not ask the user to approve a provisional strategy. Stop only when a required+fact/resource cannot be resolved safely or an explicit user decision is+genuinely required.++Structured template reuse, native chart/table replacement, Live Preview,+speaker notes, animation, narration, and visual-review delivery remain+default-pipeline capabilities. Do not silently discard one of those requested+capabilities to fit this profile. Source preparation and visible-page resource+preparation do not disqualify Quick Generate.-**Missing eligibility** → use the default Generate pipeline. Do not silently-discard requested capabilities to fit this profile.+---++## 2. Source and Resource Preparation++Run [`generate-pptx.md`](../generate-pptx.md) Step 1 source conversion and+bounded research when applicable. Initialize/import the project through Step 2+when those tools or project-local resources are needed, but never scaffold a+Design Spec or lock. Use a new project path, or first verify that its+`svg_output/` is empty and that no `design_spec.md` / `spec_lock.md` from+another pipeline is present.++Before writing P01, resolve in active context:-**Hard rule — explicit scope only**: requests that require source conversion,-factual research, template application, external image/icon/font acquisition,-native charts/tables, speaker notes, animation, narration, or visual review stay-on the default pipeline. Supplied fact-sufficient content may use this profile;-the shortcut must not invent or externally enrich claims.+- 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;+- the implementation path for each resource. An explicit user path wins;+ otherwise choose the registered automatic/default path without another+ interaction.++Prepare only the resource paths that the roster triggers:++| Resource | Required preparation |+|---|---|+| Supplied/extracted image | Copy the selected file into `images/`; preserve its factual/provenance context and use the measured file rather than an invented substitute |+| Bundled/custom icon | Follow the [icon library contract](../../templates/icons/README.md), resolve the selected SVG under project `icons/`, and use `icon_sync.py` for bundled icons |+| Formula | Follow the [`latex_render.py` contract](../../scripts/docs/image.md), write `images/formula_manifest.json`, run the renderer, and keep the rendered PNG under `images/` |+| AI image | Follow `image-base.md` + `image-generator.md`; keep `image_prompts.json` and its human-readable sidecar |+| Web image | Follow `image-base.md` + `image-searcher.md`; keep query/status data and `image_sources.json`, including any required on-slide attribution |+| Illustration slice | Generate or obtain the parent sheet, run `slice_images.py`, and place only the resulting element files |++After image resources change, run `analyze_images.py` so+`analysis/image_analysis.csv` reflects the files that SVG authoring will use.+Operational manifests and provenance are resource truth, not a hidden design+strategy.++Every required resource must reach a usable terminal state before the+referencing page is authored. A required `Needs-Manual` resource blocks Quick+delivery even when an unverified candidate file exists. After a manual supply+or replacement, validate the file/provenance and reconcile the row to+`Generated`, `Sourced`, or `Rendered`; do not use file presence as a bypass or+silently replace it with unrelated material.----## 2. Minimal Authoring Contract+## 3. Direct SVG AuthoringAlways read[`shared-standards-core.md`](../../references/shared-standards-core.md). Do not-load `executor-base.md`: its planned-project prerequisites do not apply to this-profile. Besides the conditional canvas lookup below, load a core conditional-module only when the requested SVG needs that registered feature; otherwise-keep the SVG surface to solid paint, basic geometry, text, and semantic groups.--Before writing P01, resolve the slide roster, canvas, visual direction, palette,-and typography in the active context. Do not persist a plan, invoke Strategist,-or wait for confirmation. Preserve the supplied facts and requested wording.--Use a new project path, or first verify that its `svg_output/` is empty. Never-reuse a directory containing pages from another run: the exporter publishes-every discovered SVG. Use one zero-padded width sized for the resolved roster,-such as `01_cover.svg` through `12_end.svg` or `001_cover.svg` through-`120_end.svg`.--Create only:--```text-<project_path>/-├── svg_output/-│ └── <ordered-page>.svg-└── exports/- └── <project_name>_<timestamp>.pptx-```+load `executor-base.md`: its persisted-plan prerequisites do not apply to this+profile. Load the conditional image/web/canvas references only when the+resolved SVG needs them.-**Hard rule — no default-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.+Use one zero-padded filename width sized for the resolved roster, such as+`01_cover.svg` through `12_end.svg` or `001_cover.svg` through `120_end.svg`.+Never reuse pages from another run: the exporter publishes every SVG discovered+under `svg_output/`.**Canvas**: unless the user specifies another canvas, use `ppt169` with`viewBox="0 0 1280 720"`. For another requested registered format, load@@ -81,46 +109,50 @@ viewBox. The first SVG establishes the export canvas; every remaining page mustmatch 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.+page and all resource references 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 dependon a lock or generated font asset.-**Generation pacing**: the current main agent decides the page structure in the-active context, then hand-writes the SVG roster in order. Use P01 as the visual-anchor, continue directly through the remaining pages, and skip the default-first-page and final checker gates.+**Generation pacing**: the current main agent hand-writes the SVG roster in+order. Use P01 as the visual anchor, continue directly through the remaining+pages, and skip the default first-page and final checker gates. This profile+still obeys every loaded SVG/resource rule; skipping a report does not relax+the authoring contract.----## 3. Direct Export+## 4. Direct Export-Run one export command after every page in the resolved SVG roster exists:+Run one export command after every page exists and every required referenced+resource in the resolved roster has validated evidence and a usable status:```bashpython3 ${SKILL_DIR}/scripts/svg_to_pptx.py <project_path> --quick-generate```-`--quick-generate` 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.+`--quick-generate` reads `svg_output/` as the page source and resolves the+project-local assets referenced by those SVGs. It infers one consistent canvas,+uses a flat PowerPoint package with converter defaults, disables notes and+motion, skips lock/theme export sidecars, and writes no backup, conversion+trace, or validation report. Resource manifests remain in the project. An+explicit `-o <path>.pptx` may replace the default `exports/` destination.**Package sanity**: the standard non-quiet command succeeds only when`[QUICK-GENERATE] status=passed`, the discovered SVG count equals the publishedSlide count, and the PPTX passes in-memory ZIP integrity. This receipt does notclaim SVG-checker, visual-quality, factual-correctness, or default postflight-approval. On failure, repair the owning SVG and rerun this command; do not-create planning or validation-report artifacts.+approval. On failure, repair the owning SVG/resource and rerun this command; do+not create planning or validation-report artifacts.```markdown## ✅ Quick Generate Complete-- [x] Resolved SVG pages exist under `svg_output/`+- [x] All required source/resource preparation is complete+- [x] Resolved SVG pages and their project-local references exist- [x] One native PPTX exists under `exports/` or the explicit output path-- [x] No default-pipeline artifacts were created+- [x] No Strategist, confirmation, Design Spec, or lock artifact was created- [ ] **Next**: Report the PPTX path```diff --git a/skills/ppt-master/workflows/routing.md b/skills/ppt-master/workflows/routing.mdindex 2eb78a4a..1654cadd 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; explicit `quick-generate` supplies fact-sufficient self-contained 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-generate`: only `svg_output/` plus one PPTX |+| 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 research can gather them; explicit quick intent activates its profile | Author new SVG pages and export a new PPTX | Default: spec, lock, SVG, validation, and PPTX; Quick: optional source/resource artifacts, no spec/lock, SVG, and 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,9 +41,9 @@ route selection. After selection, the route authority owns execution.| Request condition | Generate-route behavior ||---|---|-| Explicit quick/fast generation or direct SVG-to-PPTX intent + fact-sufficient self-contained content | Activate [`quick-generate`](./profiles/quick-generate.md) inside Generate PPTX; decide the page structure in active context, skip Strategist and confirmation, author SVG pages, and run the direct exporter without entering default 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 |+| Explicit quick/fast, skip-strategy, or direct SVG-to-PPTX intent | Activate [`quick-generate`](./profiles/quick-generate.md): prepare sources/resources as needed, let the current agent decide without interaction, omit Strategist/confirmation, hand-author SVG, and export directly |+| Topic only, or supplied sources leave planning-critical factual gaps | Run [`topic-research`](./stages/topic-research.md) inside the selected Generate profile's source preparation: immediately for topic-only input, or after conversion and reading for source-backed input; research only the identified gaps |+| 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; continue the default pipeline unless explicit Quick Generate intent selected that profile || 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 || Explicit current brand/layout/deck workspace root | Enter [`generate-pptx`](./generate-pptx.md) Step 3 and conditionally load [`apply-template-workspace`](./stages/apply-template-workspace.md); consume the workspace root, never only its inner `templates/` directory || Split-mode project resumes in a fresh chat | Run [`resume-execute`](./stages/resume-execute.md) inside the active Generate route |@@ -51,7 +51,7 @@ route selection. After selection, the route authority owns execution.| User explicitly requests spec refinement | Run [`refine-spec`](./stages/refine-spec.md) after Design Spec Gate 1 and before lock Gate 2 || Data charts exist | Run [`verify-charts`](./stages/verify-charts.md) before export || User explicitly requests visual review | Run [`visual-review`](./stages/visual-review.md) before post-processing |-| User requests preview, selection, or annotation application | Run [`live-preview`](./stages/live-preview.md) at the stage defined there |+| User requests preview, selection, or annotation application | Use the default Generate pipeline and run [`live-preview`](./stages/live-preview.md) at the stage defined there; explicit Quick + preview intent falls back to default rather than dropping preview || User requests page transitions, auto-advance, or deck-wide animation settings without page-specific motion planning or an existing `animations.json` | Load [`animations`](../references/animations.md) and apply its export-level contract || `<project_path>/animations.json` already exists, the user explicitly requests per-slide/object-level animation control, or the effective Custom Animations outcome in `design_spec.md §I` is enabled | Run [`customize-animations`](./stages/customize-animations.md) after the final SVG quality gate and any enabled speaker-note pass, before Generate Step 7. A §IX `Motion suggestion` informs an active pass but never triggers it alone || Generate PPTX receives an explicit narration request or has effective Narration Audio enabled in `design_spec.md §I`; Enhance Native PPTX has a confirmed `audio.enabled: true` module | Run [`generate-audio`](./stages/generate-audio.md) after the owning route's notes/export readiness; Generate audio implies effective Speaker Notes enabled |@@ -60,9 +60,10 @@ route selection. After selection, the route authority owns execution.**Hard rule — direct-generation profile, not a fifth route**: `quick-generate`stays inside Generate PPTX but owns an explicit SVG → PPTX short circuit. Page-count alone never activates or blocks it. Requests that require conversion,-research, templates, asset acquisition, native data objects, or additional-package behavior stay on the default Generate pipeline.+count alone never activates or blocks it. Conversion, bounded research, and+project-local image/icon/formula preparation remain available. Structured+template reuse, native data objects, or additional package behavior require the+default Generate pipeline.---diff --git a/skills/ppt-master/workflows/stages/topic-research.md b/skills/ppt-master/workflows/stages/topic-research.mdindex ae3856db..5389f559 100644--- a/skills/ppt-master/workflows/stages/topic-research.md+++ b/skills/ppt-master/workflows/stages/topic-research.md@@ -1,12 +1,16 @@----description: Generate Step 1 intake stage that fills externally verifiable factual gaps before Strategist confirmation.+description: Generate source-intake stage that fills externally verifiable factual gaps before planning or direct SVG authoring.---# Topic Research Stage-> Strategist-owned factual preparation inside [`generate-pptx`](../generate-pptx.md) Step 1. Run immediately for topic-only input, or after supplied material is converted and read when it leaves planning-critical factual gaps. Output is a research supplement plus stable fact provenance for Step 2 import.+> Factual preparation inside [`generate-pptx`](../generate-pptx.md) source intake. Default Generate hands its output to Strategist; Quick Generate keeps it with the current agent. Run immediately for topic-only input, or after supplied material is converted and read when it leaves planning-critical factual gaps. Output is a research supplement plus stable fact provenance for project import.-This stage supplies facts needed to plan the requested deck. It does not select, download, or generate images; image selection belongs to the final Strategist plan, and AI / web / slice acquisition runs in Generate Step 5 after final confirmation.+This stage supplies facts needed to build the requested deck. It does not select,+download, or generate images. Default Generate resolves image selection in the+final Strategist plan and acquires AI / web / slice assets after confirmation;+Quick Generate resolves and acquires them later in its resource-preparation+phase without adding a confirmation gate.## When to Run@@ -17,15 +21,22 @@ This stage supplies facts needed to plan the requested deck. It does not select,| Supplied material already supports the requested outcome | Skip this stage and continue Generate Step 1 || User requires a closed corpus, source-only transformation, or no external enrichment | Skip this stage and keep planning within supplied material |-**Sufficiency test**: a gap exists when the Strategist would otherwise need to invent, omit, or leave unsupported an externally verifiable claim required by the user's requested outcome. File presence, source length, and a generic topic taxonomy do not decide sufficiency.+**Sufficiency test**: a gap exists when the active content owner would otherwise need to invent, omit, or leave unsupported an externally verifiable claim required by the user's requested outcome. File presence, source length, and a generic topic taxonomy do not decide sufficiency.-**Hard rule — preserve supplied facts**: supplement the user's material; never silently replace it. Record a material source conflict for Strategist review instead of choosing a different claim without disclosure. Do not research omissions outside the requested scope.+**Hard rule — preserve supplied facts**: supplement the user's material; never+silently replace it. Record a material source conflict in the research output+for the active content owner instead of choosing a different claim without+disclosure. Do not research omissions outside the requested scope.---## Step 1: Define the gap brief-⛔ **BLOCKING**: confirm only missing scope or research-boundary decisions as one bundled clarifier. Skip when the request and supplied material already make them clear.+**Clarification boundary**: Default Generate bundles only genuinely missing+scope or research-boundary decisions into one clarifier. Quick Generate applies+the defaults below and continues without interaction; stop only when a required+permission or safety boundary cannot be inferred responsibly. Skip clarification+when the request and supplied material are already clear.| Item | Default if unspecified ||---|---|@@ -35,10 +46,12 @@ This stage supplies facts needed to plan the requested deck. It does not select,| Research gaps | Only facts needed to support the requested outcome || External-source boundary | External factual enrichment allowed; supplied facts remain authoritative inputs || Output language | Match user input |-| Target audience / communication intent | Use what is already explicit; leave final confirmation to the main Strategist stage |+| Target audience / communication intent | Use what is explicit; Default leaves final confirmation to Strategist, while Quick resolves routine gaps in active context || Research stem (`<research_slug>`) | `<topic_slug>_research`; choose another unused snake_case stem rather than overwrite an existing file |-Do not repeat the full main-pipeline confirmation here. Generate Step 4 still confirms the complete communication contract and deck solution after the factual inputs are ready.+Do not repeat the full default-pipeline confirmation here. Default Generate+confirms the complete communication contract in Step 4; Quick Generate adds no+confirmation stage.---@@ -63,7 +76,10 @@ python3 ${SKILL_DIR}/scripts/source_to_md/web_to_md.py <URL>| 3 | Reputable reporting or analysis when primary evidence is unavailable || Avoid | Unsourced reposts, unverifiable summaries, and stock-aggregator pages |-**Stop condition**: stop when every declared gap has enough sourced evidence for the Strategist to decide whether and how to include it. Do not expand into unrelated overview / history / outlook sections merely to make the research look complete.+**Stop condition**: stop when every declared gap has enough sourced evidence for+the active content owner to decide whether and how to include it. Do not expand+into unrelated overview / history / outlook sections merely to make the+research look complete.---@@ -111,12 +127,17 @@ Import the research supplement and provenance alongside any user-supplied sourcepython3 ${SKILL_DIR}/scripts/project_manager.py import-sources projects/<project_name> [<source_paths...>] projects/<research_slug>.md projects/<research_slug>.facts.json```-The Research Brief remains evidence-facing context, not a locked presentation contract. Strategist reads all imported source material, then confirms the complete contract and decides the content, page roster, and image resource plan. Generate Step 5 acquires only the selected image rows after that confirmation.+The Research Brief remains evidence-facing context, not a locked presentation+contract. Default Generate has Strategist read the imported material, confirm+the complete contract, and select the content, page roster, and image resource+plan before Step 5 acquisition. Quick Generate has the current agent read the+same facts, decide those routine details in active context, and continue to its+resource-preparation phase.```markdown## ✅ Topic Research Complete- [x] Research supplement: `projects/<research_slug>.md` (N declared gaps covered)- [x] Fact provenance: `projects/<research_slug>.facts.json` (N external facts)-- [x] No images acquired before Strategist confirmation+- [x] No images acquired inside this factual-research stage- [ ] **Next**: return to [`generate-pptx`](../generate-pptx.md) Step 1, then import all source artifacts in Step 2```