zcdsj
/
zcbot
5
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
zcbot/skills/ppt/templates
History
caoqianming e3a432dcdd feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 
旧 python-pptx 固定组合版式件是版面单调/AI 味的架构天花板。改为 SVG-first:
AI 逐页手写 SVG 设计稿 → 纯 Python 转换器逐元素译成原生可编辑 DrawingML。

- 搬引擎:svg_to_pptx/ 转换器 + finalize_svg/svg_finalize + svg_quality_checker + total_md_split + update_spec(依赖闭包干净,只需 python-pptx)
- 搬知识:references(shared-standards/executor-base/strategist/image-layout-*/canvas-formats)+ 5 叙事骨架 + 19 视觉风格
- 搬模板:templates(layouts/decks/brands/charts + 图标库 1.1w+ + spec 骨架)
- 换 GUI:浏览器 Confirm UI → 聊天 BLOCKING 八条确认;live preview → svg_preview.py(无头 Chrome 渲 SVG→PNG);配图走 zcbot imagegen skill
- 默认主题改自由设计(商务红降为候选之一)
- 修 Windows GBK 控制台 UnicodeEncodeError:6 个入口脚本加 sys.stdout.reconfigure(utf-8) shim
- 端到端验证通过:4 页材料领域 deck,质检 0 error → finalize 嵌图标 → 导出原生 pptx → 渲图肉眼验收(swiss-minimal 设计级,非 AI 味)

移植自 github.com/hugohe3/ppt-master (MIT),适配 zcbot task_dir/聊天确认/imagegen 工作流。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 		2026-06-29 16:38:58 +08:00
..
brands feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
charts feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
decks feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
icons feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
layouts feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
README.md feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
design_spec_reference.md feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00
spec_lock_reference.md feat(ppt): skill 重构为 SVG-first(移植 ppt-master,弃 python-pptx 版式件)(bump 0.33.0) 2026-06-29 16:38:58 +08:00

README.md

Template Resources

Design Specification & Outline Reference

design_spec_reference.md is an all-in-one reference template for defining:

  1. Visual Specifications: Canvas dimensions, color scheme, typography, layout principles
  2. Content Outline: Slide-by-slide page structure planning
  3. Technical Constraints: Hard requirements for SVG generation and PPT compatibility

View Design Spec Reference

Page Layout Templates

The layouts/ directory contains pre-built page layout templates organized by design style:

  • General: Versatile modern style, clean and flexible

  • Consultant: Consulting style, professional and structured

  • Consultant Top: Top-tier consulting style (MBB-level)

  • Academic Defense: Academic defense style, research-oriented

  • Human browsing: layouts/README.md

  • Slim lookup (discovery only): layouts/layouts_index.json — used to answer "what templates exist?". Step 3 triggers on an explicit directory path supplied by the user, not on names from this index.

Brand Identity Presets

The brands/ directory holds brand-only templates: identity bundles (color / typography / logo / voice / icon style) without an SVG page roster. Brands follow the same explicit-path trigger rule as layout templates — at SKILL.md Step 3 the user supplies the brand directory path to apply it; bare brand names never trigger. Both layout and brand inputs land in the same project directory (<project_path>/templates/). When supplied together, Step 3 fuses them into a single design_spec.md (brand wins on identity tokens, layout wins on page structure) — see SKILL.md Step 3 for the precedence table.

A brand is structurally a layout template minus its page roster. Use a brand when the user wants identity locking with free page layout; use a layout template when fixed page structures are also required.

Visualization Templates

The charts/ directory contains 57 standardized visualization templates. For backward compatibility, the directory name remains charts/, but its scope includes charts, infographics, process diagrams, relationship diagrams, strategic frameworks, and system architecture diagrams:

  • KPI Cards

  • Bar Chart / Stacked Bar Chart

  • Line Chart / Dual-Axis Line Chart

  • Donut Chart

  • Radar Chart

  • Funnel Chart

  • Matrix (2x2)

  • Timeline

  • Gantt Chart

  • Process Flow

  • Org Chart

  • Layered Architecture / Module Composition / Hub with Described Spokes / Pipeline with Stages / Client-Server Flow

  • Library index (single source of truth): charts/charts_index.json

  • Directory overview: charts/README.md

Icon Library

The icons/ directory contains 11,600+ vector icons across five libraries:

Library Style Count
chunk-filled fill / straight-line geometry 640
tabler-filled fill / bezier-curve forms 1000+
tabler-outline stroke / line 5000+
phosphor-duotone duotone / single color + 0.2 opacity backplate 1200+
simple-icons brand logos (company / product marks) 3400+
  • Usage & style rules: icons/README.md
  • Search icons: ls skills/ppt-master/templates/icons/<library>/ | grep <keyword>