zcdsj
/
zcbot
5
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
zcbot/skills/ppt/templates
History
caoqianming 4a6182a76a fix(ppt): 修生成 PPT 缺图形(扁平 deck 质检 gate + 策略层视觉下限)(bump 0.33.4) 
延续缺图标排查,统计最近 ppt生成 任务 24 页 SVG 的元素构成:<path>=0、
<image>=0,整本是 <text> 摞 <rect>(文字方块),零示意图/图表/配图。根因同
图标——71 个 charts/ 模板没用、content→版式映射形同虚设,且策略层把"Not every
page needs a chart"当跳过口子(spec_lock 实际 page_layouts: free design、无
page_charts 段),输出层又无 gate 拦扁平 deck。两层修(用户选定):

- A' 输出 gate(svg_quality_checker):统计每页图形图元 <path>/<polyline>/
  <polygon>/<image>(rect/line 是版面脚手架不算);≥6 页且文字密集(avg <text>
  ≥10/页)却全 deck 0 图元 → deck 级 error 退非零(逼回执行重写);多数页无图元
  → INFO;<6 页豁免(不误伤极简/teaser)。实测:8 页文字方块→exit 1;任一页带
  path→放行;4 页→豁免。

- B' 策略层视觉下限(strategist.md GATE):把 §633「Template Match」从纯建议升为
  硬下限——内容 deck(≥6 页)每个能结构化的内容页必须分配视觉处理(page_charts
  模板 / page_layouts 结构模板 / §VII 自绘示意图),spec_lock 不许 page_charts +
  page_layouts 同时空着;给出 content→图形映射速查;明示下游 A' 会硬卡。同步改
  SKILL §大纲映射纪律 + §阶段四质检清单 + spec_lock_reference page_charts 段。

诚实边界:prompt+gate 抬下限(逼别交全文字 deck),执行模型设计功力是上限;gate
守"零图形"底线而非"每页必图表",避免误伤极简风。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 		2026-06-30 14:37:28 +08:00
..
brands fix(ppt): 修生成 PPT 缺图标(图标管线四层断点)+ 沙箱 SVG 预览渲染(bump 0.33.3) 2026-06-30 13:59:00 +08:00
charts fix(ppt): 修生成 PPT 缺图标(图标管线四层断点)+ 沙箱 SVG 预览渲染(bump 0.33.3) 2026-06-30 13:59:00 +08:00
decks fix(ppt): 修生成 PPT 缺图标(图标管线四层断点)+ 沙箱 SVG 预览渲染(bump 0.33.3) 2026-06-30 13:59:00 +08:00
icons fix(ppt): 修生成 PPT 缺图标(图标管线四层断点)+ 沙箱 SVG 预览渲染(bump 0.33.3) 2026-06-30 13:59:00 +08:00
layouts fix(ppt): 修生成 PPT 缺图标(图标管线四层断点)+ 沙箱 SVG 预览渲染(bump 0.33.3) 2026-06-30 13:59:00 +08:00
README.md fix(ppt): 修生成 PPT 缺图标(图标管线四层断点)+ 沙箱 SVG 预览渲染(bump 0.33.3) 2026-06-30 13:59:00 +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 fix(ppt): 修生成 PPT 缺图形(扁平 deck 质检 gate + 策略层视觉下限)(bump 0.33.4) 2026-06-30 14:37:28 +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/templates/icons/<library>/ | grep <keyword>