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(video): require synchronized Quick video delivery
hugohe35af7345aa4fe
diff --git a/skills/ppt-master/references/executor-notes.md b/skills/ppt-master/references/executor-notes.mdindex baf525fa..a524be7e 100644--- a/skills/ppt-master/references/executor-notes.md+++ b/skills/ppt-master/references/executor-notes.md@@ -15,11 +15,12 @@ create `notes/total.md`.Write the complete deck to `notes/total.md` in one batch for coherent transitions. Use `# <number>_<page_title>` per page and `---` between pages; only the heading is stripped before TTS.-**Frozen final-script branch**: when `notes/total.md` already exists because the-user supplied an explicit final/literal script, do not rewrite it. Retain every-spoken word and segment boundary; this pass validates script-to-page consistency-only. A `# Slide <number>` heading is valid before SVG filenames exist and is-resolved by Generate Step 7.1 after the roster is authored.+**Pre-SVG narration branch**: when `notes/total.md` already exists because the+user supplied a final/literal script or Quick is directly delivering narrated+video, validate it instead of regenerating it. Retain every word and segment of+a final/literal script. Agent-authored Quick narration may be repaired only for+final-SVG inconsistency and before audio generation. A `# Slide <number>`+heading remains valid until Generate Step 7.1 resolves the authored roster.**Pure spoken narration**: `notes_to_audio.py` reads the body verbatim. Write prose only; never add Markdown list/bullet markup, stage markers, key-point labels, duration lines, or other metadata.@@ -31,12 +32,12 @@ resolved by Generate Step 7.1 after the roster is authored.Before drafting, internally inventory the visible title/subtitle and every information-bearing direct-root `<g id>`; structured placeholder content still counts. Coverage requires its unique claim, evidence, example, relationship, qualifier, or implication—not merely its label—to enter the narration.-For the frozen final-script branch, apply the same inventory in reverse: every-independent visible claim or relationship must already be supported by the-corresponding exact script segment. Repair the visual page or return to planning-when it is not; never add spoken text merely to make coverage pass. Every spoken-idea that requires orientation must likewise have a visible state or an explicit-speech-only role in the active plan.+For a pre-SVG narration branch, apply the same inventory in reverse: every+independent visible claim or relationship must be supported by its script+segment. Repair the visual page or return to planning for final/literal input;+for agent-authored Quick narration, repair the narration before audio without+inventing unsupported claims. Every spoken idea that requires orientation must+likewise have a visible state or an explicit speech-only role in the active plan.- Text blocks, comparisons, and processes retain every independent fact or relationship; combine related short groups causally or comparatively.- Charts, tables, and KPIs state the takeaway, decisive values or trend, comparison basis, implication, and material uncertainty—not every axis, row, or cell.diff --git a/skills/ppt-master/references/video-design.md b/skills/ppt-master/references/video-design.mdindex d476ed46..bec5c7fa 100644--- a/skills/ppt-master/references/video-design.md+++ b/skills/ppt-master/references/video-design.md@@ -5,8 +5,10 @@ self-running, or video delivery.**Trigger**: load this reference when the effective delivery purpose is video,recorded narration, or unattended playback. Also load its script rules for an-explicit final/literal narration input. Speaker notes, animation, audio, or MP4-export requested for an otherwise ordinary deck do not activate it alone.+explicit final/literal narration input. Speaker notes, animation, or audio+requested for an otherwise ordinary deck do not activate it alone. Explicit+video/MP4 delivery does; Quick additionally activates §3's direct-delivery+contract.**Ownership**: this is a conditional Generate reference, not a profile or a newartifact route. Default keeps its Strategist and confirmation flow; Quick keeps@@ -109,6 +111,14 @@ A pre-SVG `notes/total.md` is an enabled production artifact, not a forbiddenplanning checkpoint; Quick still creates no root Design Spec, lock,confirmation payload, or storyboard.+**Hard rule — Quick direct video input**: when Quick must deliver a narrated+video or MP4 rather than only a deck for later recording, enable Speaker Notes,+Custom Animations, Narration Audio, and video export. Before P01, write the+complete per-scene narration to `notes/total.md` even when the agent authored+it. Treat it as page-design input; validate/finalize agent-authored wording after+the SVG roster and before audio. A supplied final/literal script remains+verbatim and requires visual repair instead.+**Production outcomes**:| Need | Decision |@@ -116,20 +126,23 @@ confirmation payload, or storyboard.| Spoken delivery or a supplied final script | Enable Speaker Notes || User asks the workflow to synthesize narration | Enable Narration Audio; Speaker Notes is its dependency || Progressive reveal, continuing geometry, or timed emphasis materially aids explanation | Enable/load the appropriate animation capability |+| Quick directly delivers a narrated video or MP4 | Enable Speaker Notes, Custom Animations, Narration Audio, and video export; require timestamped page-local SRT || Video is manually narrated or static playback is sufficient | Keep Narration Audio and/or object animation off as applicable |-**Capability boundary**: video purpose does not force object animation or-generated audio. Explicit user instructions and the selected runtime's ordinary-production-decision precedence remain authoritative.+**Capability boundary**: a deck intended for later video use does not force+object animation or generated audio. Direct Quick narrated-video delivery uses+the mandatory row above. Explicit user instructions remain authoritative.---## 4. SVG, Notes, and Motion Realization-When `notes/total.md` contains a frozen final script, read it once before the-first SVG and design each page around its corresponding spoken segment. Give-every independently narrated or timed semantic unit a descriptive direct-root-`<g id>`; keep inseparable units grouped.+When §3 created `notes/total.md` before SVG, read it once before the first SVG+and design each page around its corresponding spoken segment. Give every+independently narrated or timed semantic unit a descriptive direct-root `<g+id>`; keep inseparable units grouped. Preserve a final/literal script exactly;+agent-authored direct-video narration may change only during its final-SVG+validation before audio.**Hard rule — script/design consistency**: a final script is literal content.If the finished visual page introduces an independent claim or relationship the@@ -148,15 +161,24 @@ named communication job. There is no motion-coverage quota, and `effect: none`remains valid. Auto-running narration uses `after-previous` / `with-previous`,never `on-click`.+**Hard rule — Quick direct video synchronization**: load `animations.md` before+SVG authoring and create/validate canonical `animations.json` from real semantic+groups. After notes validation, export the base PPTX/report, use a+timestamp-capable provider to generate page audio/SRT, map each timed group in+`narration_timing.json`, derive `narration_animations.json`, re-export the+narrated PPTX, then export MP4. Author object identity, effect, and order before+audio; only narration-derived triggers/delays wait for SRT timing. An audio-only+provider cannot satisfy this branch.+**Sound effects**: add them only on explicit request and only from prepared,project-local assets. Do not introduce sound search, trimming, or normalizationas an implicit video step.-**Production sequence**: after the final SVG check, the notes branch validates a frozen final script-against the visible pages without rewriting it. Draft-source runs instead use-the ordinary final-SVG-grounded notes generation. Both paths then split notes,-run any triggered custom-animation stage, export the canonical editable PPTX,-and invoke `generate-audio` only when narration synthesis is enabled.+**Production sequence**: after the final SVG check, validate any pre-SVG+narration against the visible pages; ordinary draft-source runs instead use the+final-SVG-grounded notes generation. Split notes, run triggered custom animation,+and export the canonical editable PPTX. Direct Quick video continues through+timestamped audio/SRT, narration synchronization, narrated PPTX, and MP4.---diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex 97945a74..f0825bd5 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -804,7 +804,7 @@"files": ["skills/ppt-master/references/video-design.md"],- "max_tokens": 2250+ "max_tokens": 2500},"stage.generate.refine-spec": {"description": "Explicit post-confirmation spec refinement runbook.",