Communitygithub.com

CleanExpo/Pi-Dev-Ops

撰寫或擴充 Remotion 合成元件 (.tsx),整合品牌設定、分鏡腳本、佈局規範與動態效果。作為 Sonnet 等級的工作者,在品牌、分鏡、設計與動態語言輸出準備就緒後觸發執行,產出檔案至 remotion-studio/src/compositions/ 並在 src/Root.tsx 註冊。

Pi-Dev-Ops 是什麼?

此技能為 Remotion 合成元件建構器,負責在品牌設定、分鏡腳本、設計語言與動態效果等前置輸出完成後,自動產生或更新 TypeScript 合成檔案。它會檢查目標檔案是否存在,若無則以 Explainer.tsx 為模板建立新元件,並匯入品牌設定 (BrandConfig)、視覺代碼 (design.md) 與動態輔助函式。合成過程會依照分鏡腳本建立多個 <Sequence> 場景,每個場景透過 componentRecipe 解析視覺代碼,避免直接內嵌色碼或字型名稱,確保設計一致性。最後,它會在 Root.tsx 中註冊合成元件,並自動執行型別檢查 (tsc),確保無編譯錯誤。此工具專為 Remotion Studio 工作流程設計,作為 orchestrator 計畫中的第四波任務,適合需要頻繁產生品牌化影片元件的開發團隊。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops/tree/HEAD/skills/remotion-composition-builder

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

remotion-composition-builder

實際執行的元件。讀取所有其他內容,撰寫 TSX。

觸發時機

  • remotion-orchestrator 計畫中的第四波。
  • 使用者要求「為 {主題} 建立合成元件」,且品牌設定與分鏡腳本已備妥。

輸入

從同一工作中先前技能的輸出取得:

  • BrandConfig(來自 src/brands/{slug}.ts)— 執行期與行為:語音、旁白、動態、受眾、頻道、禁用詞彙
  • {slug}.design.md(透過 src/brands/loadDesign.ts 的 loadDesign(slug) 載入)— 視覺代碼:顏色、字型、間距、元件、佈局、高度
  • 分鏡腳本 JSON(來自 remotion-screen-storyteller)
  • 佈局規格(來自 remotion-designer)— 以名稱參考 design.md 代碼
  • 動態區塊(BrandConfig 的一部分)
  • 頻道規格/畫面比例(來自 remotion-marketing-strategist)

請參閱 src/brands/CONTRACT.md 了解 BrandConfig 與 design.md 之間的完整所有權邊界。

方法

  1. 定位合成元件 — src/compositions/{Name}.tsx 是否存在?
    • 是 → 就地修補(保留現有 API)。
    • 否 → 使用 Explainer.tsx 作為模板建立新檔案。
  2. 匯入處理 — 執行期匯入 import { brands } from '../brands',視覺代碼匯入 import { loadDesign, colour, spacing, componentRecipe, typography } from '../design',動態輔助函式從 ../motion 匯入。
  3. 定義結構 — 使用 z.object 定義輸入 props,對應分鏡腳本形狀。
  4. 組合場景 — 每個分鏡腳本場景對應一個 <Sequence>。每個場景元件讀取 cfg = brands[props.brand](用於動態/語音/旁白)與 tokens = loadDesign(props.brand)(用於顏色/字型/間距/元件配方),然後進行組合。使用 componentRecipe(tokens, 'cta-primary') 取得完全解析的 CSS 準備物件,而非內嵌十六進位色碼。
  5. 音訊 — 若路徑有設定,則為每個場景加入 <Audio src={staticFile(scene.voiceoverAudioPath)} />。
  6. 在 Root 中註冊 — 在 src/Root.tsx 中加入或更新 <Composition id="{Name}" ... />。durationInFrames = sum(scene.durationSec) * fps。
  7. 檔案整潔 — 合成檔案 ≤500 行。若超出此限制,將場景提取至 src/compositions/{Name}/scenes/*.tsx。
  8. 型別檢查 — 執行 npx tsc --noEmit。若有錯誤,修正後重試一次。

輸出

編輯的檔案:

  • src/compositions/{Name}.tsx(或場景子檔案)
  • src/Root.tsx(註冊條目)

狀態報告給 remotion-orchestrator:

{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }

邊界

  • 絕不內嵌品牌值(十六進位色碼、字型名稱、間距字面量)— 一律從 tokens(視覺)或 cfg(執行期)讀取。請參閱 CONTRACT.md 了解各側擁有什麼。
  • 絕不設定 durationInFrames 而未將分鏡腳本場景持續時間 × fps 加總。
  • 絕不對不存在的資源路徑使用 staticFile() — 在建置時要大聲失敗,而非在渲染時靜默失敗。
  • 入口動態絕不繞過 signatureEntry() — 保持動態語言一致性。
  • 絕不在 BrandConfig.ts 與 {slug}.design.md 之間重複宣告代碼。若值存在於 .design.md,則 .ts 不得重新宣告。

被重複使用的資源

交接給

remotion-render-pipeline 進行實際渲染。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

CleanExpo/Pi-Dev-Ops

Produce one or many consistent, on-brand faceless marketing videos from a topic: script, ElevenLabs voiceover with timestamps, one styled illustration per beat, ffmpeg stitch to 1080p, optional Unlisted YouTube upload. The look is a named style from styles.md (flat-line, hand-doodle, bold-kinetic, cinematic-photoreal, minimal-corporate, retro-print), so one command yields repeatable output per brand. The automated pipeline; distinct from faceless-video and video-director.

CleanExpo/Pi-Dev-Ops

Produce a faceless YouTube-style video (hand-drawn doodle / simple-illustration channels like Zen, Nick Invest) end-to-end from a single topic. ASKS FACT-vs-STORY mode first (non-fiction educational vs fiction storytelling) and branches the whole run — built to serve multiple clients/channels, not one fixed format. Reverse-engineers a proven reference video's script format, writes a new script in that format, generates an ElevenLabs voiceover with timestamps, creates one styled Artlist (AI Toolkit) image per timestamp, and stitches everything with FFmpeg — fully automated, no human recording. Use when the user says "faceless video", "/faceless-video", "doodle video", "make a YouTube short/long-form in the Zen style", or wants an organic faceless-channel content piece. Composes with video-distribution-strategist (channel/launch) and video-director (when motion/edit polish is wanted instead of stills).

CleanExpo/Pi-Dev-Ops

The 15+ year brand director extension of `brand-guardian` specifically for video — frame-by-frame audit of brand-mark integrity, Gun Metal `#1a1a1a` + Candy Red `#dc143c` consistency, NO AI slop, NO Lucide icons, custom geometric marks ONLY, real logos correctly placed. PASS / FAIL gate before any client-facing video ships. Use after `video-colorist` completes the grade pass.

CleanExpo/Pi-Dev-Ops

The 15+ year Director-of-Photography persona (Roger Deakins / Emmanuel Lubezki / Hoyte van Hoytema-tier) that owns shot composition, lens psychology, motion language, and the decision of which source (Remotion / Hyperframes / stock cinematic) each scene uses. Extends the existing `remotion-designer` + `remotion-motion-language` skills with a frame-by-frame shot-language framework. Use when the user says "cinematography", "shot list", "framing", "DoP", "lens choice", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year colorist persona (Light Iron / Company 3 / The Mill-tier) that applies per-brand LUT + grade pass to every Unite-Group video. Closes the "raw Remotion render colours" gap — today Remotion outputs whatever colours BrandConfig declares with zero cinematic grade. Use when the user says "colour", "grade", "LUT", "look", "cinematic finish", or invoked by `video-director` Phase 3 (post-production) after `video-sound-designer` mixes audio.

CleanExpo/Pi-Dev-Ops

The Creative Director persona that owns brief intake, composition selection and narrative POV for every Unite-Group video. ENTRY POINT for the Video Agency: use for any video creation brief (explainer, promo, social cut, demo reel, case study, testimonial, client video). Dispatches the full production team: script-writer, cinematographer, editor, sound designer, colorist, brand-guardian.

CleanExpo/Pi-Dev-Ops

The 15+ year platform-native distribution expert (early TikTok creator economy + YouTube algorithm + LinkedIn organic reach + IG Reels native specialist) that owns per-platform aspect ratio + duration cap + caption format + hook density + thumbnail composition. Extends `remotion-marketing-strategist` with platform-native specs locked per BrandConfig. Use when the user says "which platform", "distribution", "channel-fit", "thumbnail", "captions", or invoked by `video-director` Phase 4 (QA + Delivery) for per-platform cuts.

CleanExpo/Pi-Dev-Ops

The 15+ year screenwriter persona (Pixar / Apple keynote / Nike spot tier) that engineers hooks (0-3s), retention beats (7-15s), narrative tension curves, and CTA placement. Extends the existing `remotion-screen-storyteller` skill with a structural framework lifted from Pixar's 22 Rules + Apple keynote architecture. Use when the user says "script", "voiceover", "narration", "hook", "story arc", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year sound designer persona (Skywalker Sound / Sound Lounge / Audio Network-tier) that mixes ElevenLabs voiceover with music bed, sound effects, ambient texture, and audio polish. Closes the single biggest gap in the existing Remotion pipeline — today voiceover is the ONLY audio; this skill adds music + SFX + mix. Use when the user says "sound design", "audio mix", "music bed", "SFX", "score this", or invoked by `video-director` Phase 3 (post-production).

CleanExpo/Pi-Dev-Ops

Converts a BrandResearch dossier into THREE artifacts — (1) typed BrandConfig TypeScript at Synthex/packages/brand-config/src/brands/{slug}.ts (runtime/behaviour — voice, voiceover, motion, audience, channel, forbiddenWords); (2) spec-conformant {slug}.design.md at Synthex/packages/brand-config/src/brands/{slug}.design.md (visual tokens — colour, typography, spacing, components, layout, elevation); (3) human-readable 9-section .md projection at Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md derived from BOTH. Boundary contract at Pi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. Triggered after remotion-brand-research, or when the user pastes brand assets and says "codify". PRs are auto-merge:false — a human reviews before merge.

CleanExpo/Pi-Dev-Ops

Researches a portfolio company's visual identity from public sources (homepage, about page, marketing copy, GitHub README) and produces a structured BrandResearch dossier. Triggered when `Synthex/packages/brand-config/src/brands/{slug}.ts` (canonical home per RA-1985 / Synthex SYN-897) is missing, older than 90 days, or the user explicitly says "refresh brand for {brand}". Output feeds remotion-brand-codify.

CleanExpo/Pi-Dev-Ops

Generates a complete, accessible palette (primary, secondary, accent, 4-step neutral, semantic, and dark variant) from one to three hex anchors plus a colour-family classification. Validates WCAG-AA contrast for all text-on-background pairs. Triggered when a BrandConfig has fewer than 5 defined colours or contrast fails.

CleanExpo/Pi-Dev-Ops

Visual-design specialist for Remotion compositions. Sets layout grid, typography hierarchy, white-space, scene framing, and visual rhythm for a given composition + brand. Triggered after remotion-composition-builder for QA, or upfront when authoring a new composition type. Produces a layout spec consumed by remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video needs creative direction — hook, visual sequence, scene purpose, motion restraint, and CTA direction before render.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video has timing, sync, transition, caption, pacing, or audio-fit risk and needs editing discipline before render.

CleanExpo/Pi-Dev-Ops

Use when /remotion-video needs existing Synthex ElevenLabs, brand-config, Remotion, output storage, Claude, or Hermes integration without adding vendors.

CleanExpo/Pi-Dev-Ops

Tunes a video's format and message for the target channel — LinkedIn, YouTube, Instagram Reel, internal training. Sets aspect ratio, total duration, hook timing, CTA timing, and pacing. Triggered when the brief mentions a specific channel or campaign goal. Output feeds remotion-screen-storyteller and remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Designs a brand-specific motion vocabulary — easing curves, default scene durations, signature entry/exit, transition frames. Each brand gets one signature move (rise / sweep / pulse / iris / whip) that recurs across compositions to build motion-recognition. Triggered when BrandConfig.motion is empty.

CleanExpo/Pi-Dev-Ops

/remotion-video one-shot Remotion command skill and ENTRY POINT for the Remotion Skills Package. Use for video, explainer, ad, promo, reel, intro, social cut, marketing, training, or launch videos. Reads the brief, classifies intent, enforces one single Synthex ElevenLabs voice, emits a production/wave plan, and dispatches the right sub-skills in topological order. Always invoked first.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video job needs production gates, render evidence, output discipline, and pass/fail validation before it can be called shippable.

相關技能