Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

feat(prompts,validator): lock prohibitions are the user's; preset absence answered per job; content-fidelity clarifications; image upscale warning at 2x

hugohe3d8954f9af60b
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.md
index 2030ec0f..66129777 100644
--- a/skills/ppt-master/references/executor-base.md
+++ b/skills/ppt-master/references/executor-base.md
@@ -145,7 +145,7 @@ Executor receives the plan and builds on it: Default reads the retained `design_
**Reference — planning sketches are adjusted freely**: §V/§IX `Layout`, cover/closing composition, capability recommendations, §III motif direction, Chart/Table `family/key` references, §VIII image-layout patterns, and Motion suggestions are starting sketches: adjust or replace each for the page's purpose, with no upstream repair or stated reason; they carry no binding semantics (what must hold is in the binding fields above), and a `(binding)` field is followed literally. Executor owns final carrier choice, page-scale composition, information-preserving visualization, geometry, spacing, coordinates, native construction, and effects.
-**Hard rule — content vs expression**: §IX owns each page's semantic content — complete preferred wording and block texture at `complete` depth, a short block list at `brief` — and its wording is not verbatim unless marked literal. Executor may paraphrase, condense repetition, regroup or reorder within the page, and switch among prose, bullets, keywords, labels, or visual annotation when fit or readability benefits, provided the result stays information-equivalent: the `Core message`, `Audience move`, and every claim, fact, value, proper name, qualifier, relationship, evidence, and literal requirement survive. Never add a claim, move content across pages, or drop information to fit a layout; return an unfit or underspecified block for Design Spec repair. Use named lock roles literally where they apply, apply an optional `Template Application`, and choose page-local values from the Design Spec, style, content, and composition rather than forcing every object into a lock row. Read sources only to resolve listed `Fact IDs` or verify required claims, quotes, names, or data; never to add content.
+**Hard rule — content vs expression**: §IX owns each page's semantic content — complete preferred wording and block texture at `complete` depth, a short block list at `brief` — and its wording is not verbatim unless marked literal. Executor may paraphrase, condense repetition, regroup or reorder within the page, and switch among prose, bullets, keywords, labels, or visual annotation when fit or readability benefits, provided the result stays information-equivalent: the `Core message`, `Audience move`, and every claim, fact, value, proper name, qualifier, relationship, evidence, and literal requirement survive. Never add a claim, move content across pages, or drop information to fit a layout; quotation marks and first person only for wording the source itself gives as a quote — reported speech stays reported; return an unfit or underspecified block for Design Spec repair. Use named lock roles literally where they apply, apply an optional `Template Application`, and choose page-local values from the Design Spec, style, content, and composition rather than forcing every object into a lock row. Read sources only to resolve listed `Fact IDs` or verify required claims, quotes, names, or data; never to add content.
**Per-page communication trace**: read `communication.objective`, `communication.core_message`, and the page's §IX `Core message` + `Audience move` before composing. The page must advance the objective and make that move; a page that cannot state its move is an outline defect — surface `warning: P<NN> has no communication move` rather than decorating around it, and never invent a purpose at execution time. Structural pages advance the contract by establishing relevance, tension, or the decision frame, or by completing the final commitment.
@@ -193,13 +193,13 @@ Mechanical repetition comes from reusing one carrier and topology without a page
- **Ordinary carriers stay ordinary**: cards, icon-and-label rows, color swatches, soft shadows, and gradient fields are everyday carriers — use them whenever content groups, compares, enumerates, or names a color, material, or sample, with one shared treatment for peers; reach for a device by page job and let the locked style set its treatment. When the subject is a color or material, draw it: a swatch is content, its value comes from the source, and it needs no lock row.
- **Reference — semantic geometry over preset stacks**: for ascending, converging, breaking-through, or stacking relationships, compose faithful primitives and exact presets as one geometry system; a Boolean only when the contour must merge, open, or fragment; one page-specific path only when neither works.
- **Inherited containers**: keep meaningful template frames and restyle radius, fill, stroke, and depth from the Design Spec and lock; Chart/Table reference adaptation belongs to [`executor-visualization.md`](./executor-visualization.md), and preview effects never override project styling.
-- **Fact provenance**: resolve each §IX `Fact ID` from `sources/*.facts.json` and keep the value unchanged; render a compact source footnote (name + short URL/domain) when space permits and state attribution naturally in enabled notes. For `Data class: scenario`, place a visible localized `Scenario data` / `情景数据` label beside the KPI/chart and say in notes that it is illustrative. Never attach a fact ID to scenario data or let an unlabeled invented KPI look factual.
+- **Fact provenance**: resolve each §IX `Fact ID` from `sources/*.facts.json` and keep the value unchanged; render a compact source footnote (name + short URL/domain) when space permits and state attribution naturally in enabled notes. For `Data class: scenario`, place a visible localized `Scenario data` / `情景数据` label beside the KPI/chart and say in notes that it is illustrative. Never attach a fact ID to scenario data or let an unlabeled invented KPI look factual. An organizing framework, grouping, or label the source does not state is the deck's reading — say so on the page (e.g. `整理` / `our reading`) or in enabled notes, never presented as the source's structure.
**Technical contract (the exporter's needs; the complete SVG boundary is [`shared-standards-core.md`](./shared-standards-core.md))**:
- **Element grouping (Mandatory)**: wrap each logical Slide-local body unit in a descriptive, page-unique top-level `<g id>` with root-coordinate `data-pptx-bounds="x y width height"`; a helper-authored preset atom stays top-level with `data-pptx-frame` and no bounds; nested groups need none. Give a root background image or full-canvas scrim/decoration rectangle a stable `id` plus `data-pptx-role="background"` / `"decoration"` instead of a wrapper. Thresholds, exemptions, and the Morph staging marker: [`shared-standards-core.md`](./shared-standards-core.md) §4.3.
- **Reference — nested edit groups**: a top-level group may contain descriptive nested `<g>` groups for meaningful subunits; they need no bounds and create no animation step, with no default depth or quota.
-- **Default — bounds are the module zone, not a glyph box (may skip when no text is estimable)**: make each zone as generous as the canvas and siblings allow without overlap. An untransformed line spans `y − 0.85 × font_size` to `y + 0.35 × font_size`. **Width is calibrated once, then estimated**: before P01 the route runs `python3 ${SKILL_DIR}/scripts/text_measure.py calibrate` (Default from the lock with `--outline`, Quick with `--role` arguments) and keeps its per-role table — CJK and Latin ≈ chars per 100 px, plus each role's longest planned line — in context; every later page sizes its zones from that arithmetic (characters ÷ the role's chars-per-100-px × 100; the estimator already carries the wrapping headroom) — write the sentence first, then fit the zone to it; no per-page measurement, no line-by-line tool calls, and never trim wording to satisfy an estimate. Reach for `calibrate --role` or `measure|wrap|box` again only for a role or size that was never calibrated. When text does not fit, first expand a zone with unused space, then reflow or adapt; larger bounds never repair off-canvas text.
+- **Default — bounds are the module zone, not a glyph box (may skip when no text is estimable)**: make each zone as generous as the canvas and siblings allow without overlap. An untransformed line spans `y − 0.85 × font_size` to `y + 0.35 × font_size`. **Width is calibrated once, then estimated**: before P01 the route runs `python3 ${SKILL_DIR}/scripts/text_measure.py calibrate` (Default from the lock with `--outline`, Quick with `--role` arguments) and keeps its per-role table — CJK and Latin ≈ chars per 100 px, plus each role's longest planned line — in context; every later page sizes its zones from that arithmetic (characters ÷ the role's chars-per-100-px × 100; the estimator already carries the wrapping headroom) — write the sentence first, then fit the zone to it; no per-page measurement, no line-by-line tool calls, and never trim wording to satisfy an estimate. Reach for `calibrate --role` or `measure|wrap|box` again only for a role or size that was never calibrated. When text does not fit, first expand a zone with unused space, then reflow or switch texture (prose → points) before dropping a qualifier; larger bounds never repair off-canvas text.
- **Spec adherence**: binding color, canvas, typography, identity, resource, and template anchors hold; layout and other References apply under §2.1 without becoming locks.
- **Template structure**: inherit the native framework only for `template_reuse_scope: mirror|layout`; `style` uses the flat route.
- **Main-agent ownership**: SVG generation runs in the main agent, never a sub-agent — pages share upstream context for cross-page continuity.
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.md
index 9870d2f0..1a44e5d2 100644
--- a/skills/ppt-master/references/strategist.md
+++ b/skills/ppt-master/references/strategist.md
@@ -323,7 +323,7 @@ Generate Step 4 owns the sequence: `design_spec.md` is the complete human-readab
⛔ **GATE 2 — lock context fidelity**: the lock may normalize syntax and add justified recurring roles but never changes identity, discards a refinement, introduces a direction, or becomes a field copy or allowlist; on contradiction return to Gate 1 (fresh recovery reads persisted final evidence once only when active state is absent).
-**Execution lock content**: `spec_lock.md` carries communication, stable color/type anchors, icons, images, page rhythm, Chart/Table references, and route-specific structure; qualitative relationships stay in §IX. Grammar — section set, typography projection (`title_family` + `body_family` + every `<role>_family` and size anchor), `page_visualizations`, flat/structured `pptx_structure` — is [`spec_lock_reference.md`](../templates/spec_lock_reference.md) §2–4; never re-derive a confirmed anchor, collapse distinct stacks into `font_family`, or drop a recurring role. Derived paint and sparse local garnish may stay in one SVG; new base colors, structural fonts, resources, or recurring identity patterns require upstream repair, and Executor never reverse-projects a local choice as planning fact.
+**Execution lock content**: `spec_lock.md` carries communication, stable color/type anchors, icons, images, page rhythm, Chart/Table references, and route-specific structure; qualitative relationships stay in §IX. Grammar — section set, typography projection (`title_family` + `body_family` + every `<role>_family` and size anchor), `page_visualizations`, flat/structured `pptx_structure` — is [`spec_lock_reference.md`](../templates/spec_lock_reference.md) §2–4; never re-derive a confirmed anchor, collapse distinct stacks into `font_family`, or drop a recurring role. Derived paint and sparse local garnish may stay in one SVG; new base colors, structural fonts, resources, or recurring identity patterns require upstream repair, and Executor never reverse-projects a local choice as planning fact. **Hard rule — a lock prohibition is the user's**: `forbidden` takes the technical baseline plus prohibitions the user stated in their own words, each quoted verbatim and tagged `(user)` ([`spec_lock_reference.md`](../templates/spec_lock_reference.md) §2); a confirmed direction's behavior stays identity prose and is never projected into a prohibition.
- **Communication trace is mandatory**: keep the full contract in §I and project only `audience`, `objective` (one execution sentence preserving intent and the `audience_outcome` success condition), `core_message`, and `consumption_mode` into `spec_lock.md communication`. Before finalizing §IX, every named purpose has an outline obligation and every Slide block — cover, divider, closing included — has an `Audience move`; a page that advances nothing is merged, rewritten, or cut. Tools enforce presence, not quality.
- **Custom behavior is concise and executable**: one resolved `mode_behavior` / `visual_style_behavior` sentence or short paragraph plus exact `*_references` only when catalog entries are used; no selection history.
diff --git a/skills/ppt-master/scripts/docs/project.md b/skills/ppt-master/scripts/docs/project.md
index a9a787d9..35047966 100644
--- a/skills/ppt-master/scripts/docs/project.md
+++ b/skills/ppt-master/scripts/docs/project.md
@@ -62,6 +62,8 @@ Notes:
When optional custom reference lists are present, it also requires every id
to resolve to the matching mode, visual-style, or image-rendering catalog,
rejects duplicates, and rejects reference rows on non-custom selections;
+ under `## forbidden` on versioned locks, every non-empty, non-baseline list
+ item must end with `(user)`;
it does not rewrite either artifact or compare their values for textual
equality. It also does not prove final-confirmation → Design Spec fidelity or
Design Spec/context → lock semantic fidelity; Generate Step 4 owns those two
diff --git a/skills/ppt-master/scripts/project_management/project_specs.py b/skills/ppt-master/scripts/project_management/project_specs.py
index 5b89b5ac..ad7db2ba 100644
--- a/skills/ppt-master/scripts/project_management/project_specs.py
+++ b/skills/ppt-master/scripts/project_management/project_specs.py
@@ -93,6 +93,7 @@ _MARKDOWN_DATA_LINE_RE = re.compile(
r"^[ \t]*-[ \t]+(?:\*\*)?([^:\n*]+?)(?:\*\*)?[ \t]*:[ \t]*(.*)$",
re.MULTILINE,
)
+_MARKDOWN_LIST_ITEM_RE = re.compile(r"^[ \t]*-[ \t]+(.*)$")
_IMAGE_PATH_SUFFIXES = frozenset(
{
".bmp",
@@ -120,6 +121,14 @@ _LEGACY_IMAGE_METADATA_KEYS = frozenset(
}
)
_LEGACY_SPEC_LOCK_FORBIDDEN = frozenset({"Mixing icon libraries"})
+_LEGACY_SPEC_LOCK_FORBIDDEN_ANCHORS = (
+ "<style>",
+ "<foreignObject>",
+ "HTML named entities",
+ "Mixing icon libraries",
+ "rgba()",
+ "<g opacity",
+)
_SCAFFOLD_TOKEN_RE = re.compile(r"\{\{[A-Z_]+\}\}")
_SCHEMA_MARKER_RE = re.compile(
r"^<!--[ \t]+ppt-master-schema:[ \t]*([a-z0-9-]+/v[1-9][0-9]*)[ \t]+-->$",
@@ -426,6 +435,47 @@ def default_spec_lock_forbidden() -> frozenset[str]:
return current | _LEGACY_SPEC_LOCK_FORBIDDEN
+def _normalize_forbidden_row(row: str) -> str:
+ """Collapse whitespace for baseline comparison and diagnostics."""
+ return " ".join(row.split())
+
+
+def _validate_spec_lock_forbidden(
+ section: Mapping[str, object] | None,
+) -> list[str]:
+ """Require provenance tags on non-baseline rows in a versioned lock."""
+ if section is None:
+ return []
+
+ baseline = {
+ _normalize_forbidden_row(row)
+ for row in default_spec_lock_forbidden()
+ }
+ errors: list[str] = []
+ row_number = 0
+ for line in str(section.get("body", "")).splitlines():
+ match = _MARKDOWN_LIST_ITEM_RE.match(line)
+ if match is None:
+ continue
+ row = _normalize_forbidden_row(match.group(1))
+ if not row:
+ continue
+ row_number += 1
+ if (
+ row in baseline
+ or any(
+ anchor in row for anchor in _LEGACY_SPEC_LOCK_FORBIDDEN_ANCHORS
+ )
+ or row.endswith("(user)")
+ ):
+ continue
+ errors.append(
+ f"spec_lock.md forbidden: row {row_number} is not a baseline rule "
+ f"and lacks the (user) tag: {row[:60]}"
+ )
+ return errors
+
+
def _load_markdown_schema(schema_path: Path) -> dict[str, object]:
"""Load and sanity-check one versioned Markdown schema."""
with schema_path.open("r", encoding="utf-8") as stream:
@@ -978,6 +1028,8 @@ def _validate_spec_lock_relations(
markdown_name = markdown_path.name
errors: list[str] = []
+ errors.extend(_validate_spec_lock_forbidden(matched.get("forbidden")))
+
def fields(section_id: str) -> dict[str, str]:
section = matched.get(section_id)
if section is None:
diff --git a/skills/ppt-master/scripts/prompt_audit_manifest.json b/skills/ppt-master/scripts/prompt_audit_manifest.json
index b9cc3dc8..305bcd57 100644
--- a/skills/ppt-master/scripts/prompt_audit_manifest.json
+++ b/skills/ppt-master/scripts/prompt_audit_manifest.json
@@ -34,11 +34,11 @@
"skills/ppt-master/references/native-data-interface.md": 5000,
"skills/ppt-master/references/pptx-structure-interface.md": 3000,
"skills/ppt-master/references/preset-shape-vocabulary.md": 2750,
- "skills/ppt-master/references/strategist.md": 12000,
+ "skills/ppt-master/references/strategist.md": 13000,
"skills/ppt-master/references/strategist-image.md": 3250,
"skills/ppt-master/references/strategist-template.md": 2500,
"skills/ppt-master/templates/design_spec_reference.md": 3500,
- "skills/ppt-master/templates/spec_lock_reference.md": 2250,
+ "skills/ppt-master/templates/spec_lock_reference.md": 2500,
"skills/ppt-master/templates/charts/chart-vocabulary.md": 1250,
"skills/ppt-master/templates/tables/table-vocabulary.md": 500,
"skills/ppt-master/templates/sounds/sound-vocabulary.md": 6250,
@@ -2096,7 +2096,7 @@
{
"path": "skills/ppt-master/references/strategist.md",
"role": "producer",
- "fingerprint": "f59b7294bcb0",
+ "fingerprint": "0bf67e7eef14",
"reason": "This producer projects the owner field into the planning contract."
},
{
diff --git a/skills/ppt-master/scripts/svg_quality/checker.py b/skills/ppt-master/scripts/svg_quality/checker.py
index 28e5b442..3340c075 100644
--- a/skills/ppt-master/scripts/svg_quality/checker.py
+++ b/skills/ppt-master/scripts/svg_quality/checker.py
@@ -816,6 +816,8 @@ SPARSE_UNDECLARED_FONT_SIZE_MAX_OCCURRENCES = 2
# Oversampling alone does not imply distortion and is often harmless for small
# logos. Warn about downscaling only when the source also has material on-disk
# weight, because PPTX embeds the compressed source asset rather than raw pixels.
+# 1280px=96 SVG px/in; at 1.5 device px/SVG px on 1080p, 2x becomes ~3x on-screen—visibly soft; smaller is not warned.
+IMAGE_UPSCALE_WARN_RATIO = 2.0
IMAGE_DOWNSIZE_WARN_RATIO = 4.0
IMAGE_DOWNSIZE_WARN_MIN_BYTES = 1024 * 1024
@@ -4753,12 +4755,13 @@ class SVGQualityChecker:
)
fit_label = 'meet'
- if render_scale > 1.0:
+ if render_scale > IMAGE_UPSCALE_WARN_RATIO:
result['warnings'].append(
f"Image {href} is {actual_w}x{actual_h} and renders at "
f"{render_scale:.2f}x scale in a "
f"{int(display_w)}x{int(display_h)} {fit_label} frame "
- "— may appear blurry"
+ f"— about {render_scale * 1.5:.1f}x on a 1080p projector, "
+ "visibly soft; use a larger source or a smaller frame"
)
elif (
render_scale < 1.0 / IMAGE_DOWNSIZE_WARN_RATIO
diff --git a/skills/ppt-master/scripts/tests/test_spec_lock_forbidden.py b/skills/ppt-master/scripts/tests/test_spec_lock_forbidden.py
new file mode 100644
index 00000000..74189756
--- /dev/null
+++ b/skills/ppt-master/scripts/tests/test_spec_lock_forbidden.py
@@ -0,0 +1,161 @@
+#!/usr/bin/env python3
+"""Focused tests for spec-lock forbidden-row provenance."""
+
+from __future__ import annotations
+
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+
+SCRIPTS_DIR = Path(__file__).resolve().parents[1]
+if str(SCRIPTS_DIR) not in sys.path:
+ sys.path.insert(0, str(SCRIPTS_DIR))
+
+from project_management.project_specs import ( # noqa: E402
+ SCHEMA_DIR,
+ default_spec_lock_forbidden,
+ validate_markdown_schema,
+ validate_project_artifacts,
+)
+
+
+_SPEC_LOCK_V1_MARKER = "<!-- ppt-master-schema: spec-lock/v1 -->"
+
+
+def _spec_lock_text(
+ extra_forbidden: tuple[str, ...] = (),
+ *,
+ marker: str | None = _SPEC_LOCK_V1_MARKER,
+) -> str:
+ forbidden = "\n".join(
+ f"- {row}"
+ for row in sorted(default_spec_lock_forbidden()) + list(extra_forbidden)
+ )
+ marker_line = f"{marker}\n" if marker is not None else ""
+ return f"""{marker_line}# Execution Lock
+
+## canvas
+- viewBox: 0 0 1280 720
+- format: PPT 16:9
+
+## communication
+- primary_language: zh-CN
+- audience: Engineers
+- objective: Explain the validator contract
+- core_message: User prohibitions retain provenance
+- consumption_mode: presentation
+
+## mode
+- mode: briefing
+
+## visual_style
+- visual_style: editorial
+
+## colors
+- bg: #FFFFFF
+
+## typography
+- font_family: Arial
+- body: 24
+- title: 36
+
+## icons
+- library: none
+- inventory: none
+
+## page_rhythm
+- P01: anchor
+
+## pptx_structure
+- mode: flat
+- template_reuse_scope: style
+
+## forbidden
+{forbidden}
+"""
+
+
+class SpecLockForbiddenTests(unittest.TestCase):
+ def _validate(
+ self,
+ extra_forbidden: tuple[str, ...] = (),
+ *,
+ marker: str | None = _SPEC_LOCK_V1_MARKER,
+ ) -> list[str]:
+ with tempfile.TemporaryDirectory() as temp_dir:
+ project = Path(temp_dir) / "fixture_ppt169_20260830"
+ project.mkdir()
+ lock_path = project / "spec_lock.md"
+ lock_path.write_text(
+ _spec_lock_text(extra_forbidden, marker=marker),
+ encoding="utf-8",
+ )
+ return validate_markdown_schema(
+ lock_path,
+ SCHEMA_DIR / "spec_lock.schema.json",
+ )
+
+ def test_baseline_only_lock_passes(self) -> None:
+ self.assertEqual(self._validate(), [])
+
+ def test_user_tagged_extra_row_passes(self) -> None:
+ self.assertEqual(
+ self._validate(("不要用任何阴影和发光 (user)",)),
+ [],
+ )
+
+ def test_versioned_legacy_baseline_anchors_pass(self) -> None:
+ rows = (
+ "Legacy `<style>` baseline wording",
+ "Legacy `<foreignObject>` baseline wording",
+ "Legacy HTML named entities baseline wording",
+ "Legacy Mixing icon libraries baseline wording",
+ "Legacy rgba() baseline wording",
+ "Legacy <g opacity baseline wording",
+ )
+ for row in rows:
+ with self.subTest(row=row):
+ self.assertEqual(self._validate((row,)), [])
+
+ def test_versioned_untagged_extra_row_fails(self) -> None:
+ row = "不要用任何阴影和发光"
+ expected = (
+ "spec_lock.md forbidden: row "
+ f"{len(default_spec_lock_forbidden()) + 1} is not a baseline rule "
+ f"and lacks the (user) tag: {row}"
+ )
+
+ self.assertEqual(
+ self._validate((row,), marker=_SPEC_LOCK_V1_MARKER),
+ [expected],
+ )
+
+ def test_legacy_untagged_extra_row_has_no_forbidden_error(self) -> None:
+ row = "不要用任何阴影和发光"
+ with tempfile.TemporaryDirectory() as temp_dir:
+ project = Path(temp_dir) / "fixture_ppt169_20260830"
+ project.mkdir()
+ (project / "spec_lock.md").write_text(
+ _spec_lock_text((row,), marker=None),
+ encoding="utf-8",
+ )
+
+ errors, warnings = validate_project_artifacts(
+ project,
+ project_info={"format": "ppt169"},
+ include_design=False,
+ )
+
+ self.assertFalse(
+ any(error.startswith("spec_lock.md forbidden:") for error in errors)
+ )
+ self.assertTrue(
+ any("legacy artifact has no ppt-master-schema marker" in warning
+ for warning in warnings)
+ )
+
+
+if __name__ == "__main__":
+ unittest.main()
diff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.md
index a04d53e1..d78a7ee4 100644
--- a/skills/ppt-master/templates/spec_lock_reference.md
+++ b/skills/ppt-master/templates/spec_lock_reference.md
@@ -23,7 +23,7 @@ After Generate Step 4 Gate 1, read the completed Design Spec and current page/re
| `icons` | `library`, `inventory` | `library` is the primary bundled style or `none`; `simple-icons/*` may be prepared alone or alongside it; `inventory` indexes the curated synced pool, not page usage or every usable project icon; `stroke_width` conditional |
| `page_rhythm` | One `P<NN>` row per page | `anchor`, `dense`, `breathing` |
| `pptx_structure` | `mode` | `flat`, `structured` |
-| `forbidden` | Literal list items | General standards stay in their owning reference |
+| `forbidden` | Literal list items | The technical baseline rows stay untagged; every other row is a prohibition the user stated in their own words (request, chat, `image_notes`), quoted verbatim and ending with `(user)`; nothing else enters — general standards stay in their owning reference, a template's rules stay in its installed spec, and a confirmed `visual_style_behavior` binds as identity prose without becoming a lock row |
Optional data sections: `images`, `page_visualizations` (Chart/Table only). New locks never write legacy `page_charts` (existing locks may keep it read-only); never declare one page in both.
@@ -31,8 +31,11 @@ Optional data sections: `images`, `page_visualizations` (Chart/Table only). New
## forbidden
- `mask`, `<style>`, `class`, external CSS, `<foreignObject>`, `textPath`, `@font-face`, `<animate*>`, `<set>`, `<script>` / event attributes, `<iframe>`
- HTML named entities in text; write typography as raw Unicode and escape XML reserved characters
+- 不要用任何阴影和发光 (user)
```
+A `(user)` row is the user's sentence, not a paraphrase and never widened; a Strategist-drafted direction — even once confirmed — is identity prose in `visual_style_behavior`, not a prohibition, so nothing is projected from it into this section. `project_manager.py validate` rejects an untagged non-baseline row.
+
---
## 3. Conditional sections and fields
diff --git a/skills/ppt-master/workflows/generate-pptx.md b/skills/ppt-master/workflows/generate-pptx.md
index 03d7524f..869ebe85 100644
--- a/skills/ppt-master/workflows/generate-pptx.md
+++ b/skills/ppt-master/workflows/generate-pptx.md
@@ -280,7 +280,7 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> \
- Every `warning` is advisory — no mandatory modification, no auto-normalizing user syntax, no disposition line; structured-template warnings (empty/framing-only Layout, bare Master, duplicate layout keys) guide optional cleanup only. A condition that must be corrected before release is an `error`.
- **Hard rule — token-safe report handling**: on success use the exit status and terminal summary; never `cat` the complete JSON into context. Read it only for failure investigation, an explicit audit, or a field absent from stdout.
-**Mandatory — final carrier-receipt review**: compare the checker's `[CARRIERS]` summary (detail under `files[].info.carrier_receipt`) with the retained page jobs, resource roles, and running geometry signatures. Counts and diversity are not quotas; when the facts contradict an active decision — an adopted preset absent, a directional / step / flowchart relationship drawn as a hand path or polygon where `executor-base.md` §3.0 names a preset, a primary image reduced to a minor frame, unrelated jobs collapsing to one neutral construction — read only the affected rows, repair those pages in one pass, and rerun the final checker. **Absence needs a reason**: when the receipt shows a deck-wide zero — `Presets: (none)`, or `inline emphasis 0`, `gradients 0`, or `filters 0` on the `Effects:` line — or fewer pages carrying a preset or connector than pages whose §IX `Relationships` line names `order` / `link` / `parent` / `membership`, answer one line per absent family or per such page: what carries that job instead, and why it serves the reader better. The style, speed, restraint, "text was enough", or "it is editable anyway" are not answers; a family or page without one is repaired where the page job calls for it, then the checker reruns. Choosing not to use a device is valid — only an unstated reason is not.
+**Mandatory — final carrier-receipt review**: compare the checker's `[CARRIERS]` summary (detail under `files[].info.carrier_receipt`) with the retained page jobs, resource roles, and running geometry signatures. Counts and diversity are not quotas; when the facts contradict an active decision — an adopted preset absent, a directional / step / flowchart relationship drawn as a hand path or polygon where `executor-base.md` §3.0 names a preset, a primary image reduced to a minor frame, unrelated jobs collapsing to one neutral construction — read only the affected rows, repair those pages in one pass, and rerun the final checker. **Absence needs a reason**: when the receipt shows a deck-wide zero — `Presets: (none)`, or `inline emphasis 0`, `gradients 0`, or `filters 0` on the `Effects:` line — or fewer pages carrying a preset or connector than pages whose §IX `Relationships` line names `order` / `link` / `parent` / `membership`, answer one line per absent family or per such page: what carries that job instead, and why it serves the reader better — for presets, one line per job the family serves, not for arrows alone: direction and sequence (arrows, chevrons, flow nodes), grouping and ownership (brackets, braces, frames, plaques), emphasis and annotation (callouts, badges, banners, stars). The style, speed, restraint, "text was enough", or "it is editable anyway" are not answers; a family or page without one is repaired where the page job calls for it, then the checker reruns. Choosing not to use a device is valid — only an unstated reason is not.
**Logic Construction Phase (conditional)**: when the effective Speaker Notes outcome in §I is enabled, load [`executor-notes.md`](../references/executor-notes.md): validate a frozen `notes/total.md` against every information-bearing final SVG group (repair the page or the plan, never the script), or otherwise ground each page's narration in its final SVG and write `notes/total.md`. When disabled, load nothing and create no notes.
diff --git a/skills/ppt-master/workflows/profiles/quick-generate.md b/skills/ppt-master/workflows/profiles/quick-generate.md
index 8d6b44d3..eb697f55 100644
--- a/skills/ppt-master/workflows/profiles/quick-generate.md
+++ b/skills/ppt-master/workflows/profiles/quick-generate.md
@@ -192,7 +192,7 @@ python3 ${SKILL_DIR}/scripts/svg_quality_checker.py <project_path> \
--quick-generate --canonical-authoring --stage final --json
```
-**Mandatory — final carrier-receipt review**: compare the `[CARRIERS]` summary with the retained page jobs, deck shape language, motif, resource roles, and geometry signatures. Counts are not quotas; when the facts contradict an active decision — an adopted preset absent, a directional / step / flowchart relationship drawn as a hand path or polygon where `executor-base.md` §3.0 names a preset, a primary image reduced to a minor frame — read only the affected `files[].info.carrier_receipt` rows, repair those pages in one pass, and rerun the checker. **Absence needs a reason**: when the receipt shows a deck-wide zero — `Presets: (none)`, or `inline emphasis 0`, `gradients 0`, or `filters 0` on the `Effects:` line — or fewer pages carrying a preset or connector than pages whose transient relationship statement names `order` / `link` / `parent` / `membership`, answer one line per absent family or per such page: what carries that job instead, and why it serves the reader better. The style, speed, restraint, "text was enough", or "it is editable anyway" are not answers; a family or page without one is repaired where the page job calls for it, then the checker reruns. Choosing not to use a device is valid — only an unstated reason is not.
+**Mandatory — final carrier-receipt review**: compare the `[CARRIERS]` summary with the retained page jobs, deck shape language, motif, resource roles, and geometry signatures. Counts are not quotas; when the facts contradict an active decision — an adopted preset absent, a directional / step / flowchart relationship drawn as a hand path or polygon where `executor-base.md` §3.0 names a preset, a primary image reduced to a minor frame — read only the affected `files[].info.carrier_receipt` rows, repair those pages in one pass, and rerun the checker. **Absence needs a reason**: when the receipt shows a deck-wide zero — `Presets: (none)`, or `inline emphasis 0`, `gradients 0`, or `filters 0` on the `Effects:` line — or fewer pages carrying a preset or connector than pages whose transient relationship statement names `order` / `link` / `parent` / `membership`, answer one line per absent family or per such page: what carries that job instead, and why it serves the reader better — for presets, one line per job the family serves, not for arrows alone: direction and sequence (arrows, chevrons, flow nodes), grouping and ownership (brackets, braces, frames, plaques), emphasis and annotation (callouts, badges, banners, stars). The style, speed, restraint, "text was enough", or "it is editable anyway" are not answers; a family or page without one is repaired where the page job calls for it, then the checker reruns. Choosing not to use a device is valid — only an unstated reason is not.
**Notes** (when enabled): load [`executor-notes.md`](../../references/executor-notes.md) after the passing check, validate a frozen script or pre-SVG narration without regenerating it or otherwise generate `notes/total.md` from the final roster, then split: