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
docs(visual-edit): make the trigger easier to recognize
hugohe3d4c3d1df0d5b
diff --git a/AGENTS.md b/AGENTS.mdindex 8625c4ac..49d150cf 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -14,7 +14,7 @@ PPT Master is an AI-driven presentation generation system. Multi-role collaborat>> Recorded narration / video export: run the standalone [`generate-audio`](skills/ppt-master/workflows/generate-audio.md) workflow after post-processing.>-> Fine-grained edits after export: when (and only when) the user explicitly asks to refine specific elements, run the standalone [`visual-edit`](skills/ppt-master/workflows/visual-edit.md) workflow.+> Post-export iteration: whenever the user asks to change anything on a generated slide ("改一下", "调字号", "那里看着不对", "把图片换大点"), the [`visual-edit`](skills/ppt-master/workflows/visual-edit.md) workflow is available — surface it as an option. If the user describes the change with enough specificity to apply directly ("第 3 页副标题字号改 32"), edit the SVG directly instead; if they're vaguely pointing at "somewhere" on the deck, run the workflow.## Execution Requirementsdiff --git a/CLAUDE.md b/CLAUDE.mdindex 23a94584..5fe2ab6f 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -14,7 +14,7 @@ PPT Master is an AI-driven presentation generation system. Multi-role collaborat>> Recorded narration / video export: run the standalone [`generate-audio`](skills/ppt-master/workflows/generate-audio.md) workflow after post-processing.>-> Fine-grained edits after export: when (and only when) the user explicitly asks to refine specific elements, run the standalone [`visual-edit`](skills/ppt-master/workflows/visual-edit.md) workflow.+> Post-export iteration: whenever the user asks to change anything on a generated slide ("改一下", "调字号", "那里看着不对", "把图片换大点"), the [`visual-edit`](skills/ppt-master/workflows/visual-edit.md) workflow is available — surface it as an option. If the user describes the change with enough specificity to apply directly ("第 3 页副标题字号改 32"), edit the SVG directly instead; if they're vaguely pointing at "somewhere" on the deck, run the workflow.## Execution Requirementsdiff --git a/skills/ppt-master/SKILL.md b/skills/ppt-master/SKILL.mdindex 077fa873..86ed9c51 100644--- a/skills/ppt-master/SKILL.md+++ b/skills/ppt-master/SKILL.md@@ -337,7 +337,7 @@ Full effect list, anchor logic, and limits: [`references/animations.md`](referen> ❌ **NEVER** export from `svg_output/` — MUST use `-s final` (exports from `svg_final/`)> ❌ **NEVER** use `--only` (it suppresses one of the two output files)-> Fine-grained edits after export: when (and only when) the user explicitly asks to refine specific elements, run the standalone [`visual-edit`](workflows/visual-edit.md) workflow.+> Post-export iteration: whenever the user asks to change anything on a generated slide ("改一下", "调字号", "那里看着不对", "把图片换大点"), the [`visual-edit`](workflows/visual-edit.md) workflow is available — surface it as an option. If the user describes the change with enough specificity to apply directly ("第 3 页副标题字号改 32"), edit the SVG directly instead; if they're vaguely pointing at "somewhere" on the deck, run the workflow.---diff --git a/skills/ppt-master/workflows/visual-edit.md b/skills/ppt-master/workflows/visual-edit.mdindex bf2a53e9..b35224b5 100644--- a/skills/ppt-master/workflows/visual-edit.md+++ b/skills/ppt-master/workflows/visual-edit.md@@ -4,17 +4,21 @@ description: Launch a local browser-based visual editor so the user can pinpoint# Visual Edit Workflow-> Standalone post-export step. Run when the user explicitly asks for fine-grained visual edits after PPTX export — e.g. "want to tweak something specific", "this part isn't right", "调一下这里" — any wording that signals they want to refine particular elements rather than regenerate. Do NOT run as part of the default flow.+> Standalone post-export step. Whenever the user asks to change something on a generated slide — "改一下这里", "字号小了", "那张图不对", "把背景颜色调暖一点", or any similar wording — this workflow is the go-to **when the user can't precisely name what to change**. If the user describes the change concretely enough that you can edit the SVG directly (e.g. "第 3 页副标题字号改 32"), do that instead — don't force them through the editor.This workflow is **independent**: it operates on `<project_path>/svg_output/` and re-runs the same post-processing scripts the main pipeline uses. Safe to invoke in a fresh session as long as the project has reached Step 7.## When to Run- The deck has been exported once (Steps 1–7 of the main workflow are complete).-- The user explicitly requests fine-grained edits.-- A browser is available on the host (Linux headless / containers without a display cannot use this workflow — fall back to direct SVG edits via conversation).+- The user wants to change one or more specific visual elements **and either can't pinpoint them in words or would benefit from clicking the slide directly**.+- A browser is available on the host (Linux headless / containers without a display: skip; apply edits directly via conversation instead).-If the user's request is broad ("regenerate", "redo this slide"), use the main workflow instead — the editor is for surgical edits, not full rewrites.+## When NOT to Run++- The user gave a precise edit you can apply right now ("change page 3 title font-size to 32") — just edit the SVG.+- The user wants a full regeneration ("redo this slide", "换个风格") — use the main workflow.+- No browser available.---