Communitygithub.com

childelins/feishu-pi-bridge

在创建、编辑、动画或渲染任何视频、动画或动态图形(包括宣传片、讲解视频、带字幕片段、标题卡、叠加层、幻灯片/互动演示或任何合成)时,请先阅读此技能。HyperFrames 从 HTML 渲染视频;此入口技能是代理撰写或编辑视频的默认方式。它将请求路由到正确的专用工作流,并指向 HyperFrames 领域技能,因此在猜测工作流之前,请先阅读此技能,而不是其他视频或动画技能。

feishu-pi-bridge 是什么?

HyperFrames 是一个从 HTML 渲染视频的框架。此技能是 HyperFrames 的入口点,用于将任何“帮我制作一个……”的请求路由到适当的工作流。它提供了领域技能(如 `/hyperframes-core`、`/hyperframes-animation`、`/hyperframes-creative`)和端到端工作流(如 `/product-launch-video`、`/website-to-video`、`/faceless-explainer`)的能力地图。代理使用此技能来避免猜测工作流:它会根据输入(例如,URL、脚本、GitHub PR、现有素材、音乐轨道)来确定应使用哪个专用工作流,并将请求路由到该工作流。该技能还确保工作流技能按需安装,使用 `npx hyperframes skills update <workflow-name>` 命令,并处理输入歧义(例如,销售产品与展示网站、添加字幕与设计叠加层)。当没有项目 CLAUDE.md 或 AGENTS.md 描述视频工作流时,此技能至关重要。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/childelins/feishu-pi-bridge/tree/HEAD/pi/agent/skills/hyperframes

在你喜欢的 AI 中提问

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

文档

HyperFrames — 从这里开始

HyperFrames 从 HTML 渲染视频 — 一个合成是一个 HTML 文件,其 DOM 使用 data-* 属性声明时间安排,其动画运行时是可寻的,且其媒体播放由框架拥有。完整的创作合约位于 /hyperframes-core 中;在编写合成 HTML 之前,请先阅读它。

以下是:能力地图(按需加载的领域技能)和意图路由器(为任何“帮我制作一个……”请求选择工作流 — 通常是视频,但也包括可导航的演示文稿或合成端口)。这种划分是基于所有权,而非输出类型:工作流拥有端到端的可交付物(其自己的项目目录、分步步骤、子代理、最终产物);领域技能是工作流中途拉入的能力层,从不拥有任务。

能力地图 — 领域技能

您按需加载的原子能力 — 不是完整的工作流;它们从不拥有端到端任务。对于“帮我制作一个……”的意图,请使用下面的意图路由器。

您想……技能
创作/编辑 HTML 合成 — data-* 合约、片段、轨道、子合成、变量/hyperframes-core
制作动画 — 原子运动、场景蓝图、过渡、运行时适配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
创作可寻安全关键帧 — GSAP 时间轴、CSS 关键帧、Anime.js、WAAPI、FLIP、路径、蒙版、SVG 变形/绘制、3D 深度,以及 hyperframes keyframes 诊断/hyperframes-keyframes
创意指导 — frame.md / design.md、调色板、字体排印、旁白、节拍规划、音频反应/hyperframes-creative
媒体 — 解析/生成 BGM、SFX、图像、图标、品牌标志、语音;TTS 配音、转录、背景移除、字幕;跨项目复用/media-use
CLI 开发循环 — 初始化、lint、验证、检查、预览、渲染、发布、诊断/hyperframes-cli
安装注册表块/组件(hyperframes add)/hyperframes-registry
导入 Figma 内容 — 资源、令牌、组件、故事板→重构运动(REST/CLI);Motion(MCP)、着色器(MCP 源/原生导出)/figma

意图路由 — 选择工作流

此部分只知道顶级工作流;它不加载它们的内部引用或上面的领域技能。

路由之前 — 确认输入,而非规格

路由需要知道视频的内容 — 其输入和主题。如果未指定(“制作一个关于我们产品的视频”,没有 URL、产品、主题或资源),请在进入任何工作流之前询问 — 承诺工作流本身就是路由决策。最多问两个问题:

  • 输入 — 一个产品(URL / 简报)、一个通用网站、一个 GitHub PR、一个要解释的主题,或一个现有的讲话视频?
  • 模式 — 如果请求带有持续的自主信号(“给我惊喜”、“你决定”、“直接做吧”),请注意它并将其传入工作流:整个运行过程变为自主,后续步骤不再询问。如果没有信号,工作流会在其第一个简短问题中询问模式。默认为协作模式。(/motion-graphics 默认是自主的。)语义:hyperframes-core → references/brief-contract.md。

规格默认值 — 陈述,不要询问(它们从不改变路由):宽高比从目标派生 — 社交信息流(X / LinkedIn / Instagram)→ 方形 1:1,TikTok / Reels / Shorts → 9:16,YouTube / 嵌入 / 未知 → 16:9;旁白/字幕语言 = 用户的。所选工作流会在其第一步重新确认自己的具体细节(字段语义:hyperframes-core → references/brief-contract.md)。

工作流速查表

工作流用于
/product-launch-video销售产品(SaaS、应用、公司/产品网站) — 从 URL、简报或脚本 → 一个宣传片。任何商业 URL 的默认选项,即使只提到了网站名称。
/website-to-video展示网站本身 — 基于网站自身截图构建的游览/展示。适用于非商业网站(作品集、博客、文档、个人、活动),或者当用户想要一个游览,而不是宣传片时。
/faceless-explainer解释一个主题/概念 — 从文本开始;没有产品,没有 URL;所有视觉内容由 LLM 生成
/pr-to-video一个 GitHub PR / 代码变更 → 变更日志/功能展示/修复/重构讲解视频
/embedded-captions为现有的讲话视频添加字幕/副标题(不修改素材本身)
/talking-head-recut将现有的讲话视频与设计的图形叠加层打包 — 下三分之一、数据标注、动画标题、引文突出显示
/motion-graphics一个短的(~10 秒以下)、无旁白的片段,其中运动本身就是信息 — 动态文字、统计/图表高亮、标志动画、动画地图、动画推文/标题、一个独立的下三分之一/叠加层(MP4 或带透明通道)
/music-to-video一个音乐轨道 → 一个节拍同步的视频 — 歌词视频、幻灯片或动态宣传片;音乐驱动节奏(可选的用户图像/视频按节拍网格剪辑)
/slideshow一个演示文稿/推介 Deck/交互式 Deck — 独立幻灯片、片段、分支、热点;输出是一个可导航的Deck,而非渲染视频
/general-video其他所有情况 — 较长或多场景的片段、静态循环/海报、自定义合成
/remotion-to-hyperframes将现有 Remotion(React)合成移植到 HyperFrames(迁移,而非创建)

消歧(仅在可能混淆时):

  • 运动优先且无旁白(~10 秒以下,运动本身就是信息)→ /motion-graphics,无论输入是什么。
  • 一个 URL 或脚本 — 问一件事:该网站是在销售产品吗? 是(SaaS / 应用 / 产品 / 公司网站)→ /product-launch-video — 一个宣传片,并且是任何商业 URL 的默认选项,即使只提到了网站名称。否,或者用户只想原样展示网站(作品集 / 博客 / 文档 / 个人 / 活动)→ /website-to-video — 一个游览。一个 GitHub PR 链接 → /pr-to-video;一个没有产品或网站的概念 → /faceless-explainer。
  • 现有素材 — 纯口语字幕 → /embedded-captions;设计好的叠加卡片 → /talking-head-recut。两者都不修改素材本身(重新定时/重新着色/重新构图/重新排序/音频是 NLE 编辑 — 超出范围)。
  • 音乐轨道是输入(一个音频文件,或一个提取音频的视频),并且没有旁白 → /music-to-video — 音乐的节拍/能量驱动节奏。(有旁白的片段仍然使用上面与输入匹配的工作流;/motion-graphics 用于短的、非音乐驱动的无旁白运动。)
  • 一个演示文稿/推介 Deck/交互式 Deck(独立幻灯片、导航、演示者模式)→ /slideshow — 输出是一个可导航的 Deck,而非渲染视频。明确的“幻灯片”请求直接进行;相邻的触发词(“Deck / 幻灯片 / 演示文稿 / 转换此页面”)会使 /slideshow 在创作之前确认它是一个幻灯片,如果不是,则切换到适当的非幻灯片工作流。
  • 时长是指南,而非限制 — 意图选择工作流;只有当片段明显超过 ~3 分钟,或者是静态/循环/自定义格式时,才转到 /general-video。

选择后 — 确保工作流已安装

一旦您选择了工作流,请在阅读其技能之前运行更新步骤 — 工作流技能按需安装,因此您匹配的工作流可能尚未安装在此机器上(其触发短语正是存在于这个路由器中,以便您可以路由到尚未安装的技能):

npx hyperframes skills update <工作流名称>

仅限名称,没有前导 / — 例如 npx hyperframes skills update pr-to-video。指定技能名称可确保它以及每个工作流依赖的核心领域技能都已安装且是最新的:如果一切已就绪,则快速无操作;如果缺少/过时,则仅安装缺失/过时的技能 — 从不是完整集合。然后阅读工作流的技能并继续。相同的命令适用于按需从能力地图安装领域技能(例如 npx hyperframes skills update figma)。

如果命令失败,请将错误信息展示给用户,而不是凭记忆临时拼凑工作流。手动回退(没有 HyperFrames CLI 可用):npx skills add heygen-com/hyperframes --skill <工作流名称>;一次性安装所有:npx skills add heygen-com/hyperframes --all。

保持技能最新

HyperFrames 技能是版本化的,并且惰性安装:核心集急切安装,工作流在首次使用时安装。

  • 核心集 — 此路由器、hyperframes-* 领域技能和 media-use。npx hyperframes init(每个创建型工作流在搭建时都会运行)会检查 GitHub 并刷新核心集以及任何其他已安装的技能。它从不_扩展_安装 — 您未使用过的工作流技能不会被拉取。在最新的机器上重新运行 init 是无操作的;离线(或受速率限制)时,它会优雅降级,从不会硬性失败。--skip-skills 标志当前被禁用(这是临时措施,等待 skills.sh 注册表跟上);CI/测试通过 HYPERFRAMES_SKIP_SKILLS=1 环境变量选择退出。
  • 工作流技能 — 在上面的更新步骤(skills update <工作流名称>)中安装和刷新。

如果任务行为异常,或者在长时间构建之前,请确认已安装的技能是最新的:

  • 检查: npx hyperframes skills check(添加 --json 以获得机器可读的判定;当任何已安装的技能已过时或核心集不完整时,退出码为非零 — 尚未安装的工作流技能会报告为可按需使用,而不是失败)。
  • 更新: npx hyperframes skills update — 刷新核心集以及所有已安装的技能到最新版本,并移除不再发布的技能。不带名称时,它永远不会安装您尚未使用过的工作流;指定技能名称(skills update <名称…>)会额外安装这些技能。
  • 显式完全集: npx hyperframes skills(或 npx skills add heygen-com/hyperframes --all)。

当 render / lint / validate 运行检测到过时的技能时,CLI 还会显示一行提醒。

工作流详情

/product-launch-video

  • 输入: 正在营销的产品 — (a) 产品 URL(使用无头 Chrome 抓取资源 + 品牌令牌),(b) 命名了产品网站的脚本/简报,即使没有链接(PLV 解析并抓取它,除非用户选择退出),或 (c) 没有可推导网站/“不要抓取”的脚本(无抓取模式 — 选择一个提供调色板+设计系统的样式预设)。提供的脚本可以是逐字配音或按场景重组 — PLV 会询问。
  • 输出: 一个产品发布/SaaS 宣传片作为 HyperFrames 合成 → MP4(最佳时长 30–90 秒)— 产品的价值是主题,而不是网站的步行导览。对于纯网站游览,请使用 /website-to-video。
  • 触发器: “X 的发布视频”、“我们网站的宣传片”、“在一分钟内解释我的 SaaS”、“将我的脚本变成 60 秒宣传片”、“纯文本发布视频,不要抓取”。

/website-to-video

  • 输入: 一个网站/URL,其目标是展示网站本身,而非销售产品。最适合非商业网站(作品集、博客、文档、个人、活动),或者当用户明确想要一个原样游览网站时。使用无头 Chrome 捕获真实截图 + 品牌资源。如果输入是……

相关技能