remotion-designer
主掌外觀。不是文字(由 storyteller 負責),不是動態(由 motion 負責),不是建構(由 composition-builder 負責)——就是外觀。
觸發時機
remotion-orchestrator在草案組合達到第 3 波時觸發。- 正在撰寫新的組合類型(例如 v1.1+ 的
Intro、SocialAd等)。 - 渲染失敗,需進行設計審查(偏離品牌、難以辨識、過於擁擠)。
輸入
brandSlug——用於讀取BrandConfig(執行階段,透過brands[slug])以及{slug}.design.md(視覺標記,透過loadDesign(slug))compositionId——Explainer|Intro|SocialAd| …aspectRatio——1920x1080|1080x1920|1080x1080storyboard(選用)——用於調整文字區塊大小- 現有組合檔案(若是在審查現有組合)
方法
依序套用以下規則。每當某個值來自品牌的設計系統時,請以 design.md 標記的名稱來參照(例如 {spacing.outer-margin-landscape}、{typography.display-xl}、{colors.primary}),而不是直接寫出像素值——remotion-composition-builder 會在構建時解析。
- 網格 ——12 欄。外邊距:1920×1080 使用
{spacing.outer-margin-landscape},1080×1920 使用{spacing.outer-margin-portrait}。安全區域:{spacing.safe-area}(預設為 5%)。 - 字型階層 ——從品牌的 design.md 字型比例尺中選取。角色對應到比例尺的階層:
- 標題 / CTA 英雄區 →
{typography.display-xl} - 主體標題 →
{typography.display-md}或{typography.headline} - 主體文字 →
{typography.body-lg}或{typography.body-md} - 說明文 / 小標 →
{typography.caption} - 程式碼 / 識別標籤 →
{typography.mono-md}或{typography.mono-lg}(若有定義)
- 標題 / CTA 英雄區 →
- 顏色應用 ——英雄區背景:
{colors.primary}。CTA 填充:強調 CTA 使用{colors.accent},次要 CTA 使用{colors.secondary}。主體文字:若文字位於已知背景上,選取on-{role}標記(例如{colors.on-primary});否則退一步使用colour/readableOn()以確保 WCAG-AA 對比度。 - 元件槽位 ——當佈局使用到已識別的元件(CTA、卡片、單色晶片、信號晶片、價格標籤、網路徽章)時,請輸出
{component: cta-primary}並讓componentRecipe()在構建時解析完整設定。若有現成的配方,請勿發明臨時樣式。 - 留白 ——每個文字區塊上方與下方至少要有
0.5 × 字型大小的垂直呼吸空間。 - Logo 放置 ——左上角或右下角,切勿置中。安全區域 =
BrandConfig.logo.safeAreaPx(保留在.ts中,由 motion 強制執行)。
輸出
兩個成品:
- 一份佈局規格 JSON,寫入
.research/design/{compositionId}-{brandSlug}.json,其值以{slug}.design.md標記的名稱來參照(例如{ "outer-margin": "{spacing.outer-margin-landscape}", "hook-type": "{typography.display-xl}" })——內文不含像素值或十六進制色碼。 - 對組合的 TSX 進行內嵌編輯(若是在審查現有組合)。
寫完佈局規格後,請執行 npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md,以確認佈局中參照的每個標記都存在於品牌的 design.md 中。lint 錯誤會導致封鎖;警告僅供參考。
5-D 評論關卡(輸出佈局規格前強制執行)
此關卡採用自 nexu-io/open-design(Apache-2.0 授權)。透過 opus-adversary 模式生成一個 Opus 4.7 子代理,從五個正交維度對提議的佈局進行評分,每個維度 0-10 分,並附上引用證據。將評分表寫入 .research/design/{compositionId}-{brandSlug}.critique.json,與佈局規格放在一起。
維度
- 哲學一致性 ——此佈局是朝著單一方向(例如科技實用性、編輯單色風)發展,還是混合了三種風格?請引用具體元素。
- 視覺階層 ——陌生人能否在不被告知的情況下,判斷出閱讀的優先順序(第一/第二/第三)?請引用最大的元素 vs. 最重要的元素。
- 細節執行 ——對齊、行距、大尺寸字距、圖像構圖、邊緣情況的間距。請引用具體畫面。
- 功能性 ——在目標渠道上是否有效?垂直 9:16 的標題在手機上是否可讀?CTA 是否在安全區域內?請引用畫面編號與尺寸。
- 創新性 ——是否存在一個意料之外、但為簡報所賦予的動作出現,還是完全千篇一律?是否存在一個非必要但能鎖定識別度的強調手法?請引用該動作。
分數區間
0-4 損壞 · 5-6 可用 · 7-8 優秀 · 9-10 卓越。請勿分數膨脹——平均分高於 8 分需懷疑;請再次確認。
通過 / 失敗
- 通過:每個維度 ≥ 6,且平均分 ≥ 7。
- 失敗:任一維度 ≤ 5,或平均分 < 7。返回
remotion-composition-builder,附上每個維度的「保留/修正/速勝」清單,待修改後重新執行關卡。 - 覆寫:創辦人可透過明確訊息(「直接發佈」)強制通過。覆寫記錄會寫入
.research/design/{compositionId}-{brandSlug}.critique.json,附上時間戳記與原因。
重複使用模式
使用 opus-adversary 技能——相同的 Opus 4.7 子代理生成方式,相同的引用證據紀律。請勿編寫平行的評論框架。
邊界
- 切勿覆寫
BrandConfig的值——請透過remotion-brand-codify提出變更建議。 - 切勿在佈局中使用動畫(不要在懸停時縮放文字)——那是
remotion-motion-language的範疇。 - 每個場景最多使用 3 種顏色;第三種顏色僅保留給強調色使用。
交接對象
remotion-composition-builder 會使用這些佈局規格並加以套用。