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

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.md
index 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.md
index 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.py
index 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.py
index 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.md
info['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) -> Tupl
errors.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.md
index 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.md
index 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.md
index 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 completion
diff --git a/skills/ppt-master/templates/icons/README.md b/skills/ppt-master/templates/icons/README.md
index 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.
## Libraries
diff --git a/skills/ppt-master/templates/layouts/academic_defense/design_spec.md b/skills/ppt-master/templates/layouts/academic_defense/design_spec.md
index 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 replacement
4. Ensure presenter info and advisor info are complete
5. 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 passed
diff --git a/skills/ppt-master/templates/layouts/mckinsey/design_spec.md b/skills/ppt-master/templates/layouts/mckinsey/design_spec.md
index 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 Instructions
1. Copy the template to the project directory
2. Select the appropriate page template based on briefing content requirements
diff --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 Instructions
1. Copy the template directory to the project `templates/` folder
2. Read this design specification to understand the visual system
diff --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)