Communitygithub.com

CleanExpo/Pi-Dev-Ops

专为 Remotion 合成设计的视觉设计专家。为给定的合成和品牌设置布局网格、排版层级、留白、场景构图和视觉节奏。

Pi-Dev-Ops 是什么?

该技能是 Remotion 合成工作流中的视觉设计专家,负责定义“外观”而非文案或动画。它在合成编排器推进到第 3 阶段、创建新的合成类型(如 Intro、SocialAd)或渲染因设计审查失败时被触发。核心流程包括:读取品牌配置(BrandConfig)和设计令牌文件(design.md),按顺序应用 6 条规则生成布局规范——12 列网格、排版层级、颜色应用、组件插槽、留白和 Logo 位置。所有像素值必须引用设计令牌(如 `{spacing.outer-margin-landscape}`),而非直接写出具体数值。输出包括一个布局规范 JSON 文件和可选的 TSX 内联编辑,并通过 `design.md lint` 验证令牌存在性。此外,技能强制要求在输出布局规范前通过一个五维批判门禁(哲学一致性、视觉层级、细节执行、功能性、创新性),使用 `opus-adversary` 子代理进行评估,只有所有维度 ≥6 且均分 ≥7 才能通过。支持的平台包括 Claude Code、Cursor 和 Codex 等 AI 代理工具。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

remotion-designer

负责外观。不是文字(故事编写者),不是动作(动画师),不是构建(合成构建者)——而是外观。

触发器

  • remotion-orchestrator 进入第 3 阶段,并提供一个草稿合成。
  • 正在创作新的合成类型(Intro、SocialAd 等,适用于 v1.1+)。
  • 渲染因设计审查失败(不符合品牌、难以辨认、过于拥挤)。

输入

  • brandSlug — 用于读取 BrandConfig(运行时,通过 brands[slug])和 {slug}.design.md(视觉令牌,通过 loadDesign(slug))
  • compositionId — Explainer | Intro | SocialAd | …
  • aspectRatio — 1920x1080 | 1080x1920 | 1080x1080
  • storyboard(可选)— 用于确定文本块大小
  • 现有合成文件(如果是对现有合成进行质量审核)

方法

按顺序应用这些规则。每当某个值来自品牌的设计系统时,按名称引用 design.md 令牌(例如 {spacing.outer-margin-landscape}、{typography.display-xl}、{colors.primary}),而不是直接给出像素字面量——remotion-composition-builder 将在构建时解析。

  1. 网格 — 12 列。外白边:{spacing.outer-margin-landscape} 用于 1920×1080,{spacing.outer-margin-portrait} 用于 1080×1920。安全区域:{spacing.safe-area}(默认 5%)。
  2. 排版层级 — 从品牌的 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}(如果已定义)
  3. 颜色应用 — 主视觉背景:{colors.primary}。CTA 填充:{colors.accent} 用于强调色 CTA,{colors.secondary} 用于次要 CTA。正文文本:当文本位于已知表面时,选择 on-{role} 令牌(例如 {colors.on-primary});否则回退到 colour/readableOn() 以确保 WCAG-AA 对比度。
  4. 组件插槽 — 当布局使用已识别的组件(CTA、卡片、单色芯片、信号芯片、价格标签、网络徽章)时,发出 {component: cta-primary},让 componentRecipe() 在构建时解析完整属性包。不要为已有配方存在的组件发明临时样式。
  5. 留白 — 每个文本块上下方至少保留 0.5 × 字号 的垂直呼吸空间。
  6. Logo 放置 — 左上角或右下角,切勿居中。安全区域 = BrandConfig.logo.safeAreaPx(保持在 .ts 中,由动画强制执行)。

输出

两个工件:

  1. 一个布局规范 JSON,写入 .research/design/{compositionId}-{brandSlug}.json,其值引用 {slug}.design.md 中的令牌名称(例如 { "outer-margin": "{spacing.outer-margin-landscape}", "hook-type": "{typography.display-xl}" })——不允许内联像素字面量或十六进制颜色代码。
  2. 对合成 TSX 的内联编辑(如果是在质量审核)。

写入布局规范后,运行 npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md 以确认布局中引用的每个令牌都存在于品牌的 design.md 中。阻止 lint 错误;警告仅供参考。

5 维批判门禁(在发出布局规范前强制执行)

采用自 nexu-io/open-design(Apache-2.0)。通过 opus-adversary 模式生成一个 Opus 4.7 子代理,对建议的布局在五个正交维度上打分,每个维度 0–10 分,并附带引用证据。将裁决结果写入 .research/design/{compositionId}-{brandSlug}.critique.json,与布局规范放在一起。

维度

  1. 哲学一致性 — 布局是否坚持一个方向(例如技术实用主义、编辑视角)还是融合了三种风格?引用具体元素。
  2. 视觉层级 — 陌生人能否不被告知就判断出阅读顺序第一/第二/第三?引用最大的元素与最重要的元素。
  3. 细节执行 — 对齐、行距、大字号字距、图像构图、边缘间距。引用具体帧。
  4. 功能性 — 在目标渠道上是否有效?9:16 竖屏主视觉在手机上可读吗?CTA 在安全区域内吗?引用帧编号 + 测量值。
  5. 创新性 — 一个出人意料且由简报支撑的举动,还是 100% 常规?一个非必需但锁定品牌识别的强调色?引用该举动。

评分区间

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 消费布局规范并应用它。

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

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.

相关技能