Connectors

Connectors

【免费下载链接】OpenMontageWorld's first open-source, agentic video production system. 12 production pipelines, 100+ tools, 700+ agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage

HeyGen Video Agent

Feedstyle_prompt_fullas the visual style block. Usemotion.transitionsfor scene cuts. Orientation: landscape.

HTML Slides

Map colors to CSS variables. Usetypography.displayfor h1-h3.

### 5.2 `## Design Principles`——设计哲学 自由书写驱动该视觉系统的信念、有意的取舍： ```markdown ## Design Principles Typography drives hierarchy. Color is used sparingly and intentionally. Every element snaps to a baseline grid. White space is a feature.

5.3## Extraction Notes——提取来源记录

当风格是从既有设计提取而来时，记录来源 URL、日期与关键决策：

## Extraction Notes Extracted from https://example.com on 2026-03-12. Primary colors sampled from hero section. Typography identified via browser dev tools.

6. 完整示例：瑞士国际主义风格

规范文档给出了一份完整的示例文件，这也是画廊中最典型的案例——"Josef Müller-Brockmann Swiss International Style"（references/gallery/mueller-brockmann-swiss.visual-style.md）：

--- name: "Josef Müller-Brockmann Swiss International Style" version: "1.0" tags: - iconic design - sleek minimal author: "Bin" source_url: "" created: "2026-03-12" style_prompt_short: > Grid-locked Swiss precision. Black and white base with electric blue accent. Helvetica only. Data visualizations as hero elements. style_prompt_full: > Josef Müller-Brockmann Swiss International Style. Grid-locked layouts with mathematical precision. Black and white base with ONE accent color (electric blue #0066FF). Strong diagonal compositions. Helvetica typography only. Data visualizations are the hero — animated charts, counters, grids. Every frame snaps to a grid. Transitions are horizontal grid wipes. No organic shapes. No gradients. No stock photography. Everything is geometric, systematic, precise. colors: primary: - name: "Pure Black" hex: "#000000" role: "dominant ground, text, structural elements" - name: "Pure White" hex: "#FFFFFF" role: "background fields, negative space" accent: - name: "Electric Blue" hex: "#0066FF" role: "the ONE accent — data highlights, key emphasis" neutral: - name: "Grid Gray" hex: "#CCCCCC" role: "grid lines, secondary structure" typography: display: family: "Helvetica" weight: "bold" style: "uppercase or sentence case, tight tracking" body: family: "Helvetica" weight: "regular" style: "flush left, ragged right, generous leading" caption: family: "Helvetica" weight: "light" style: "small, uppercase, wide tracking" rules: - "Helvetica ONLY — no other typeface" - "Type sizes follow a mathematical scale" - "Always flush left — never centered" layout: grid: "Strict modular grid — 12 columns" alignment: "Flush left, grid-snapped" aspect_ratio: "16:9" notes: - "Every element locked to the grid" - "Data visualizations are the hero elements" motion: transitions: - "horizontal grid wipes" - "elements snapping to grid positions" - "clean hard cuts" animation_style: > Geometric precision. Elements snap to grid positions. Charts animate systematically. Nothing bounces. pacing: "Measured, confident, unhurried" mood: keywords: - "precise" - "systematic" - "authoritative" - "geometric" era: "1950s–1970s (timeless)" cultural_reference: "Müller-Brockmann, Grid Systems in Graphic Design" avoid: - "organic or curved shapes" - "gradients" - "stock photography" - "centered text" - "decorative elements" assets: reference_images: [] gsep_elements: [] html_snippets: [] color_palette_image: url: "" ---

6.1 示例中的字段协同分析

这份示例展示了完整字段如何协同工作：

• style_prompt_full把结构化的约束全部用自然语言复述了一遍——包含具体 hex（#0066FF）、唯一字体（Helvetica）、转场方式（horizontal grid wipes）、反模式（No organic shapes / No gradients / No stock photography）——即使某工具只读取这一个字段，也能还原出全部设计意图；
• mood.avoid与style_prompt_full中的否定句一一对应，形成了"结构化反模式"与"自然语言反模式"的双保险；
• layout.aspect_ratio: "16:9"直接服务于后续视频/幻灯片应用的画幅设定；
• 画廊版本在此基础上还扩充了第 4 个中性色Dark Gray #333333（辅助文字/次级标签）、typography.rules中的第 4 条 "Weight contrast does the hierarchy"、layout.notes中的对角线构图说明，以及mood.avoid中更多的反模式（如 "handwritten or serif typefaces"、"drop shadows or glows"、"rounded corners"），可见画廊文件比规范示例更加收敛风格边界。

7. 校验规则与版本策略

7.1 Validation：五条合法性校验

一份合法的visual-style.md必须满足：

1. ---分隔符之间是合法 YAML frontmatter；
2. 所有必填字段齐全（name、version、style_prompt_short、style_prompt_full、colors.primary）；
3. colors.primary至少包含 2 个颜色对象；
4. 每个颜色对象都包含name、hex、role三个键；
5. version必须为1.0。

这套校验直接支撑了 SKILL 中 Extract 模式的第五步"Validate — Ensure all required fields are present"，也保证了画廊与模板文件的互操作性。

7.2 Versioning：version指规范版本而非风格版本

需要特别澄清：version字段描述的是格式规范的版本，而不是某个具体风格的版本号。规范变更时的处理策略：

• 次要变更（新增可选字段）：版本保持1.0；
• 破坏性变更（必填字段变化）：版本升级到2.0。

这意味着只要读取方支持1.0，就能安全地忽略它不认识的可选字段与x_*扩展，向后兼容性由版本策略背书。

8. 设计决策解读：格式背后的四条理由

规范最后专门用一节解释关键设计决策，理解这些决策有助于写出更合规的文件：

8.1 为什么style_prompt_full是必填的？

很多 AI 工具只接受文本提示词。通过强制要求一段完整的自然语言风格描述，确保每一份visual-style.md都能被任何工具立即使用——即使它不解析结构化字段。这是"AI-consumable"目标的核心保障。

8.2 为什么不内嵌二进制数据？

URL 让文件保持小巧、可版本化、可移植。二进制资产（参考图、叠加元素、HTML 片段）应托管在外部，通过 URL 引用。

8.3 为什么用x_*命名空间？

不同工具能力不同。x_前缀允许写入工具专属配置（如x_heygen、x_figma、x_paper），既满足工具特定需求，又不污染核心 schema——对应最佳实践中的 "Opinionated defaults, flexible extensions"。

8.4 为什么要有mood.avoid？

负面约束与正面约束同等重要。告诉 AI 不要做什么，往往比告诉它做什么更有效。这解释了为什么style_prompt_full中总会出现成串的 "No ..." 句式。

9. 实战扩展：模板、连接器与画廊

格式规范的最终价值体现在 Create / Extract / Apply / Gallery 四类用法中。以下文件均位于 .agents/skills/visual-style/ 目录。

9.1 Create：两份可直接套用的模板

• 最小模板 minimal.visual-style.md：只含必填字段，用于快速产出合法文件；
• 完整模板 full.visual-style.md：覆盖全部可选字段，每个字段都带注释说明意图，是手工编写的最佳起点。它甚至预留了x_heygen.video_id与x_figma.library_id的占位示例。

9.2 Apply：连接器如何消费格式

Connectors 把visual-style.md的字段翻译成目标工具的指令，这反过来验证了规范字段设计的实用性：

HeyGen Video Agent 连接器（connectors/heygen-video-agent.md）将style_prompt_full原样追加进生成提示词，motion.transitions作为场景转场指令，layout.aspect_ratio决定画幅（16:9 = landscape，9:16 = portrait），mood.avoid转成排除项，x_heygen.orientation作为显式画幅覆盖。其提示词模板结构为：

Create a video about [TOPIC]. Script: [USER'S SCRIPT] Visual style: [PASTE style_prompt_full HERE] Additional constraints: - [ITEMS FROM mood.avoid] Motion: - Transitions: [motion.transitions] - Pacing: [motion.pacing] - Animation: [motion.animation_style] Format: [layout.aspect_ratio OR x_heygen.orientation]

【免费下载链接】OpenMontageWorld's first open-source, agentic video production system. 12 production pipelines, 100+ tools, 700+ agent skill and production-knowledge files. Turn your AI coding assistant into a full video production studio.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMontage