Communitygithub.com

CleanExpo/Pi-Dev-Ops

将品牌研究档案转换为三个成品:类型化的 BrandConfig TypeScript、符合规范的视觉标记 .design.md,以及面向开发者的九段式 .md 概览。该技能自动执行边界协议,并生成需人工审核的拉取请求。

Pi-Dev-Ops 是什么?

此技能旨在将品牌研究输出成果转化为三个紧密关联的成品,用于 Remotion 工作室和品牌配置仓库。它先验证研究档案是否包含 BrandConfig 所需的所有字段,然后根据边界协议(CONTRACT.md)将其拆分为:运行时和行为配置(语音、画外音、动态等)写入 TypeScript 文件,而视觉标记(颜色、排版、间距等)写入标准化的 .design.md 文件。该技能还会生成一个九段式的人类可读 .md 投影,体现这两个文件的摘要,并包括 lint 检查、字体许可验证以及颜色对比度检查。最后它会创建一个设置了 auto-merge:false 的拉取请求(或本地 diff),以确保在合并前由人工进行审核。该技能在 Synthex 和 Pi-Dev-Ops 仓库之间桥接,适合需要对品牌配置进行严格、可追溯和可分步审查的项目。

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

在你喜欢的 AI 中提问

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

文档

remotion-brand-codify

将研究成果转换为每个组合都能读取的类型化代码。

触发器

  • 在 remotion-brand-research 将档案写入 .research/ 之后。
  • 用户粘贴品牌颜色、字体和语调笔记,并说“codify the {brand} brand”。

输入

  • .research/brand-{slug}-{date}.json(首选)或 markdown 档案
  • 如果存在,现有的 Synthex/packages/brand-config/src/brands/{slug}.ts(用于差异对比)

方法

  1. 验证档案是否涵盖 BrandConfig 的所有必填字段(参见 Synthex/packages/brand-config/src/types.ts)。缺失字段 = 阻止;要求 remotion-brand-research 补充。
  2. 应用边界协议——颜色十六进制码 / 排版比例 / 间距 / 组件 / 布局写入 .design.md;语音 / 画外音 / 动效 / 受众 / 渠道 / 禁用词 / Logo 路径 / 签名写入 .ts。请参见 Pi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md。
  3. 对于每种颜色,如果调色板颜色少于 5 种或在 text on primary 上未通过 WCAG-AA,则通过 remotion-colour-family 运行。该颜色族技能会发出一个 YAML 块,可直接放入 .design.md 的 colors: 部分。
  4. 对于动效,如果 motion 块为空,则通过 remotion-motion-language 运行。
  5. 对于字体,验证许可:仅允许 OFL / Apache / MIT 系列。阻止 Adobe Fonts(不允许服务器端渲染)和付费 Google Fonts。
  6. 发出 Synthex/packages/brand-config/src/brands/{slug}.ts,仅包含运行时字段(根据 CONTRACT.md)。使用 Synthex/packages/brand-config/src/brands/ra.ts 作为规范示例。之后从 Synthex/packages/brand-config/ 运行 npm run build 以重新生成 dist/。
  7. 发出 Synthex/packages/brand-config/src/brands/{slug}.design.md,仅包含视觉标记,采用符合规范的 @google/design.md 格式。使用任何现有的 *.design.md(例如 ra.design.md)作为规范示例。
  8. Lint 检查 design.md——运行 npx --prefix Pi-Dev-Ops/remotion-studio design.md lint Synthex/packages/brand-config/src/brands/{slug}.design.md。遇到错误则阻止。警告是建议性的——仅当未使用的令牌没有语义意图时才修复 unreferenced-token 警告。
  9. 镜像到运行时位置——cp Synthex/packages/brand-config/src/brands/{slug}.design.md Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md。运行时加载器(loadDesign(slug))通过 remotion-studio 中的工作区链接读取 Pi-Dev-Ops 本地副本。
  10. 如果 slug 是新的,则更新 Synthex/packages/brand-config/src/brands/index.ts(并在 types.ts 中扩展 BrandSlug 联合类型)。
  11. 从 .ts 和 .design.md 两者读取,重新生成 Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md 中的人类可读九段式投影。章节 2(颜色调色板)、3(排版)、4(组件)、5(布局)从 .design.md 提取;章节 1、6、7、8、9 从 .ts 和支持性散文提取。

输出

每个品牌三个编辑过的文件:

  1. Synthex/packages/brand-config/src/brands/{slug}.ts——类型化的 BrandConfig(运行时 + 行为,根据 RA-1985 的真实来源)。
  2. Synthex/packages/brand-config/src/brands/{slug}.design.md——视觉标记(真实来源,符合规范的 @google/design.md)。
  3. Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md——九段式人类可读投影(从两者重新生成;切勿手动编辑)。

以及 Pi-Dev-Ops/packages/brand-config/src/brands/{slug}.design.md 处的运行时镜像(#2 的副本——保持同步,直到品牌配置整合移除本地副本)。

九段式 .md 投影是 .ts + .design.md 的一个投影,而不是并列来源。每当任一来源更改时重新生成它;切勿手动编辑。章节顺序是固定的:

  1. 视觉主题与氛围(来自 .ts 语音 + 受众散文)
  2. 颜色调色板与角色(表格镜像 .design.md colors:,如果定义了暗色变体行则包含)
  3. 排版规则(来自 .design.md typography: + 来自 BrandTypography 的族/字重,用于许可追溯)
  4. 组件样式(来自 .design.md components:)
  5. 布局原则(来自 .design.md spacing.outer-margin-* + BrandLogo.safeAreaPx)
  6. 深度与海拔(来自 .design.md 海拔散文)
  7. 应做与不应做(连接 .ts doNot + voice.forbiddenWords + .design.md 的应做/不应做部分)
  8. 响应行为(来自 .ts 的宽高比,每个比例的字体缩放来自 .design.md)
  9. 代理提示指南(一个文字示例,调用 {colors.*} 和 motion.signature 令牌)

加上一个 PR(或本地 diff)总结:

  • 来源档案路径
  • 已填字段与留给创始人审查的字段
  • Lint 状态(design.md lint 错误/警告,字体许可,对比度)
  • 所有三个发出文件(.ts + .design.md + .md 投影)——缺少成品则阻止

边界

  • 始终设置 PR auto-merge:false——品牌语音的细微差别必须由人类审核。
  • 切勿静默覆盖现有文件;生成并排差异。
  • 切勿发明字体或颜色——值来自研究档案,否则默认为中性备用值,并附带 // TODO: founder review 注释。
  • 切勿在 .ts 和 .design.md 之间复制令牌。 如果 colour.primary 存在于 .design.md,则 .ts 不得重新声明它。CONTRACT.md 是仲裁者。
  • 切勿手动编辑 .md 投影——从来源重新生成。

复用

复用工具

  • Synthex/packages/brand-config/src/types.ts —— 模式真实来源(根据 RA-1985)
  • remotion-studio/src/colour/index.ts —— 用于 WCAG 检查的 contrast()
  • remotion-studio/src/design-systems/_library/ —— 138 个供应的参考 DESIGN.md 文件(开放设计,Apache-2.0)。在 .md 投影中最多引用一个作为视觉学派锚点;切勿逐字复制
  • 参考投影:remotion-studio/src/brands/ra.md 是要镜像的规范示例

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

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

/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.

相关技能