摘要：
brag 是一个开源的 Agent 技能项目，能将刚完成的项目自动生成一条带音乐、动效和分享文案的短视频。开发者只需在项目目录输入 /brag 命令，工具便会利用 Hyperframes 引擎自动完成视频剪辑，解决了手动剪辑耗时、缺乏故事重点和撰写分享文案费脑的问题。它主要适合独立开发者、开源维护者、喜欢命令行操作的开发者，以及需要准备产品 demo 或路演素材的人群，帮助他们快速生成可分享的社交媒体宣传视频。
brag 是一个开源的 Agent 技能项目，能把刚做完的项目自动变成一条带音乐、动效和分享文案的短视频。开发者只要在项目目录里输入一条 /brag 命令，剩下的事就交给它和背后的 Hyperframes 引擎，适合那些做完了项目、想快速发一条宣传视频但不想手动剪辑的人。
适合谁
独立开发者 / 开源维护者。 项目刚 push 完，想发条视频到 X、LinkedIn 或产品社区，又不想花一晚上剪视频。 /brag 从项目仓库里自动读取内容，生成一个带音乐和转场的发布视频，省掉剪辑软件的学习成本。
喜欢命令行折腾的开发者。 安装方式全是终端命令，支持 Codex、Claude Code、Cursor、opencode 等主流 AI 编程工具，装完在项目目录直接喊“let's /brag”就行。
在做产品 demo / 路演准备的人。 工具把“项目角度、语气、展示哪个页面”这些叙事决策交给 Agent，输出一个 brag-output/ 文件夹，里面有计划、构图简报、分享文案和最终渲染好的 brag.mp4，相当于给你一条龙备好了路演素材包。
能解决什么问题
手动剪辑视频太耗时。 从录屏到加字幕、配乐、转场，一套下来至少半天。 /brag 把这条流程缩成一条命令，生成 20 秒左右的可分享短视频，适合发社交媒体或作为邮件附件。
不知道视频讲什么重点。 很多人做视频是从“录屏幕”开始，没有故事线。 /brag 会先规划产品角度和语气，把“哪个页面该展示、标题该怎么起”先定下来，再交给 Hyperframes 做时间与渲染。
分享文案懒得写。 视频做好只是第一步，发出去的文案同样费脑。 /brag 会在输出文件夹里附上一份分享文案，拿过来改一改就能发。
怎么开始用
三个主流安装路径，按你用的工具选一个。
Claude Code 安装：
/plugin marketplace add latent-spaces/brag
/plugin install brag@brag
装完在任意项目目录内运行 /brag 即可。插件从 0.4.0 起自带 /brag-slim，用 claude plugin update brag 更新。
Codex 安装：
codex plugin marketplace add latent-spaces/brag
codex plugin add brag@brag
任意支持 Agent Skills 的工具（Cursor、Copilot、Gemini CLI、opencode 等）：
npx skills add https://github.com/latent-spaces/brag --skill brag
加 -g 参数安装到全局，不带则只作用于当前项目。装完后在项目目录对你的 Agent 说：
let's /brag
想调整风格就加参数，比如 /brag --tone "fake Series A launch from 2016"，需要旁白就加 --voice（默认关闭，旁白用的引擎是 Kokoro）。
如果你不想折腾安装，官方还提供了 letsbrag.app，粘贴网站链接就能生成视频，不用装任何东西。
依赖要求： Node.js 22+、FFmpeg 在 PATH 中、Hyperframes CLI（用 npx hyperframes doctor 检查环境）。
优点和坑
优点：
- 全流程自动化：从读取项目到输出
brag.mp4，中间不需要手动操作剪辑软件；输出文件里有计划、简报、文案，一站式交付。 - 兼容面广：不只限 Claude Code，Codex、Cursor、opencode、Gemini CLI 都能通过 symlink 方式识别，安装路径灵活。
- 开源免费：MIT 协议，star 数约 1.9 万（截至 2026-10 数据），社区活跃，GitHub 上有 1508 个 fork。
坑：
- 依赖偏重。 需要 Node.js 22+ 和 FFmpeg，这两个缺一不可。如果你机器上只有一个旧版 Node，得先升级环境。
- Windows 用户有额外门槛。 默认安装依赖 symlink，Git 需要开启
core.symlinks true，系统还得有开发者模式或管理员权限。嫌麻烦只能手动复制skills/brag/目录到 agent 的 skills 目录。 - 默认没有旁白。 视频默认是纯音乐+动效，想要语音讲解要主动加
--voice，而且旁白引擎是通过 Hyperframes 间接调用的，不等于本地离线可用。 - 渲染依赖第三方服务。
/brag负责创意部分，实际的构建、计时和渲染由 Hyperframes（HeyGen 旗下）完成，这意味着渲染环节需要联网调用外部服务，不是纯本地流程。如果你在意隐私或离线运行，这点要先想清楚。
适合你吗
适合： 命令行用得很顺、经常产出小项目、想每条都配条发布视频的开发者；已经在用 Claude Code / Codex 的 AI 编程重度用户，装个插件顺手就能用。
不适合： 完全不碰终端、只想要图形化界面的人；（可以绕过去，用 letsbrag.app 就行）；对视频画质有电影级要求、需要精细控制每一帧的用户；或者部署环境是受限的 Windows 机器、不方便开开发者模式的人。
一句话总结：这是给“动手派”开发者的发布伴侣工具，不是给专业视频团队的完整制作方案。本机环境满足 Node 22+ 和 FFmpeg 的前提下，它能把“项目做完”到“视频发出去”之间的距离压缩到最小。
常见问题
brag 是什么意思？是做什么的工具？
brag 是一个开源的 Agent 技能项目，主要功能是帮助开发者将刚完成的项目自动生成一条带音乐、动效和分享文案的短视频。只需在项目目录输入 /brag 命令，它就能利用 Hyperframes 引擎自动完成视频剪辑，适合想快速发布项目宣传视频但不想手动剪辑的开发者。
brag 工具怎么安装？
安装方式根据你使用的 AI 编程工具选择。例如，在 Claude Code 中运行 /plugin marketplace add latent-spaces/brag 和 /plugin install brag@brag 即可。或者使用 npx 命令：npx skills add https://github.com/latent-spaces/brag --skill brag。需要 Node.js 22+ 和 FFmpeg 环境。
brag 是免费的吗？
是的，brag 是开源免费工具，采用 MIT 协议。截至 2026 年 10 月，其在 GitHub 上已有约 1.9 万 star 和 1508 个 fork，社区活跃。但请注意，其渲染依赖 Hyperframes（HeyGen 旗下）第三方服务，需要联网。
brag 生成视频的准确率和效果怎么样？
brag 能自动规划产品角度和语气，决定展示哪个页面、起什么标题，然后生成约 20 秒的短视频。输出包括计划、构图简报、分享文案和最终的 brag.mp4 文件。但视频默认无旁白（需加 --voice 参数），且渲染画质非电影级，适合快速分享而非精细制作。
brag 和手动剪辑视频比有什么优势？
brag 将手动剪辑需要半天的流程压缩为一条命令，自动生成带音乐、转场的 20 秒短视频，并附上分享文案。它解决了手动剪辑耗时、不知视频重点和懒得写文案的问题，尤其适合独立开发者在项目完成后快速生成社交媒体宣传素材。
相关工具推荐
官方地址，点开新窗口；本文仅为工具介绍，与该项目无隶属关系。
