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(workflow): align design spec contracts and template docs
hugohe30a97b47bba72
diff --git a/skills/ppt-master/references/executor-base.md b/skills/ppt-master/references/executor-base.mdindex 27dd7e19..ef560908 100644--- a/skills/ppt-master/references/executor-base.md+++ b/skills/ppt-master/references/executor-base.md@@ -66,7 +66,7 @@ File naming format: `<number>_<page_name>.svg`## 4. Icon Usage-Four approaches: **A: Emoji** (`<text>🚀</text>`) | **B: AI-generated** (SVG basic shapes) | **C: Built-in library** (`templates/icons/` 6000+ icons, recommended) | **D: Custom** (user-specified)+Four approaches: **A: Emoji** (`<text>🚀</text>`) | **B: AI-generated** (SVG basic shapes) | **C: Built-in library** (`templates/icons/` 6700+ icons, recommended) | **D: Custom** (user-specified)**Built-in icons — Placeholder method (recommended)**:diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex 358c15ef..c7d3aea7 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -110,7 +110,7 @@ Proactively provide a color scheme (HEX values) based on content characteristics| **C** | Built-in icon library | Professional scenarios (recommended) || **D** | Custom icons | Has brand assets |-Built-in library contains 7000+ icons across three libraries:+Built-in library contains 6700+ icons across three libraries:| Library | Style | Count | Prefix | When to use ||---------|-------|-------|--------|-------------|@@ -348,7 +348,7 @@ The Strategist should make professional judgments on the template basis generate| B) General Consulting | Structured logical sections; data-driven insights | Consulting-style colors, structured content layout | Professional terms, data interpretation, conclusion-first || C) Top Consulting | SCQA framework, pyramid principle conclusion-first | Data contextualization, strategic color usage | Highly condensed, logically rigorous, conclusion-driven |-### 6.2 Outline Output Specification (Must include 12 chapters)+### 6.2 Outline Output Specification (Must include 11 chapters)| Chapter | Content Requirements ||---------|---------------------|@@ -363,8 +363,6 @@ The Strategist should make professional judgments on the template basis generate| IX. Content Outline | Grouped by chapter; each page includes layout, title, content points, visualization type (if applicable) || X. Speaker Notes Requirements | File naming rules, content structure description || XI. Technical Constraints Reminder | SVG generation rules, PPT compatibility rules |-| XII. Design Checklist | Pre-generation / post-generation check items |-| XIII. Next Steps | Clarify subsequent pipeline (Image_Generator or Executor) |**Generation steps**:1. Read reference template: `templates/design_spec_reference.md`@@ -387,7 +385,7 @@ The Strategist saves the Design Specification & Content Outline to `projects/<pr## 8. Complete Design Spec and Prompt Next Steps-Prompt the next step based on the confirmed template option and image usage selection.+After writing `design_spec.md`, provide the next-step prompt based on the confirmed template option and image usage selection. This prompt is a workflow handoff instruction, not a section inside `design_spec.md`.### Template Option A (Using existing template)diff --git a/skills/ppt-master/scripts/error_helper.py b/skills/ppt-master/scripts/error_helper.pyindex 3a631f3d..fe5eb66f 100644--- a/skills/ppt-master/scripts/error_helper.py+++ b/skills/ppt-master/scripts/error_helper.py@@ -25,7 +25,7 @@ class ErrorHelper:'missing_spec': {'message': 'Missing design specification file','solutions': [- 'Create a design_specification.md file',+ 'Create a design_spec.md file','Include: canvas specs, color scheme, font specs, layout specs, content outline','Refer to the design specification generated by the Strategist role'],diff --git a/skills/ppt-master/scripts/project_utils.py b/skills/ppt-master/scripts/project_utils.pyindex d406d24f..68fe7c68 100644--- a/skills/ppt-master/scripts/project_utils.py+++ b/skills/ppt-master/scripts/project_utils.py@@ -182,8 +182,8 @@ def get_project_info(project_path: str) -> Dict:# Check README.mdinfo['has_readme'] = (project_path / 'README.md').exists()- # Check design specification files (multiple possible names)- spec_files = ['设计规范与内容大纲.md', 'design_specification.md', '设计规范.md']+ # Check design specification files (current standard + legacy names)+ spec_files = ['design_spec.md', '设计规范与内容大纲.md', 'design_specification.md', '设计规范.md']for spec_file in spec_files:if (project_path / spec_file).exists():info['has_spec'] = True@@ -256,10 +256,10 @@ def validate_project_structure(project_path: str, verbose: bool = False) -> Tuplerrors.append(msg)# Check design specification file- spec_files = ['设计规范与内容大纲.md', 'design_specification.md', '设计规范.md']+ spec_files = ['design_spec.md', '设计规范与内容大纲.md', 'design_specification.md', '设计规范.md']has_spec = any((project_path / f).exists() for f in spec_files)if not has_spec:- msg = "Missing design specification file (suggested filename: design_specification.md)"+ msg = "Missing design specification file (suggested filename: design_spec.md)"if use_helper and verbose:msg += "\n" + ErrorHelper.format_error_message('missing_spec')warnings.append(msg)@@ -373,7 +373,7 @@ def find_all_projects(base_dir: str) -> List[Path]:# Check if it's a valid project directory (contains svg_output or design spec)has_svg_output = (item / 'svg_output').exists()has_spec = any((item / f).exists() for f in- ['设计规范与内容大纲.md', 'design_specification.md', '设计规范.md'])+ ['design_spec.md', '设计规范与内容大纲.md', 'design_specification.md', '设计规范.md'])if has_svg_output or has_spec:projects.append(item)diff --git a/skills/ppt-master/templates/README.md b/skills/ppt-master/templates/README.mdindex 5d8e3213..907e734c 100644--- a/skills/ppt-master/templates/README.md+++ b/skills/ppt-master/templates/README.md@@ -23,7 +23,7 @@ The `layouts/` directory contains pre-built page layout templates organized by d## Visualization Templates-The `charts/` directory contains 33 standard visualization templates. For backward compatibility, the directory name remains `charts/`, but its scope includes charts, infographics, process diagrams, relationship diagrams, and strategic frameworks:+The `charts/` directory contains 52 standardized visualization templates. For backward compatibility, the directory name remains `charts/`, but its scope includes charts, infographics, process diagrams, relationship diagrams, and strategic frameworks:- KPI Cards- Bar Chart / Stacked Bar Chart@@ -42,10 +42,11 @@ The `charts/` directory contains 33 standard visualization templates. For backwa## Icon Library-The `icons/` directory contains 6000+ vector icons from [Tabler Icons](https://tabler.io/icons), organized in two active libraries:+The `icons/` directory contains 6700+ vector icons across three active libraries:| Library | Style | Count ||---------|-------|-------|+| `chunk` | fill / straight-line geometry | 640 || `tabler-filled` | fill / solid | 1000+ || `tabler-outline` | stroke / line | 5000+ |diff --git a/skills/ppt-master/templates/charts/README.md b/skills/ppt-master/templates/charts/README.mdindex 57f68a29..4cf5b2d6 100644--- a/skills/ppt-master/templates/charts/README.md+++ b/skills/ppt-master/templates/charts/README.md@@ -1,6 +1,6 @@-# SVG Visualization Template Library (33 Types)+# SVG Visualization Template Library (52 Types)-This directory provides **33 standardized SVG visualization templates** for use as structured visualization selection references in PPT Master.+This directory provides **52 standardized SVG visualization templates** for use as structured visualization selection references in PPT Master.> For backward compatibility, the directory remains `templates/charts/`, but the library scope includes charts, infographics, process diagrams, relationship diagrams, and strategic frameworks.diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.mdindex a1ee5ca4..930d0d38 100644--- a/skills/ppt-master/templates/design_spec_reference.md+++ b/skills/ppt-master/templates/design_spec_reference.md@@ -1,5 +1,7 @@# {project_name} - Design Spec+> This document is the unified handoff artifact for design definition and execution constraints. It combines visual specifications, content outline, speaker-notes requirements, and implementation boundaries needed by downstream roles.+## I. Project Information| Item | Value |@@ -152,7 +154,7 @@### Source-- **Built-in icon library**: `templates/icons/` (640+ icons)+- **Built-in icon library**: `templates/icons/` (6700+ icons across three libraries)- **Usage method**: Placeholder format `{{icon:category/icon-name}}`### Recommended Icon List (fill as needed)@@ -250,33 +252,3 @@ Generate corresponding speaker note files for each page, saved to the `notes/` d- `<g opacity="...">` FORBIDDEN (group opacity); set on each child element individually- Image transparency uses overlay mask layer (`<rect fill="bg-color" opacity="0.x"/>`)- Inline styles only; external CSS and `@font-face` FORBIDDEN-------## XII. Design Checklist--### Pre-generation--- [ ] Content fits page capacity-- [ ] Layout mode selected correctly-- [ ] Colors used semantically--### Post-generation--- [ ] viewBox = `{canvas_info['viewbox']}`-- [ ] No `<foreignObject>` elements-- [ ] All text readable (>=14px)-- [ ] Content within safe area-- [ ] All elements aligned to grid-- [ ] Same elements maintain consistent style-- [ ] Colors conform to spec-- [ ] CRAP four-principle check passed-------## XIII. Next Steps--1. ✅ Design spec complete-2. **Next step**: [Choose based on image approach]- - No AI images → Invoke **Executor** role to generate SVGs- - Has AI images → Invoke **Image_Generator** role, then invoke Executor after completiondiff --git a/skills/ppt-master/templates/icons/README.md b/skills/ppt-master/templates/icons/README.mdindex 68ca3e13..c54efb26 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 **7000+ high-quality SVG icons** across three libraries that can be directly embedded into SVG files generated by PPT Master.+This directory provides **6700+ high-quality SVG icons** across three libraries that can be directly embedded into SVG files generated by PPT Master.## Librariesdiff --git a/skills/ppt-master/templates/layouts/academic_defense/design_spec.md b/skills/ppt-master/templates/layouts/academic_defense/design_spec.mdindex 5f1e328b..01359cde 100644--- a/skills/ppt-master/templates/layouts/academic_defense/design_spec.md+++ b/skills/ppt-master/templates/layouts/academic_defense/design_spec.md@@ -273,22 +273,3 @@ Templates use `{{PLACEHOLDER}}` format placeholders. Common placeholders:3. Use placeholders to mark content that needs replacement4. Ensure presenter info and advisor info are complete5. Generate the final SVG through the Executor role-------## XIII. Design Checklist--### Before Generation--- [ ] Is the content suitable for the current page layout-- [ ] Does the color scheme follow the specification-- [ ] Is the font size hierarchy correct--### After Generation--- [ ] viewBox = `0 0 1280 720`-- [ ] No prohibited elements-- [ ] Text is readable (≥12px)-- [ ] Content is within the safe area-- [ ] Elements are properly aligned-- [ ] Style consistency check passeddiff --git a/skills/ppt-master/templates/layouts/mckinsey/design_spec.md b/skills/ppt-master/templates/layouts/mckinsey/design_spec.mdindex 70fe0ce2..73ee236c 100644--- a/skills/ppt-master/templates/layouts/mckinsey/design_spec.md+++ b/skills/ppt-master/templates/layouts/mckinsey/design_spec.md@@ -234,29 +234,7 @@ Templates use `{{PLACEHOLDER}}` format placeholders. Common placeholders:----## XII. Quality Checklist--### Pre-Generation--- [ ] Each page has a clear core message-- [ ] Sufficient data support-- [ ] Clear logical structure--### Post-Generation--- [ ] viewBox = `0 0 1280 720`-- [ ] McKinsey Blue consistently applied-- [ ] Key data prominently highlighted (Amber/Coral)-- [ ] Chart axes fully labeled-- [ ] Text readability is good (contrast ratio > 4.5:1)-- [ ] Elements precisely aligned (grid alignment)-- [ ] Page numbers/footer information complete-- [ ] No `<foreignObject>`-- [ ] All text uses `<tspan>` for line breaks-------## XIII. Usage Instructions+## XII. Usage Instructions1. Copy the template to the project directory2. Select the appropriate page template based on briefing content requirementsdiff --git "a/skills/ppt-master/templates/layouts/\346\213\233\345\225\206\351\223\266\350\241\214/design_spec.md" "b/skills/ppt-master/templates/layouts/\346\213\233\345\225\206\351\223\266\350\241\214/design_spec.md"index bf71ec52..a8a6d815 100644--- "a/skills/ppt-master/templates/layouts/\346\213\233\345\225\206\351\223\266\350\241\214/design_spec.md"+++ "b/skills/ppt-master/templates/layouts/\346\213\233\345\225\206\351\223\266\350\241\214/design_spec.md"@@ -208,28 +208,7 @@ Core assets are wired into SVG templates. `logo_dark.png` is used on light pages| Negative indicator | `#E74C3C` || Neutral | `#666666` |-## XIII. Quality Checklist--### Pre-Generation--- [ ] Each page has a clear core message-- [ ] Sufficient data/case-study support-- [ ] Clear logical structure--### Post-Generation--- [ ] viewBox = `0 0 1280 720`-- [ ] Brand Red `#C8152D` applied consistently across headers and accents-- [ ] Key data prominently highlighted (Brand Red or Finance Blue)-- [ ] Chart axes fully labeled-- [ ] Text readability: contrast ratio > 4.5:1-- [ ] Elements aligned to 8px grid-- [ ] Header logo/strip consistent with template-- [ ] Page numbers and source text present in footer-- [ ] No `foreignObject`, `clipPath`, `mask`, `<style>`, or other banned tags-- [ ] All text wrapping uses `<tspan>`, not `<foreignObject>`--## XIV. Usage Instructions+## XIII. Usage Instructions1. Copy the template directory to the project `templates/` folder2. Read this design specification to understand the visual systemdiff --git "a/skills/ppt-master/templates/layouts/\351\207\215\345\272\206\345\244\247\345\255\246/design_spec.md" "b/skills/ppt-master/templates/layouts/\351\207\215\345\272\206\345\244\247\345\255\246/design_spec.md"index 3af69291..125c1a05 100644--- "a/skills/ppt-master/templates/layouts/\351\207\215\345\272\206\345\244\247\345\255\246/design_spec.md"+++ "b/skills/ppt-master/templates/layouts/\351\207\215\345\272\206\345\244\247\345\255\246/design_spec.md"@@ -230,14 +230,3 @@ Small circle elements representing the nighttime lights of the Mountain City:| `{{CONTACT_INFO}}` | Contact information || `{{TOC_ITEM_N_TITLE}}` | TOC item title || `{{TOC_ITEM_N_DESC}}` | TOC item description |-------## XI. Design Checklist--- [ ] viewBox = `0 0 1280 720`-- [ ] Diagonal block angles are consistent (8-12°)-- [ ] Logo version matches background-- [ ] Colors conform to specification-- [ ] Wave decorations are correctly positioned-- [ ] Text is readable (>=11px)