Communitygithub.com

CleanExpo/Pi-Dev-Ops

创建或扩展一个绑定品牌配置、故事板、布局规范和动效的 Remotion 组件 (.tsx)。这是一个实际的构建技能,作为 Sonnet 级别的工作节点运行。在品牌、故事板、设计人员和动效语言输出准备就绪后触发。文件生成在 remotion-studio/src/compositions/ 下,并在 src/Root.tsx 中注册。

Pi-Dev-Ops 是什么?

该技能是 Remotion 视频合成工作流的核心执行者,负责将品牌配置、故事板、布局规范和动效语言等前期产出物,实际生成为一个可运行的 Remotion 组件 (.tsx)。它作为一个智能工作节点(Sonnet 级别)运行,在“编曲者”计划的第四波自动触发,或者当用户提供了已知的品牌和故事板信息后,手动请求构建指定主题的组件时被调用。技能严格遵循模块化设计:从 `BrandConfig` 和 `design.md` 中分别读取运行时行为和视觉令牌,并优先复用项目中已有的模板和辅助函数。它不仅能创建全新的组件文件,还能智能地在现有文件上打补丁,并自动完成组件在 `src/Root.tsx` 中的注册。该技能强制执行一系列最佳实践,例如禁止硬编码品牌值、动态计算视频总时长、检查资源路径有效性,并对生成的文件大小进行约束(超过500行时自动提取场景为子文件)。所有这些操作都在一次类型检查(`npx tsc --noEmit`)的循环中完成,确保输出代码的健壮性。最终,它会向编曲者返回一个包含变更文件列表和类型检查结果的状态报告。

兼容平台~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-组件构建器

执行者。读取所有其他输出,写入 TSX。

触发器

  • remotion-orchestrator 计划的第四波。
  • 用户请求“为 {topic} 构建一个组件”,且品牌和故事板信息已知。

输入

全部来自同一任务中先前技能的输出:

  • 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. 定义 Schema —— 为匹配故事板形状的属性创建 z.object。
  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。
  • 永远不要在不将故事板场景持续时间总和乘以 fps 的情况下设置 durationInFrames。
  • 永远不要对不存在的资源路径使用 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.

相关技能