Communitygithub.com

CleanExpo/Pi-Dev-Ops

/remotion-video 一鍵命令技能,也是 Remotion Skills Package 的進入點。用於製作影片、解說片、廣告、宣傳片、短影音、片頭、社群剪輯、行銷、培訓或上市影片。讀取簡報、分類意圖、強制使用單一 Synthex ElevenLabs 語音、產出製作/波動計畫,並以拓撲順序調度正確的子技能。一律優先喚起。

Pi-Dev-Ops 是什麼?

這是一個專為 Remotion 影片製作設計的 AI 代理技能 — CleanExpo/Pi-Dev-Ops,作為 Remotion Skills Package 的單一進入點。它將自由文本的簡報轉換為結構化的生產包裹和波動計劃,並強制執行一系列嚴格規則:只能使用單一 Synthex ElevenLabs 語音、以乾執行(dry-run)模式啟動、寫入統一的生產文件和報告、永遠不提交生成的 MP4。此技能適用於 Claude Code、Cursor 等支援技能定義的平台。它的工作方式是先通過一個強制性的發現簡報關卡(Discovery Brief Gate)來鎖定需求,確保 brand、composition、channel、durationSec、topic 和 audience 等必要欄位都已填寫完整且明確,然後調度最多 8 個子技能(如 remotion-brand-research、remotion-screen-storyteller、remotion-composition-builder 等)以優化的波動順序執行。每個波動可以包含並行或串聯的技能,根據影片長度限制波動數量以防止過度分解。最終輸出包含波動計劃 JSON、腳本、預檢報告和渲染命令。此外,還整合了 Linear 任務追蹤和 Canva 縮圖生成,確保從規劃到產出的完整流程。

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

在你喜歡的 AI 中提問

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

說明文件

remotion-orchestrator — Remotion Skills Package 進入點

/remotion-video 一鍵命令

/remotion-video 是 Remotion 行銷影片的一鍵命令通道。它將粗略的簡報轉換為一個受控的生產包裹、一個渲染路徑和一份最終的證據報告。

此命令路徑的嚴格規則:

  • 僅限單一語音;不允許多語音演員或每場景語音切換。
  • 僅使用現有的 Synthex ElevenLabs 憑證和語音配置。
  • 不引入新的供應商、新帳戶或連接平台。
  • 除非操作員明確要求生產渲染,否則從乾執行(dry-run)開始。
  • 寫入 .harness/remotion/<jobId>/production-packet.json、script.md、preflight-report.md 和 render-command.sh。
  • 永不提交生成的 MP4。

此命令路由經由 remotion-script、remotion-production、remotion-direction、remotion-editing、remotion-integrations 和 remotion-professionalism,同時保留下方現有的 Remotion Skills Package 工作流程。

Remotion Skills Package 的單一進入點 — 一組 10 個同級技能(remotion-orchestrator、remotion-brand-research、remotion-brand-codify、remotion-designer、remotion-colour-family、remotion-motion-language、remotion-screen-storyteller、remotion-marketing-strategist、remotion-composition-builder、remotion-render-pipeline),全域安裝在 ~/.claude/skills/remotion-*(符號連結至 ~/Pi-Dev-Ops/skills/remotion-*)。可在每個專案中使用,不限於 Pi-Dev-Ops。

發現簡報關卡(第 1 回合,強制)

改編自 nexu-io/open-design(Apache-2.0)。在發出任何波動計劃之前,鎖定簡報。拒絕繼續直到所有必要欄位都已填寫 — 模糊的簡報會產生過長的波動計劃和偏離品牌的渲染。

必要欄位

欄位類型備註
brandBrandSlug必須在 src/brands/ 中解析。未知 → 先調度 remotion-brand-research。
compositionExplainer | Intro | SocialAd | NIRReport | ProductDemov1 支援 Explainer;其他則以附註回退。
channellinkedin | youtube | instagram | tiktok | training驅動長寬比 + 時長紀律。
aspectRatio1920x1080 | 1080x1920 | 1080x1080若省略,則從 channel 推斷預設值。
durationSec15 | 30 | 60 | 90 | 120驅動波動數量上限。
topic字串一句話說明影片內容。單純「品牌認知影片」會被拒絕 — 必須指出具體要點。
audience字串若省略,則從 BrandConfig.audience.primary 繼承,但創始人必須確認。

可選:school(顏色產生器的視覺學派覆寫)、voiceoverScript(若預先編寫則跳過說書人)、referenceComposition(現有任務用於混音)。

硬停止條件

  • topic 讀起來像分類(「我們的產品」、「上市」)而非具體主張 → 阻擋。
  • v1 中 composition ≠ Explainer 且未明確確認回退 → 阻擋。
  • 一份簡報命名多個品牌 → 分割為 N 個平行任務(每個品牌一個);從不混合品牌。

關卡在波動計劃計算之前執行。被封鎖的簡報永遠不會到達調度器。

喚起方式

使用者可透過以下方式喚起此套件:

  • 說出任何下列詞語:「使用 Remotion Skills Package」、「remotion 套件」、「使用 remotion」。
  • 命名任何個別技能(例如「使用 remotion-designer 對這個佈局進行 QA」)。
  • 提交一個經由 app/server/brief.py 分類為 intent: "video" 的簡報。

將自由文本簡報轉換為結構化的渲染任務和波動計劃,由 Pi-Dev-Ops 協調器(app/server/orchestrator.py)透過 P3-B 扇形展開調度。

Remotion 專案

所有 composition、品牌設定、動作/色彩輔助工具及渲染進入點都位於:

../../remotion-studio/

從任何其他專案工作時,子技能會在讀取或編輯 composition / 品牌檔案前先 cd 到該路徑。渲染進入點是從 remotion-studio 目錄內執行 npx tsx render/render.ts ...。

觸發條件

簡報包含以下任何詞語:video、explainer、promo、ad、reel、intro、outro、cta、social cut、60s/30s/15s、render、marketing video、training video、release video、feature video,並搭配以下任一品牌識別碼:dr / disaster recovery / nrpg / ra / restoreassist / carsi / ccw / carpet cleaners warehouse。

輸入

Pi-Dev-Ops 規劃器(Opus 4.7)以以下參數調用此技能:

  • brief — 原始自由文本請求
  • repo_url — 通常為 local:Pi-Dev-Ops/remotion-studio
  • linear_team_id、linear_project_id — 從 config/harness/projects.json 預先解析

輸出

一個波動計劃 JSON,寫入 remotion-studio/.research/wave-plans/{job_id}.json,結構如下:

{
  "jobId": "ra-nir-explainer-2026-04-28T15-30-00",
  "brand": "ra",
  "composition": "Explainer",
  "channel": "linkedin",
  "durationSec": 60,
  "topic": "RestoreAssist NIR Phase 1 standardisation",
  "linear": { "teamId": "...", "projectId": "..." },
  "outputPath": "output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
  "waves": [
    { "id": 1, "parallel": [ {"skill":"remotion-brand-research","if":"brands/ra.ts missing or stale"}, {"skill":"remotion-marketing-strategist"} ] },
    { "id": 2, "parallel": [ {"skill":"remotion-screen-storyteller"}, {"skill":"remotion-colour-family","if":"palette incomplete"}, {"skill":"remotion-motion-language","if":"motion missing"} ] },
    { "id": 3, "parallel": [ {"skill":"remotion-brand-codify","if":"any new brand artifacts"}, {"skill":"remotion-designer"} ] },
    { "id": 4, "serial":   [ {"skill":"remotion-composition-builder"}, {"skill":"remotion-render-pipeline"} ] }
  ]
}

波動數量紀律

  • 輸出 <30s 時 ≤3 個波動
  • 輸出 ≤120s 時 ≤5 個波動
  • 輸出 >120s 時 ≤8 個波動

過度分解是此規則防止的錯誤模式。

Composition 路由(簡報 → composition id)

簡報訊號composition
"explainer"、"feature video"、"how it works"Explainer
"intro"、"title card"、"channel opener"Intro(v1.1)
"ad"、"promo"、"reel"、"social cut"、"Instagram"、"TikTok"SocialAd(v1.1)
"NIR report"、"inspection report"、RA + "report"NIRReport(v1.1)
"demo"、"product walkthrough"ProductDemo(v1.1)

v1 僅支援 Explainer。其他 composition id 返回:"{Composition} 將在 v1.1 提供 — 回退為 Explainer 並使用頻道特定的框架"。

品牌解析

比對關鍵字 → BrandSlug:

  • disaster recovery、dr → dr
  • nrpg → nrpg
  • restoreassist、ra、nir → ra
  • carsi → carsi
  • ccw、carpet cleaners warehouse → ccw

若簡報命名多個品牌,請規劃器分割為 N 個平行任務(每個品牌一個)並發出 N 個波動計劃。從不混合品牌為一個 composition。

Linear 路由

渲染技能寫入 MP4 後,此技能(或渲染技能)在對應於 config/harness/projects.json 的專案中開啟一個 Linear 任務:

品牌Linear 團隊專案
raa8a52f07-63cf-4ece-9ad2-3e3bd3c15673(RA)3c78358a-b558-4029-b47d-367a65beea7b
dr / nrpg43811130-ac12-47d3-9433-330320a76205(DR)d2c1d63b-1e85-424d-9278-efff15b0d46b
carsi91b3cd04-...(GP)執行時解析
ccw執行時執行時

縮圖與靜態圖片生成(Canva 優先 — 請勿尋找憑證)

對於影片縮圖、海報或任何行銷靜態圖片,可靠路徑是已連結的 Canva MCP,而不是原始圖片生成 API 金鑰:

  1. generate-design(design_type: your_story 用於 9:16,youtube_thumbnail 用於 16:9),附上詳細的品牌對齊查詢 — 在查詢中傳遞色板/標題;Canva 能可靠地渲染標題文字。
  2. 下載候選預覽並選取最佳;create-design-from-candidate → export-design(PNG 格式,指定 WxH,export_quality: pro)。

嚴格規則(從 2026-07-01 的經驗學到):

  • 永遠不要尋找圖片生成金鑰。 不要在跨專案/環境中掃描 .env 檔案或執行 vercel env pull 以尋找 GEMINI_API_KEY / OPENAI_API_KEY / AI_GATEWAY_API_KEY。自動模式分類器會將其封鎖為憑證探索,並浪費整個會話。
  • Vercel 的「敏感」環境變數是唯寫的 — vercel env pull 返回的內容為空。不要嘗試拉取一個;請從原始來源取得值,或使用 Canva。
  • 如果沒有連結任何圖片工具,且在一次定向檢查中找不到金鑰,請停止並向創始人詢問一次 — 直接提供 Canva。
  • 從渲染的 MP4 中擷取畫格(捆綁的 ffmpeg 位於 node_modules/@remotion/compositor-*/ffmpeg)是離線備援方案。注意:在 macOS 上,將同級目錄中的 *.dylib 檔案符號連結到目前工作目錄,以便捆綁的 ffprobe/ffmpeg 能正確解析(SIP 會移除 DYLD_* 環境變數)。

此技能不做的事

  • 不編寫 composition — 那是 remotion-composition-builder 的工作。
  • 不執行 npx remotion render — 那是 remotion-render-pipeline 的工作。
  • 不編輯 BrandConfig 檔案 — 那是 remotion-brand-codify 的工作。

它僅負責規劃 + 委派。

每個專案的使用模型

此套件是共享基礎設施;每個呼叫端專案提供自己的執行時期設定和 API 金鑰。

關注點位置
技能定義~/.claude/skills/remotion-*(符號連結 → Pi-Dev-Ops/skills/remotion-*)— 全域可用。
Remotion Node 專案(compositions、品牌設定、渲染進入點)../../remotion-studio/ — 單一共享基底。
品牌設定Synthex/packages/brand-config/src/brands/{slug}.ts — 每個品牌單一事實來源,由每個為該品牌渲染的專案使用。(根據 RA-1985 / Synthex SYN-897 從 Pi-Dev-Ops/remotion-studio/src/brands/ 遷移。)
API 金鑰(ElevenLabs、Telegram、Supabase、Linear、Remotion 授權)呼叫端專案的 .env / .env.local。技能在渲染時讀取 process.env。
渲染的 MP4 輸出預設為呼叫端專案的 .remotion-renders/ 目錄。使用 --out= 覆寫。

為你的專案新增品牌

如果你的專案(例如 Synthex)需要為尚未在 src/brands/ 中的品牌進行渲染:

  1. 針對品牌的公開來源執行 remotion-brand-research。
  2. 執行 remotion-brand-codify 以產生 Synthex/packages/brand-config/src/brands/{slug}.ts。
  3. 在 Synthex/packages/brand-config/src/types.ts 中擴展 BrandSlug 聯合型別。
  4. 在 Synthex/packages/brand-config/src/brands/index.ts 中註冊。
  5. 從 Synthex/packages/brand-config/ 執行 npm run typecheck(然後執行 npm run build 以重新產生 dist/)。

目前已註冊的品牌:dr、nrpg、ra、carsi、ccw、synthex、unite。

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

Authors or extends a Remotion composition (.tsx) wired to BrandConfig + Storyboard + layout spec + motion. The actual builder skill — runs as a Sonnet-tier worker. Triggered after brand, storyboard, designer, and motion-language outputs are ready. Produces the file under remotion-studio/src/compositions/ and registers it in src/Root.tsx.

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

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

相關技能