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
refactor(prompts): drop restored items that conflict with current rulings
hugohe3f3f69d759e5e
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex cf0afa7a..cd9f4b4e 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -60,10 +60,11 @@ Read this before §1: the expression vocabulary every page draws from. The contr**Reference — everyday effects and aesthetic defaults (self-contained; the full contract and rarer techniques are [`svg-effects.md`](./svg-effects.md))**:-- **Color**: 60-30-10 as the starting proportion (dominant field ≈ 60%, support ≈ 30%, accent ≈ 10%), at most four hues per page, body text contrast ≥ 4.5:1; cover and chapter pages may use the theme color as a large field; same-hue gradients add depth; the accent color goes on the key number or word to create focus, not everywhere; cool tones read technical, warm tones energetic, dark fields grave; trends use green up / red down / gray flat with the deck's polarity roles.-- **Rhythm and weight**: follow a data-heavy page with a breathing page; balance visual weight — dark or large elements are heavy, light or small ones light — across left/right and top/bottom; keep layout consistent within a chapter and vary between chapters. A consulting-style content page may add an assertion headline, a one-sentence takeaway band under the title, and a muted source note at the page bottom.+- **Color**: 60-30-10 as the starting proportion (dominant field ≈ 60%, support ≈ 30%, accent ≈ 10%), body text contrast ≥ 4.5:1, hue count following encoding and natural assets; cover and chapter pages may use the theme color as a large field; same-hue gradients add depth; the accent color goes on the key number or word to create focus, not everywhere; cool tones read technical, warm tones energetic, dark fields grave; trends use green up / red down / gray flat with the deck's polarity roles.+- **Rhythm and weight**: follow a data-heavy page with a breathing page; balance visual weight — dark or large elements are heavy, light or small ones light — across left/right and top/bottom; a chapter may share one carrier system while chapters vary, provided each repetition has a page job. A content page may add a one-sentence takeaway band under the title and a muted source note at the page bottom (title voice belongs to the locked mode).- **Depth through restraint**: depth comes from rhythm (flat vs lifted, dense vs spacious), not shadows everywhere — shadow 2–3 genuinely floating objects per page at most (card over a photo or colored panel, the primary CTA, an overlay) and keep peer-grid cards, dividers, and body containers flat; reach for weight, spacing, accent bars, and tints before shadow; pick one weight tool per container (shadow, border, gradient fill, or strong tint — never stacked); one light source per page (`dx="0"`, `dy="4"`–`"8"`); the shadow is felt, not seen — resting `flood-opacity` 0.06–0.10, raised at most 0.20 (above that is the Office 2007 look); on dark fields use a light hairline or a restrained glow instead of black shadow.- **Image overlays**: a directional scrim darkest beside the text (`0.88 → 0.30 → 0`), a bottom fade under a lower title (`0 → 0.72`), a radial vignette for atmosphere (`0 → 0.58`), or a brand wash (`0.80 → 0.10`); never a uniform flat opacity over the whole image or a solid black plate.+- **16:9 reference geometry (1280×720; starting values, proportion follows information weight)**: safe area 1200×640 with 40 px margins; title band ≈ 100 px, content field ≈ 500 px, footer ≈ 40 px; centered single column 800–1000 px wide; symmetric split 1:1 with a 40–60 px gap; asymmetric 3:7 / 2:8 with the heavy side 840–1024 px; three columns with 30–40 px gaps; quadrants ≈ 560×250 with 20–30 px gaps; a radiating hub 200–300 px with 4–6 satellites; a negative-space page leaves 40–60% empty.- **Lines**: `stroke-dasharray` `4,4` separator, `2,2` placeholder outline, `8,4` timeline or flow connector, `8,4,2,4` dimension line; `marker-end` for connector arrowheads; divider hairlines at 0.2–0.3 alpha.- **Inline emphasis**: lift numerical results, before/after contrasts, and one or two load-bearing nouns per sentence as bold runs in the primary color; never connectives, common verbs, every noun, decorative adjectives, or structural text (footer, axis, legend, page number); reserve green/red for real polarity.diff --git a/skills/ppt-master/references/executor-chart.md b/skills/ppt-master/references/executor-chart.mdindex e39916ef..49faf2d1 100644--- a/skills/ppt-master/references/executor-chart.md+++ b/skills/ppt-master/references/executor-chart.md@@ -22,7 +22,7 @@ Construct in this order: (1) resolve data domain, categories, units, baseline, s**Perceptual reading**: choose the least ambiguous presentation of the same data. Preserve source or semantic order when it carries meaning; otherwise sort for the page's comparison task. Prefer direct series labels when legible; keep legends, grid lines, and ticks only when they materially reduce lookup effort. Comparable panels share domain, scale, and category order unless a disclosed difference is the message. Magnitude bars and columns start from zero; interval marks keep their authoritative domain; any non-zero baseline or axis break is explicit and never exaggerates. A dual-axis chart is valid only when both series share the exact time/category domain and units and identities stay unambiguous.-**Reference — chart color and annotation conventions**: a monochromatic depth scheme reads cleaner than rainbow — the primary series in the full theme color, a comparison series in the same hue at about 60% alpha, baselines as a gray dashed line, the accent color only on the key data points; positive / warning / negative trends use the deck's green / yellow / red polarity roles. Place direct data labels at bar ends or beside points instead of a legend where they stay legible; annotate genuine inflection points in words ("policy change", "product launch"); mark an industry average or target as a gray dashed comparison baseline; keep units and precision consistent within one chart; give every data page a muted source note.+**Reference — chart color and annotation conventions**: a monochromatic depth scheme reads cleaner than rainbow — the primary series in the full theme color, a comparison series in the same hue at about 60% alpha, baselines as a gray dashed line, the accent color only on the key data points; positive / warning / negative trends use the deck's green / yellow / red polarity roles. Place direct data labels at bar ends or beside points instead of a legend where they stay legible; annotate genuine inflection points in words ("policy change", "product launch"); mark an industry average or target as a gray dashed comparison baseline; keep units and precision consistent within one chart; add a muted source note where attribution or provenance matters.**Per-object completeness**: preserve every authoritative series, category, point, label, unit, qualifier, source, and scale cue. For a `<object-key>=yes` chart, the JSON mirrors the drawn fallback item by item in the same edit — legend labels verbatim, point-level exception colors as `point_colors`, the axis scale, `plot_area` from the plot-area marker, visible data labels or summary figures as `data_labels` or companion text, actual label/axis/grid colors (omit `text_color` and siblings rather than guess). When the source cannot determine a required scale or derived value, return the ambiguity upstream in Default or resolve it from explicit source facts in Quick; never fabricate at draw time.diff --git a/skills/ppt-master/references/executor-table.md b/skills/ppt-master/references/executor-table.mdindex d5aa4cca..716e8f57 100644--- a/skills/ppt-master/references/executor-table.md+++ b/skills/ppt-master/references/executor-table.md@@ -28,7 +28,7 @@ With a `table/<key>` primary reference, [`executor-visualization.md`](./executor**Per-cell completeness**: never drop a row, column, summary, footnote, unit, or qualifier to imitate a lighter catalog preview; reflow text, widen the column, rebalance neighbors, or increase row height within the page's information contract and [`executor-base.md`](./executor-base.md) typography bounds.-**Spans and chrome**: merge only rectangular regions whose repeated boundaries would obscure an intended shared heading or group, with no competing visible content in covered areas; native merge fields belong exclusively to [`native-data-interface.md`](./native-data-interface.md). Distinguish header/body/summary with the lightest sufficient weight, fill, rule, and whitespace; decorative card treatment must not break row or column continuity. **Reference — table defaults**: a dark header fill with white bold text (or a bold rule under a plain header), zebra rows at `fill-opacity` 0.05, numbers right-aligned and text left-aligned with consistent units and precision, one highlighted row in the accent at `fill-opacity` 0.1, and horizontal rules only — avoid a full grid of lines.+**Spans and chrome**: merge only rectangular regions whose repeated boundaries would obscure an intended shared heading or group, with no competing visible content in covered areas; native merge fields belong exclusively to [`native-data-interface.md`](./native-data-interface.md). Distinguish header/body/summary with the lightest sufficient weight, fill, rule, and whitespace; decorative card treatment must not break row or column continuity. **Reference — table defaults (treatment follows the locked style)**: a header set apart by weight and a rule, or by a fill with reversed text where the style carries fills; zebra rows at `fill-opacity` 0.05, numbers right-aligned and text left-aligned with consistent units and precision, one highlighted row in the accent at `fill-opacity` 0.1, and horizontal rules only — avoid a full grid of lines.---diff --git a/skills/ppt-master/references/image-layout-spec.md b/skills/ppt-master/references/image-layout-spec.mdindex 9f2e8544..fa5469a1 100644--- a/skills/ppt-master/references/image-layout-spec.md+++ b/skills/ppt-master/references/image-layout-spec.md@@ -39,7 +39,7 @@ x = x0 - ax × overflow_x; y = y0 - ay × overflow_y### 2.3 Mode selection-**Reference — narrative intent before geometry**: decide whether the image is the page (hero / full-bleed: image fills the canvas or dominant zone, title floats over a gradient or scrim — covers, dividers, breathing pages), a backdrop (atmosphere: low-contrast image behind text), a coequal block (side-by-side: image and text read together — most content pages), or an accent (small image beside related text, no ratio matching); do not default every image page to side-by-side. For side-by-side, start from the source ratio: > 2.0 ultra-wide → top-bottom with the image full width; 1.5–2.0 → top-bottom; 0.8–1.5 → left-right; < 0.8 portrait → left-right with the image on the left; on portrait canvases (Xiaohongshu, Story) prefer top-bottom for most ratios because side columns become too narrow.+**Reference — narrative intent before geometry**: decide whether the image is the page (hero / full-bleed: image fills the canvas or dominant zone, title floats over a gradient or scrim — covers, dividers, breathing pages), a backdrop (atmosphere: low-contrast image behind text), a coequal block (side-by-side: image and text read together — most content pages), or an accent (small image beside related text, no ratio matching); do not default every image page to side-by-side. For side-by-side, the source ratio shapes the item inside its region (§2–§3), not the page split; on portrait canvases (Xiaohongshu, Story) side columns become narrow, so stacked regions usually serve better.Complete source, evidence, or edge content → contain; region coverage with a focal-safe crop → fill; complete source plus a detail view → one contain placement plus a separately justified crop; irregular or repeated source windows → the selected region math first, then the owning crop/shape reference.diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex 66fb210c..db37a030 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -135,7 +135,7 @@ Record the style and rationale in `design_spec.md`, then project `- visual_style**Hard rule**: user-specified colors are truth — lock supplied HEX, brand colors, or natural-language directives (templates follow inherited-design precedence). Every direction fills all six roles (`background`, `secondary_bg`, `primary`, `accent`, `secondary_accent`, `body_text`), repeating fixed roles and varying only open ones; never an empty palette. In §III derive the standard `secondary_text` and `divider` neutrals and project them to `spec_lock.md colors`; §V fixes the five deck-wide spacing anchors.-**Reference — not a constraint**: starting proportions follow the 60-30-10 rule (dominant ≈ 60%, support ≈ 30%, accent ≈ 10%), body contrast is at least 4.5:1 (WCAG AA), and a page carries at most four hues; color carries mood — cool tones read technical and calm, warm tones energetic and approachable, dark fields grave and premium. Without user/template colors, propose project-specific directions from content and style; `scripts/config.py` industry anchors (finance/business navy `#003366`, technology bright blue `#1565C0`, healthcare teal `#00796B`, government red `#C41E3A`) and the dominant/support/accent hierarchy are recall aids, never default locks or quotas.+**Reference — not a constraint**: starting proportions follow the 60-30-10 rule (dominant ≈ 60%, support ≈ 30%, accent ≈ 10%), body contrast is at least 4.5:1 (WCAG AA), and hue count follows encoding, style, and natural assets rather than a fixed cap; color carries mood — cool tones read technical and calm, warm tones energetic and approachable, dark fields grave and premium. Without user/template colors, propose project-specific directions from content and style; `scripts/config.py` industry anchors (finance/business navy `#003366`, technology bright blue `#1565C0`, healthcare teal `#00796B`, government red `#C41E3A`) and the dominant/support/accent hierarchy are recall aids, never default locks or quotas.**Lock recurring semantic anchors, not every paint**: add neutral roles the style and page plan give a stable meaning — `surface`, `grid`, `scrim`, `overlay`, `block-shade` — and leave page-local tints, gradient stops, shadow/glow colors, and one-off tones to execution, promoting one only when it becomes a reusable named role.@@ -170,9 +170,9 @@ AI illustrated icons are not a base option, add-on, field, or key — like decor🚧 **GATE**: apply the chosen custom behavior and only the already-loaded `visual_style_references` files. The title carries the character; the body may stay neutral.-**Family selection**: user/template typography is authoritative — repeat fixed stacks with `typography.fixed: true` in every direction (reasonable repetition is non-blocking; no extra font round). Each direction carries `heading` / `body` `primary`, `css`, and a positive `body_size`, plus `english` only for a non-English deck. Resolve the delivery target under [`shared-standards-core.md`](./shared-standards-core.md) §4.1 and name concrete target-installed/approved PowerPoint faces (the Confirm UI catalog is manual choice, not a whitelist); at most four families; a brand/web face leads only after user-confirmed installation, otherwise export a safe face and keep it as a Design Spec reference (fonts are not embedded; CSS tails are preview aids, not PowerPoint fallbacks). Avoid near-equivalent splits (YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, Times↔Times New Roman). Fonts in one deck form contrast (different family, weight, or proportion) or concord (one family throughout); propose one of each unless the user or template fixes the stack, and never default to title = body without a reason.+**Family selection**: user/template typography is authoritative — repeat fixed stacks with `typography.fixed: true` in every direction (reasonable repetition is non-blocking; no extra font round). Each direction carries `heading` / `body` `primary`, `css`, and a positive `body_size`, plus `english` only for a non-English deck. Resolve the delivery target under [`shared-standards-core.md`](./shared-standards-core.md) §4.1 and name concrete target-installed/approved PowerPoint faces (the Confirm UI catalog is manual choice, not a whitelist); at most four families; a brand/web face leads only after user-confirmed installation, otherwise export a safe face and keep it as a Design Spec reference (fonts are not embedded; CSS tails are preview aids, not PowerPoint fallbacks). Avoid near-equivalent splits (YaHei↔PingFang, SimSun↔Songti, Arial↔Helvetica↔Segoe UI, Times↔Times New Roman). Fonts in one deck form contrast (different family, weight, or proportion) or concord (one family throughout); across the direction set include both a concord and a contrast pairing unless the user or template fixes the stack, and never default to title = body without a reason.-**Reference — PPT-safe faces and pairings (recall seeds, not presets)**: pre-installed leads — CJK sans `Microsoft YaHei` / `SimHei` (macOS `PingFang SC` / `Heiti SC`), CJK serif `SimSun` / `FangSong` / `KaiTi` (`Songti SC`), Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`, Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Palatino` / `Garamond`, mono `Consolas` / `Courier New`, display `Impact` / `Arial Black`; keep at most one macOS-only family per stack. The title carries the style's character — `ink-wash` → `KaiTi` / `FangSong`; `brutalist` / `memphis` / `vintage-poster` / `zine` → `SimHei` / `Impact`; `editorial` / `data-journalism` / `photo-editorial` → `Georgia` / `Cambria` / `SimSun`; `dark-tech` / `blueprint` → clean sans + `Consolas`; `swiss-minimal` / `soft-rounded` → grotesque or friendly sans; a neutral sans title where the style asks for character is the failure to avoid, and `Microsoft YaHei` / `Arial` are neutral tails, not the automatic lead. Axes: serif × sans (`Georgia, KaiTi` × `Microsoft YaHei`), Kai × hei, FangSong × hei (`FangSong` × `SimHei`), double serif (`Palatino, FangSong` × `Cambria, SimSun`), same family with 900 / 300 weight, display × neutral (`Impact, SimHei` × `Arial, Microsoft YaHei`), cool academic serif (`Cambria, SimSun` × `Times New Roman, SimSun`), hei × song for 政务, sans body + `Consolas` code. Non-pre-installed directions — retro/pixel Press Start 2P / VT323, rounded Nunito / Quicksand / OPPO Sans (safe substitute `Trebuchet MS` / `Verdana`), modern web Inter / HarmonyOS Sans / Source Han, calligraphic 隶书 / 华文行楷 / 华文新魏 (safe substitute `KaiTi` / `FangSong`, titles only), brand faces — need target installation or stay Design Spec references.+**Reference — PPT-safe faces (recall, not a whitelist; name one concrete face per script, never a comma stack)**: CJK sans `Microsoft YaHei` / `SimHei` (macOS `PingFang SC` / `Heiti SC`), CJK serif `SimSun` / `FangSong` / `KaiTi` (`Songti SC`), Latin sans `Arial` / `Calibri` / `Segoe UI` / `Verdana` / `Trebuchet MS`, Latin serif `Times New Roman` / `Georgia` / `Cambria` / `Palatino` / `Garamond`, mono `Consolas` / `Courier New`, display `Impact` / `Arial Black`. Let the locked style's character pick the axis and lead the title — `Microsoft YaHei` / `Arial` are the neutral members, never the automatic lead; a neutral sans title where the style asks for character is the failure to avoid. Non-pre-installed directions — retro/pixel Press Start 2P / VT323, rounded Nunito / Quicksand / OPPO Sans (safe substitute `Trebuchet MS` / `Verdana`), modern web Inter / HarmonyOS Sans / Source Han, calligraphic 隶书 / 华文行楷 / 华文新魏 (safe substitute `KaiTi` / `FangSong`, titles only), brand faces — need target installation or stay Design Spec references.**Role extension after confirmation**: while authoring §IX and §IV, add a lowercase snake_case role with an exact stack only for a recurring role that materially needs a different family (`annotation`, `footer`, `footnote`, `data`, `emphasis`, `quote`, `code`), coherent with the confirmed heading/body system and locked style; one-off garnish stays omitted, confirmation is not reopened, and one compact `Role rationale` line in §IV names any added role.@@ -268,7 +268,7 @@ Mode: [`modes/_index.md`](./modes/_index.md) → `pyramid` / `narrative` / `instNo universal palette: user / brand → active template → project-specific proposal, with `scripts/config.py` industry anchors as optional recall. Count and distribution follow encoding, style, and natural assets, with 60-30-10 as the starting proportion.-**Reference — color knowledge base (recall aids, never defaults)**: consulting brands — Deloitte `#0076A8`, McKinsey `#005587`, BCG `#003F6C`, PwC `#D04A02`, EY `#FFE600`; versatile anchors — tech blue `#2196F3`, vibrant orange `#FF9800`, growth green `#4CAF50`, professional purple `#9C27B0`, alert red `#F44336`; data-visualization polarity ramps — positive green `#2E7D32 → #4CAF50 → #81C784`, warning yellow `#F57C00 → #FFA726 → #FFD54F`, negative red `#C62828 → #EF5350 → #E57373`. Lock the stable role set the deck needs, including recurring neutrals (`surface`, `grid`, `scrim`, `overlay`, `block-shade`), as identity anchors rather than an exhaustive paint list; Executor derives tints, shades, alpha, gradients, and effects and adds sparse page-local accents that never form a competing palette, while Strategist owns reusable positive / warning / negative roles.+**Reference — polarity ramps (recall aids, never defaults)**: positive green `#2E7D32 → #4CAF50 → #81C784`, warning yellow `#F57C00 → #FFA726 → #FFD54F`, negative red `#C62828 → #EF5350 → #E57373`; brand identities come from a Brand/Deck workspace, never a memorized list. Lock the stable role set the deck needs, including recurring neutrals (`surface`, `grid`, `scrim`, `overlay`, `block-shade`), as identity anchors rather than an exhaustive paint list; Executor derives tints, shades, alpha, gradients, and effects and adds sparse page-local accents that never form a competing palette, while Strategist owns reusable positive / warning / negative roles.---@@ -276,16 +276,16 @@ No universal palette: user / brand → active template → project-specific prop**Reference — not a constraint**: macro vocabulary only; proportion follows information weight, and Executor may adopt, adapt, or decline after reading the page. Repeating symmetric card grids without a page job is a failure mode.-| Content relationship | Useful starting structure | PPT 16:9 reference dimensions |-|---|---|---|-| One focal claim | centered single column, negative space (one element in 40–60% whitespace), or full-bleed + floating text | content width 800–1000 px centered; full-bleed image 1280×720 with an opacity overlay under the text |-| Equal comparison | symmetric split (5:5) or a true matrix / four quadrants | column ratio 1:1 with a 40–60 px gap; quadrant about 560×250 px with 20–30 px gaps |-| Dominant evidence + takeaway | asymmetric split (3:7 / 2:8) with one dominant field | heavier side 840–1024 px, lighter side 256–440 px |-| Parallel sequence | three-column, process line, Z-pattern / waterfall | 1:1:1 columns with 30–40 px gaps; 3–5 alternating blocks guiding the eye in a Z |-| Core + surrounding forces | center-radiating or hub-spoke | center element 200–300 px with 4–6 satellite nodes |-| Wide visual + explanation | top-bottom split, or figure-text overlap for a hero moment | image full width, text area ≥ 150 px high; overlap places the headline against the image edge, not beside it |--PPT 16:9 (1280×720) key dimensions: safe area 1200×640 (40 px margins); title area 1200×100; content area 1200×500; footer area 1200×40. Reference values only — proportion follows information weight.+| Content relationship | Useful starting structure |+|---|---|+| One focal claim | centered single column, negative space (one element carried by generous whitespace), or full-bleed + floating text |+| Equal comparison | symmetric split or a true matrix / four quadrants |+| Dominant evidence + takeaway | asymmetric split with one dominant field |+| Parallel sequence | three-column, process line, or Z-pattern / waterfall |+| Core + surrounding forces | center-radiating or hub-spoke |+| Wide visual + explanation | top-bottom split, or figure-text overlap for a hero moment |++Executor owns the geometry (its reference dimensions live in [`executor-base.md`](./executor-base.md)); never write element-level sizes or coordinates into §IX.Once the roster and planned resources are known, recommend a cross-page motif or element family when it can carry identity or meaning — title/corner ornaments, a directional contour, an opening, a line lattice, an oversized numeral — recording its continuity job and reuse mode in §III `Theme` and mentioning it only in the §IX `Layout` blocks that benefit; Executor owns its geometry and may decline it; no motif field, lock row, or quota.diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.jsonindex a57e1139..4ec813e4 100644--- a/skills/ppt-master/scripts/prompt_audit_manifest.json+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json@@ -18,7 +18,7 @@"file_budgets": {"AGENTS.md": 3250,"skills/ppt-master/SKILL.md": 1750,- "skills/ppt-master/references/executor-base.md": 9000,+ "skills/ppt-master/references/executor-base.md": 9250,"skills/ppt-master/references/executor-structured.md": 5500,"skills/ppt-master/references/executor-chart.md": 1750,"skills/ppt-master/references/executor-visualization.md": 1000,