异步视界博客
iaieye.com

最近更新

    ↑↓ 选择↵ 打开esc 关闭

    做完就吆喝:/brag 把项目变成 20 秒发布视频,值得抄的是它的『创意法则』

    latent-spaces/brag 拆解:它只负责故事和 brief,渲染交给 HyperFrames;Opus 5.5 上又退化成一个 9KB 的单文件 brag-slim。附适用场景、局限、issue 里的真实坑和可复用的方法论。

    • 视频制作:让 agent … · 4/5
    • 精读
    • 2026.11.08
    • 12 分钟
    • 6,458 字

    思思扬撰写 · AI 协作整理

    类型
    精读
    系列
    视频制作:让 agent 拆视频、做视频
    位置
    第 4 篇 / 共 5 篇
    发布
    2026.11.08
    篇幅
    6,458 字 · 12 分钟
    章节
    9 节
    标签
    • video
    • agent-skill
    • brag
    • hyperframes
    • launch-video

    结论先行

    • 它是什么:一个「故事层」skill。读你的项目代码 → 定创意角度和语气 → 写分镜 → 把 brief 交给 HyperFrames 渲染 → 出 brag.mp4 + 海报帧 + 分享文案。目标 15–25 秒。
    • 它不是什么:不是渲染引擎,不做爆款复刻,不做长视频、教程、口播。它和前两篇的 rea-video、Hypit 不在一层(见工具地图)。
    • 最值得拿走的:不是工具,而是它那套「创意法则」和「先定 hook、再定分镜、再交渲染」的分工。作者自己写得很清楚:它「保持很薄,好让它搭上 HyperFrames 的每次改进」。
    • 对你(独立开发者,要做出来→卖出去):每个产品上线时出一条 20 秒视频,是它最对口的用法。成本是 agent token 加几分钟渲染,不需要生成视频的模型。
    • 要留意:它依赖 HyperFrames,而 HyperFrames 的 skill 名字近期改过(issue #64);Opus 5.5 上它默认切到不依赖 HyperFrames 的 brag-slim,行为和文档里的「完整版」不同。

    它的工作原理

    一、分工:brag 管故事,HyperFrames 管实现

    SKILL.md 把职责划得很清楚:

    谁负责
    /brag产品角度、素材选取、分镜、语气、格式、音频选择、交付预期
    HyperFrames具体的合成结构、动画时序、运行时、lint、渲染

    四步流程,每步都有「门」(gate):

    1. Inspect:读项目代码,回答 9 个问题(它是什么、给谁、卖点、最离谱的一条、视觉钩子、可展示的真实界面/流程、语气、分享文案……)。门:9 个问题都能答。
    2. Plan:写 brag-plan.md,含 hook、2–3 个高光、结尾笑点、视觉识别(精确色值与字体)、逐场景分镜、音频方向。门:场景时长总和 15–25 秒。
    3. Hand off:写 composition brief 交给 HyperFrames。门:npx hyperframes check 零错误。
    4. Deliver:渲染 mp4,挑最好的一帧作海报并烘进视频第 0 帧(这样各平台缩略图都是它),写 share-copy.txt。

    两个细节值得注意:

    • 它读的是代码,不需要线上 URL 或截图。所以颜色、字体能取精确值,界面可以直接复用组件而不是拍屏。
    • 它明确跳过 HyperFrames 自带的「故事线/SPEC.md」流程,用自己的 plan + brief 取代。也就是说,它不是 HyperFrames 的套壳,而是把上游的创意环节替换掉了。

    二、创意法则:真正的「方法论」

    这几条写在 SKILL.md 里,与语气无关,对所有视频生效:

    法则含义
    Short15–25 秒,多一秒要有理由;开口说话也不延长
    Readable靠运动和剪辑提速,不靠让字一闪而过;短标签停约 0.8 秒,句子约每词 0.3 秒
    Specific要像专为这个项目做的,不是任何项目都能套
    Show the thing至少一场戏必须出现真实界面/文案/关键视觉
    No generic SaaS language「Streamline your workflow」直接禁用,用项目自己的话
    The hook is everything前 2 秒决定观众留不留,先规划它
    Funny earns its place笑点来自项目本身的荒诞,不是硬凹

    结构也给了默认形状:Hook(2–3s)→ Reveal(2–4s)→ 2–3 个高光(5–12s)→ 结尾笑点(2–4s),并声明「是起点,不是模板」。

    七种语气预设:default / polished / yc-parody / chaotic / deadpan / cinematic / app-store,各自规定场景数(例如 chaotic 6–8 场、deadpan 3–4 场)、转场和文字风格;也接受自由描述,如 --tone "fake Series A launch from 2016"。

    选项:--format(横/竖/方)、--duration、--no-music、--no-sfx、--title、--voice(旁白默认关,开了用 Kokoro,单一供应商)。

    三、音频:自带素材库

    完整版自带音乐和音效(音乐来自 ende.app,CC BY 4.0;音效来自 Kenney),并有「cue 预设」把重点镜头对齐到节拍。issue #59 指出过它一度没附音乐许可说明,已关闭。

    四、/brag-slim:同一套法则,去掉 HyperFrames

    仓库最近加的 brag-slim 是一份约 9KB 的单文件 skill,README 写它是「为 Opus 5.5 重建的精简版」:没有 HyperFrames,没有打包素材,模型自己用机器上已有的工具(浏览器、编码器)做完故事、画面、声音和渲染。

    和完整版相比:

    /brag(完整)/brag-slim
    渲染HyperFrames模型自己搭
    素材自带音乐/音效库无,音乐由模型合成
    输入项目代码项目代码或网站 URL
    旁白支持 --voice不支持
    创意法则同同(多了「Every frame postable」「Make it alive」)

    在 Opus 5.5 上,/brag 会自动切到 slim,除非你写 --full 或 --voice。这很有意思:一份 9KB 的 prompt 加上更强的模型,替代了一整套依赖链,说明这类 skill 的「脚手架」会随模型变强而变薄。我不确定 slim 的出片稳定性是否和完整版相当,没找到对比。

    它做不到什么

    按仓库自己的文件和 issue,不是我臆测:

    • 只做 15–25 秒的发布视频。 想要 2 分钟的演示、教程、应用审核录屏,它的法则反而是错的。issue #69 就是有人拿它做平台应用审核视频(需要真实录屏、地址栏、完整授权流程,2–3 分钟),指出按法则会产出一条 20 秒动画重建,会被拒,而且重建授权页会失实。提议加一步「先确认视频用途」,仍是 open。
    • 不复刻别人的视频。 它只讲你自己的项目。
    • 不生成真人/实拍画面。 全是 HTML 动画。
    • 依赖运行环境:Node 22+、FFmpeg、HyperFrames CLI(npx hyperframes doctor 自检)。Windows 上它用符号链接做多 agent 发现,需要 core.symlinks 或开发者模式。
    • 项目跑不起来时会降级。 issue #67 提到,Next.js App Router 之类的真实组件离开应用就渲染不了,需要用项目自己的样式表重新编译、手抄组件标记;缺编码器/无头浏览器时要先问你再装。

    网上的相关讨论

    我搜到的比较薄,直说:

    • 没有找到 Hacker News、Reddit 或长篇实测。 能找到的是技能目录(skills.sh、skillsmp、typingmind 等)、几条 TikTok/YouTube Shorts 和几篇二手介绍。
    • 一篇 2026-09-20 的介绍文(scriptxeno)读过仓库和 GitHub 数据,同样没实跑。结论:「早期、小,但真实」「窄而有差异」「值得观察,既不是爆款也不是噱头」。它提到维护者拒绝了一个约 1 万行的重写,理由是要保住「轻量灵活」的版本、避免维护两份真相来源;还指出依赖风险:HyperFrames 停滞或转向,brag 就没有独立价值。
    • 一篇 2026-09-26 的个人笔记(nicolasdeville)也没实跑,计划是「给每个实验项目出 20 秒视频」,最看重的是「它补上了我觉得最难的部分:故事」,并认为这套规则「就算不用 /brag 也值得抄进自己的视频 skill」。该笔记自己标明由 AI 起草。
    • Nous Research 的 Hermes 把它收为 optional skill(hermes skills install official/creative/brag),标注版本 0.4.0(上游已到 0.5.0)。Hermes 页说其安全扫描「目前拦下 HyperFrames 的五个领域 skill 中的四个」,完整路径「尚不可完整安装」,而 slim 没这个依赖。
    • 另有一个托管版 letsbrag.app:README 说贴网站链接就能得 20 秒视频,「无需安装、无订阅」。我没试,也没读到它的条款或限额。

    关于热度的提醒:同一个仓库,2026-09-20 那篇文章记的是约 5,954 星,今天 API 是 20,697 星;还有搜索结果把别处的数字(如 Hermes 镜像页的 25 万)混进来。星数请只当关注度。

    issue 里暴露的真问题

    GitHub 显示 17 个 open 项,含 PR(我列出的前 30 条里,open 的 11 条中 issue 与 PR 各占一部分)。值得读的几条:

    #问题为什么重要
    #66产品若展示人的数据(消息、联系人、粉丝、健康/财务),应展示真实界面+明显的占位数据,不要用库里的真实记录视频是为了公开分享,这些人没同意出镜。自己用时务必留意,尤其是你的项目有演示数据时
    #69先确认视频用途再套法则见上,法则不是万能的
    #67 / #65 / #68slim 在项目不能独立运行、凭肉眼挑静帧会漏问题、竖屏文字避开平台浮层都是出片质量的细节
    #54提议加 /brag-stems:导出音轨分离、两轨混音、带时间码的字幕与提词器反映用户想把成片再交给人做后期
    #51(已关)批量跑 10 个项目的经验:维护一份「每次追加教训」的 living brief;调度者看输出而不是看汇报批量出片的现成做法
    #50(已关)hyperframes check 可能在 0 项对比度检查下通过,oklch 色板会触发这点完整版的门并非完全可靠
    #64(已关)第 3 步引用了新版 HyperFrames CLI 已移除的 skill 名上游改名会打断下游,也是依赖风险的实例

    此外 #56、#53 是安全修补:slim 把抓取到的网页内容当数据而非指令,并规定跳过 .env、密钥文件等不读。这说明「读你整个项目然后做公开视频」这个动作本身有泄密面,它的处理是写进了规则,不是技术隔离。

    它和前两篇的关系

    rea-videoHypitHyperFramesbrag
    层拆解复刻/混剪成片渲染底座创意+分镜,调用渲染底座
    输入别人的视频参考视频+素材HTML你自己的项目
    产物证据链与重制计划成片成片15–25 秒发布视频+文案
    许可证Apache-2.0修改版 ApacheApache-2.0MIT

    它和 HyperFrames 的关系是「上层 skill 复用下层底座」,和 Hypit 的「大而全一体」是两种设计取向:前者薄、可换底座;后者厚、自带全流程。

    你可以怎么用

    1. 直接用:在要上线的产品目录里让 agent 跑 /brag(Opus 5.5 会自动用 slim)。先别设语气,看默认出片,再试 --tone deadpan 或你自己想的描述。先 --format vertical 和 landscape 各出一次,因为投放平台不同。
    2. 跑之前清场:项目里有真实用户数据、内部域名、密钥时,先换成占位(见 #66);它虽然有跳过 .env 的规则,但那是 prompt 约束,不是沙箱。
    3. 只抄方法:把「创意法则」和 Inspect 的 9 个问题抄进你自己的发布流程,即使不出视频,拿来写落地页首屏和 X 发布文案也适用(尤其是「前 2 秒」「具体而非通用」「展示真实界面」)。
    4. 批量:有多个项目要出片,参考 #51 的做法,让调度者验成片(探测 mp4、抽帧)而不是只读子 agent 的汇报。
    5. 别用它:要做教程、长演示、审核录屏、旁白讲解视频时,法则是反的,换用 HyperFrames 原生流程或直接录屏。

    值得吸收的设计

    • 「把创意决定写成规则」:这个仓库的核心资产是约 7 万字符的规则文档(SKILL.md 加 6 份 references)而不是代码。规则可检验(时长总和必须 15–25 秒、停留时间有公式),这点比泛泛说「要好看」强得多。
    • 每步一个门:每一步结束都有一条可检查的完成判据,和你自己的长跑任务写进文件再接续的做法一致。
    • 薄层复用底座:不自己造渲染器,换底座成本低;代价是被上游改名打断(#64)。
    • 随模型变强而退化:slim 的存在本身是一个信号,值得在自己的 skill 里定期问一句「这条规则还需要吗」。

    没覆盖到的

    • 实跑出片的质量、耗时、token 成本:我没跑,仓库和二手介绍里也没有实测数字。
    • letsbrag.app 的限额、条款、出片质量。
    • 完整版与 slim 的出片对比。
    • 知乎、小红书、X 上的中文/英文使用反馈:搜索没有命中,不代表没有。

    来源

    8 条
    系列全部 5 篇
    1. 01一条爆款视频是拍的、生成的还是代码写的?rea-video 用证据链逐镜回答19 分钟
    2. 02用 agent 做视频该选谁:从 Hypit 到 HyperFrames,按手里有什么分五类15 分钟
    3. 03代码写出来的动画16 分钟
    4. 04做完就吆喝:/brag 把项目变成 20 秒发布视频,值得抄的是它的『创意法则』12 分钟
    5. 07为什么它用代码建的 3D 模型能这么好:拆解 ESCAPEMENT 的建模手法28 分钟