zcbot/skills/ppt/templates
caoqianming 0e02cff6c6 feat(ppt): 对齐网格锁+错位/单调质检(d1285247 陶瓷 deck 复盘,bump 0.37.0)
复盘 25 页陶瓷 deck 三类缺陷:跨页左基线漂移+并排块顶差 2-12px 的
"想对齐没对齐"、5 页同为图标卡网格的单调、标题语义不兑现(架构画成
横条列表)。修四层:
- spec_lock 新增 layout_grid 锁段(margin_x/content_top/footer_y/gutter),
  strategist 派生、executor 每页吸附、checker 强制
- executor-base §3 网格对齐纪律(同 top 同高等 gutter、打破网格 >=16px、
  同行文字 >=0.3em 禁贴字)
- svg_quality_checker 新增 check 14:兄弟卡片近失对齐 2-12px error
  (底对齐/中心对齐/chart-plot-area 内数据柱三类豁免,71 charts 回归
  误报清零)、layout_grid 偏离 2-15px error、gap 不等 warning、无锁
  项目跨页左缘聚类漂移 warning、版式指纹单调门(>=3 同指纹 warn、
  >=4 或过半 error;仅对 NN_ 编号 deck 页聚合)
- 策略纪律:同一版式原型整本 <=2 次 + 标题语义必须被图形兑现

顺手修 comparison_columns 模板胶囊 5px 错位。
新增 tests/test_svg_alignment_check.py 21 项;全量 153 过。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-03 12:16:42 +08:00
..
brands feat(ppt): 加商务红品牌预设 + 配图默认主动提议(bump 0.33.5) 2026-06-30 15:57:52 +08:00
charts feat(ppt): 对齐网格锁+错位/单调质检(d1285247 陶瓷 deck 复盘,bump 0.37.0) 2026-07-03 12:16:42 +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): 对齐网格锁+错位/单调质检(d1285247 陶瓷 deck 复盘,bump 0.37.0) 2026-07-03 12:16:42 +08:00
spec_lock_reference.md feat(ppt): 对齐网格锁+错位/单调质检(d1285247 陶瓷 deck 复盘,bump 0.37.0) 2026-07-03 12:16:42 +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>