Spec Layer Upgrade

從舊版 layout catalog,升級成可跨 PPTX / 圖片 / HTML 共用的投影片規格系統

現在這個專案的重心,不再是單次 prompt 組裝,而是先定義一份媒介無關的 slide spec。 先決定這頁在做什麼、內容骨架是什麼、視覺約束有哪些,最後才交給 renderer。

5 核心層級:theme、layout、design elements、content、validation
66 目前已整理的 layout 骨架數量
30 theme 數量,涵蓋科技、報告、品牌、作品集、活動、campaign、product strategy、sales proposal、operating review、customer lifecycle、enablement operations、learning community、advocacy network、ecosystem civic 與 mission governance 等方向
143 已獨立命名的 reusable design elements
總覽
這一區快速說明目前這套系統的組成方式,讓你一打開網站就知道哪裡是 source of truth,哪裡是輔助展示。
Layer 01
Theme

定義整份 deck 或單頁的共通視覺世界觀。`2A` 是 visual base,`2B` 是 decoration system。

theme.visual_base theme.decoration_system
Layer 02
Layout + Constraints

先描述版面架構,再補上對齊、主從、空間與視覺排他性規則,而不是只記錄座標。

title_alignment_mode visual_budget_rules prompt_translation_rules
Layer 03
Content Taxonomy

把「這頁在做什麼」和「內容長什麼樣」拆開。page role 管工作,content pattern 管內容骨架。

page_role content_pattern
Core Spec
單頁 slide spec 現在長這樣
slide_id page_role content_pattern page_goal theme_ref layout: strategy_id module_style title_alignment_mode content: title subtitle body visual constraints: content_safe_zone alignment_rules balance_rules visual_exclusivity_rules visual_budget_rules prompt_translation_rules decoration_application renderer_notes validation
Validation
檢查層已先建檔

目前先把檢查語言標準化,不假裝已經有自動檢測器。之後可接人工審查、程式檢查或模型自評。

not_checked manual_review_pending passed failed
Taxonomy
page role 用來判斷一頁在 deck 中扮演什麼角色;content pattern 用來判斷這頁的內容數量與關係,像是你一直在意的 `1+3` 骨架。
Why this matters
先判斷工作,再判斷骨架

同樣都是三個重點,`speaker_intro`、`framework_explainer`、`takeaway` 的語氣、視覺密度與主角關係都不一樣。 所以頁面角色和內容骨架不能混成同一層。

Pattern bias
內容骨架不是版型,但它會影響版型選擇

例如 `1-plus-3` 會偏向三欄等權、三模組、或一個標題搭配三個 feature; `1-plus-sequence` 則更自然地走流程圖、時間線、箭頭串接。

Library
這一區總結目前已落成的 reusable library。重點不是模板數量本身,而是哪些骨架與構件已經被正式命名,可以被後續 renderer 共用。
Layouts
高頻骨架已擴到 66 種

除了原本的封面、章節、左右圖文、四象限,現在已補進目錄、quote、photo grid、gantt、team、SWOT、journey、org、process flow、KPI / dashboard / table、problem-solution / recommendation / priorities、case study / findings / annual highlights、onboarding / workshop / learning module、media kit / campaign / event recap、competitive landscape / maturity / GTM motion、proposal / pricing / battlecard、account planning / pipeline review / QBR、customer success / adoption / renewal、implementation / education / partner enablement、field readiness / certification / community learning、advocacy / ambassador / community ops、ecosystem / ambassador metrics / volunteer ops,以及 membership / donor lifecycle / governance committee 類頁型。

toc-number-grid quote-focus photo-grid-gallery customer-journey org-structure process-flow kpi-scorecards dashboard-overview comparison-table problem-solution-bridge recommendation-stack strategic-priorities case-study-proof findings-cluster annual-highlights onboarding-path workshop-run-of-show learning-module media-kit-overview campaign-architecture event-recap-storyboard competitive-landscape maturity-ladder go-to-market-motion proposal-value-stack pricing-packages battlecard-compare account-plan-brief pipeline-health-review business-review-rhythm customer-success-plan adoption-journey renewal-readiness implementation-rollout-map customer-education-track partner-enablement-kit field-enablement-readiness certification-ladder community-learning-loop advocacy-program-map ambassador-journey community-ops-rhythm ecosystem-relations-map ambassador-metrics-board volunteer-ops-cadence membership-value-journey donor-engagement-lifecycle governance-committee-model investor-update-brief team-bulletin brand-guideline-core annual-meeting-brief fundraising-campaign-brief association-member-update
Themes
theme 不再只剩科技風

新增的 theme 已涵蓋 grainy editorial、clinical report、soft organic education、paper collage、warm editorial portfolio、executive analytics、strategy consulting、impact report、facilitation / learning、brand activation、product strategy signal、sales conversion、operating review、customer lifecycle、enablement operations、learning community、advocacy network、ecosystem civic,以及偏 mission / stewardship / oversight 的 mission governance 方向。

grainy-editorial clinical-report paper-collage-vintage warm-editorial-portfolio executive-analytics strategy-consulting impact-report facilitation-learning brand-activation product-strategy-signal sales-conversion operating-review customer-lifecycle enablement-operations learning-community advocacy-network ecosystem-civic mission-governance
Design Elements
構件語彙正式獨立

把 node card、connector、reporting line、stage chip、avatar frame,外加 metric / decision / evidence / facilitation / external communication / pitch strategy / sales enablement / review cadence / customer lifecycle / enablement operations / learning community / advocacy community / ecosystem operations / stewardship governance 類構件都從 theme / layout 中抽出,避免每次重寫 prompt 才臨時描述。

node-card connector-arrow reporting-line stage-chip avatar-frame metric-card delta-badge chart-frame problem-badge recommendation-rank priority-tier proof-stat quote-callout milestone-card session-chip checkpoint-badge support-anchor reach-stat channel-pill offering-card cta-ribbon positioning-axis competitor-marker maturity-rung motion-lane value-pill roi-badge package-column objection-counter health-score-chip risk-flag stakeholder-strip action-owner-badge success-milestone adoption-signal renewal-timeline churn-risk-chip phase-checkpoint curriculum-band partner-toolkit-card activation-cta readiness-meter credential-badge peer-loop graduation-check advocate-role-chip listening-node engagement-loop story-signal ecosystem-node reach-bar coverage-badge support-queue-tag member-stage-band value-moment-chip committee-pillar oversight-loop
Round 01
第一輪網路觀察補的是 smart layouts

參考 Beautiful.ai / Gamma / Slidesgo 後,先補高頻的 photo grid、gantt、team、SWOT,讓系統不只會做封面與圖文頁。

Round 02
第二輪補的是商務骨架與結構件

journey、org、process flow 都屬於中段解釋頁的高頻骨架;而 design elements 則是為了避免 theme 越寫越肥、renderer 越來越難對應。

Round 03
第三輪補的是 reporting / KPI / dashboard

這一輪開始補 review、benchmark、週報、QBR 會真的用到的數據頁,讓版型庫不只會講故事,也能承載密度更高的商務資訊。

Round 04
第四輪補的是顧問式論證頁

problem-solution、recommendation、strategic priorities 這些頁型,讓系統開始具備提案、說服與決策推進的骨架,而不只是資訊整理。

Round 05
第五輪補的是證據展示與回顧頁

case study、research findings、annual highlights 這些頁型,讓系統開始具備成果證明、研究摘要與年度回顧的結構語法。

Round 06
第六輪補的是教學帶領與 onboarding

onboarding path、workshop run-of-show、learning module 這些頁型,讓系統可以更自然地支援課程、內訓、工作坊與新進導入場景。

Round 07
第七輪補的是品牌對外溝通與活動敘事

media kit overview、campaign architecture、event recap storyboard 這些頁型,讓系統開始更自然地支援品牌介紹、campaign 結構整理、活動回顧與 CTA 收束場景。

Round 08
第八輪補的是 pitch / product / transformation 中段骨架

competitive landscape、maturity ladder、go-to-market motion 這些頁型,讓系統可以更自然地表達市場定位、成熟度上升與成長動作機制,而不是退回 generic 三欄卡片。

Round 09
第九輪補的是 proposal / pricing / sales enablement

proposal value stack、pricing packages、battlecard compare 這些頁型,讓系統可以更自然地支援提案成交、方案比較與業務應對,而不是把所有商務頁都塞回一般表格。

Round 10
第十輪補的是 account / pipeline / QBR 節奏頁

account plan brief、pipeline health review、business review rhythm 這些頁型,讓系統可以更自然地支援客戶經營、漏斗檢視與季度回顧,而不是把它們混成普通 dashboard 或 recap。

Round 11
第十一輪補的是 customer success / adoption / renewal

customer success plan、adoption journey、renewal readiness 這些頁型,讓系統可以更自然地支援 onboarding 到續約的完整 lifecycle,而不是一直借用 generic process 或 QBR 頁。

Round 12
第十二輪補的是 rollout / education / partner enablement

implementation rollout map、customer education track、partner enablement kit 這些頁型,讓系統可以更自然地支援導入落地、教學路徑與夥伴啟用,而不是一直借用 generic process 或單一 learning module。

Round 13
第十三輪補的是 field / certification / community learning

field enablement readiness、certification ladder、community learning loop 這些頁型,讓系統可以更自然地支援 readiness、認證進程與持續社群學習,而不是只剩一般 training 與 agenda。

Round 14
第十四輪補的是 advocacy / ambassador / community ops

advocacy program map、ambassador journey、community ops rhythm 這些頁型,讓系統可以更自然地支援 outreach、倡議者培育與社群營運節奏,而不是只剩 generic community 或 campaign 頁。

Round 15
第十五輪補的是 ecosystem / ambassador measurement / volunteer ops

ecosystem relations map、ambassador metrics board、volunteer ops cadence 這些頁型,讓系統可以更自然地支援 network 關係、program 成效解讀與志工營運,而不是只剩 org chart、generic KPI 或 event schedule。

Round 16
第十六輪補的是 membership / donor journey / governance

membership value journey、donor engagement lifecycle、governance committee model 這些頁型,讓系統可以更自然地支援會員成長、捐助關係維繫與治理架構頁,而不是一直借用 generic process、org chart 或一般三欄卡片。

檢查層
這一層現在先做成模板與紀錄欄位,目的不是宣稱已經會自動判斷,而是先讓每張投影片未來都有一致的驗收語言。
Result template
每張投影片未來都可以附一份 validation 結果
validation: status: manual_review_pending checks: safe_zone_check: pass | fail alignment_check: pass | fail overlap_check: pass | fail readability_check: pass | fail notes: - 哪裡侵入邊界 - 哪組元素沒對齊 - 哪些文字過小
Legacy 版型資產
舊網站的 SVG 預覽我沒有丟掉,而是保留成參考層。它們現在比較像「視覺資產庫」,不再是唯一的規格來源。
舊版型 catalog 的價值還在,但定位改了:它現在提供版型靈感與過去資產,不再直接代表新版 YAML 規格的完整結構。
版面原則
這些是最近正式抽象出來、而且已經寫回 spec 的原則。目標就是避免你說的那種「東補西補」。
Principle 01
側邊插圖不能反客為主

若一頁是文字主導加側邊插圖,插圖只能支撐敘事,不能壓縮主標題與正文的閱讀空間。 這條規則已進入 `visual_budget_rules`。

Principle 02
標題系統只能明確置中或明確左錨定

若標題置中,主標與副標必須共用中心線;若標題置左,就必須和主內容模組左緣共線。 不允許半漂浮狀態。

Principle 03
單側主插圖時,另一側不建立第二視覺主體

這不是單純「不要 icon」,而是更高階的視覺排他原則: 如果右側已有主插圖,左側文字區不能再長出另一個可獨立辨識的主角。

Principle 04
不要把機械座標直接餵給圖片模型

spec 可以保留結構化位置,但 image prompt 必須翻成自然空間語言。 不然像 `x=8%` 這種字真的可能被畫進去。