AIAI 工具图鉴
← 返回全部文章
·约 13 分钟PPT

/brag

检索记忆编程开发技能插件
下载 PPT下载视频

配套媒体

本页对应的 PPT 与演示视频

brag-recommend.mp4
PPT
brag-recommend.pptx浏览器不能直接打开 PPT，下载后用 PowerPoint / WPS / Keynote 查看
下载没反应？点这里复制直链

侧边栏预览窗口（Electron webview）会拦截下载，把下面的链接复制到 Chrome / Edge 地址栏打开即可保存。

PPT../../brag-recommend.pptx
视频../../brag-recommend.mp4
本文目录
  1. 🚀 什么是 /brag？
  2. ✨ 核心功能一览
  3. 🛠️ 快速上手：3 分钟跑通示例
  4. 安装 / 注册
  5. 核心代码示例
  6. 📊 与竞品对比
  7. 💡 适用场景
  8. 场景一：开源项目发布到 GitHub
  9. 场景二：5 个实战 demo 视频（官方 examples）
  10. 场景三：横屏/演示场景默认风格
  11. 用户群体总结
  12. 💰 定价方案
  13. 🎯 总结

📌 核心价值：开源 /brag 技能 — 一行命令把项目代码变成 20 秒精修宣传视频

GitHub 上 746 ⭐ 的 Claude Code 插件，自带 7 种风格预设，5 步交付完成视频+配音+字幕+分享文案。

封面图

🚀 什么是 /brag？

/brag 是开源社区 latent-spaces 团队为 Claude Code（以及 opencode、Codex CLI 等所有兼容 Agent Skills 的 Agent）打造的项目宣传视频生成插件。当你做完一个项目想发推、写 README、发公众号却懒得写文案时，输入一行 /brag，它就会自己扫描你的代码→写脚本→出分镜→调用 Hyperframes 渲染→生成 brag.mp4，并附带一段可复制的分享文案。

GitHub stars GitHub forks

它内置 7 种语气预设（default / polished / yc-parody / chaotic / deadpan / cinematic / app-store），可自由用中文或英文描述额外风格（比如"假装 2016 年的 A 轮融资发布会"、"博物馆展览风格"）。输出格式默认横屏 1920×1080，可切换 9:16 竖屏或 1:1 方图，时长自动控制在 15–25 秒。

核心定位：做完 GitHub 项目只想躺平？/brag 让你的代码 30 秒变成像样的 demo 视频

✨ 核心功能一览

模块 能力 亮点
自动 inspect 扫描项目代码 + README，提取产品定位 无需手动写 brief
7 种语气 default / polished / yc-parody / chaotic / deadpan / cinematic / app-store 适配严肃/搞笑/发布会场景
3 种格式 横屏 16:9、竖屏 9:16、方图 1:1 适配 B站/视频号/小红书
自适应时长 默认 15-25 秒，节奏紧凑不啰嗦 短视频平台秒传友好
自动写分享文案 输出 share-copy.txt，附赠 X/微博/朋友圈三语 直接复制发布
自动配音+配乐 内置 Ende.app 正版授权音乐 + Kenney SFX 无版权风险
多 Agent 兼容 Claude Code、opencode、Codex CLI 不绑定单一工具
工作流可定制 4 步 pipeline：inspect → plan → compose → deliver 节点可单跑

对比传统流程：从写脚本→录屏→剪辑→加字幕→加音乐→配音→导出，传统流程至少 2 小时；/brag 只要 1 行命令

🛠️ 快速上手：3 分钟跑通示例

安装 / 注册

方式 A：插件市场（推荐）

# 在 Claude Code 中执行
/plugin marketplace add latent-spaces/brag
/plugin install brag@brag

方式 B：直接复制 skill

# 不走插件市场，直接拷贝 skill 目录
git clone https://github.com/latent-spaces/brag.git
rsync -a --exclude '.DS_Store' brag/skills/brag/ ~/.claude/skills/brag/
# 重启 Claude Code

前置环境

  • Claude Code / opencode / Codex CLI 任一
  • Node.js 22+
  • FFmpeg（PATH 中可用）
  • Hyperframes CLI：npx hyperframes（自带，无需额外安装）

核心代码示例

一行命令生成视频：

在 Claude Code 中输入：
> let's /brag

或者自定义风格：

> /brag --tone "fake Series A launch from 2016"
> /brag --format vertical --duration 18

自动产出文件结构：

brag-output-2026-05-04-143022/
├── brag-plan.md           # 视频脚本 + 分镜
├── composition/           # Hyperframes 工程文件
├── brag.mp4               # 渲染完成的视频
└── share-copy.txt         # 推特/微博/朋友圈分享文案

注意：Windows 用户需要开启 Developer Mode 或用管理员权限，否则 symlinks 可能创建失败

📊 与竞品对比

维度 /brag 手动剪映 Runway Gen-3 Pika Labs HeyGen
自动读懂项目代码 是 需手动录屏 需手动上传视频 需手动上传视频 需手动写脚本
一行命令交付 是 30+ 步 Web UI 操作 Web UI 操作 Web UI 操作
内置配音+配乐 是 需手动导入 否（无声） 简单音效 内置 TTS
开源免费 MIT 协议 商业订阅 $0.05/秒 $0.05/秒 $24/月起
自定义风格 7 种预设 + 自由描述 仅模板 6 种风格 4 种风格 12 种风格
输出分享文案 自动（X/微博/朋友圈） 手动 否 否 否
适用平台 全部 AI Agent 视频剪辑师 个人创作者 个人创作者 企业定制

对比结论：/brag 是为数不多把"代码 → 视频"全自动化的开源工具

💡 适用场景

场景一：开源项目发布到 GitHub

hero 演示页

功能说明：开源作者首次推到 GitHub/Hacker News 时，最缺的就是"开箱即用的 20 秒演示片"。/brag --format vertical --tone polished 自动生成适合 X、Threads、小红书的竖屏片，无需剪映操作。

输入要求：项目根目录有 README.md + 至少一个 index.html 或可识别入口。

输出效果：15-25 秒竖屏视频，包含产品 Logo、宣传语、3-4 个核心功能点、CTA。

适用场景：

  • ✅ Hacker News "Show HN" 投稿
  • ✅ Product Hunt 提交页
  • ✅ 个人 X/微博品牌账号矩阵

场景二：5 个实战 demo 视频（官方 examples）

fish-flight-school 示例

功能说明：brag 仓库自带 5 个 demo examples（fish-flight-school / horse-tinder / taxi-for-taxis / psychologists-for-chatbots / bicycles-for-snakes），全部由 /brag 自身自动生成。每段都是 15-25 秒，含技术感 + 幽默感的合成演示。

输入要求：每个 demo 都有 index.html 静态页 + PRODUCT.md 产品定义。

输出效果：每个 demo 输出对应的一段 brag.mp4 文件，可直接发布到社交媒体。

适用场景：

  • ✅ 开源演示套件（让用户先看 demo 再装）
  • ✅ 个人作品集 portfolio 视频
  • ✅ 广告创意 A/B test 速度提升 10×

horse-tinder 示例

场景三：横屏/演示场景默认风格

taxi-for-taxis 示例

功能说明：默认的 --tone default 风格会输出玩味、干净、有节奏的横屏视频，适合在演示日、读书会、内部技术分享会开场。

输入要求：项目能运行（即使只爬首页也行）。

输出效果：1920×1080 横屏 + 内置 Ende.app 正版授权 BGM + 自动转场。

适用场景：

  • ✅ Demo Day 5 分钟演讲开场
  • ✅ 技术博客文章 Hero 图替代
  • ✅ 公众号文章头图视频化

用户群体总结

  • ✅ GitHub 开源作者：发版前自动生成 release video
  • ✅ 独立开发者：冷启动 0 粉账号，靠 demo 视频引流
  • ✅ 小团队创始人：用 /brag 替代剪辑外包（500 元/条 → 0 元）
  • ✅ AI 教学博主：把学生作业 demo 化，做成短视频矩阵
  • ❌ 不适合：需要真人出镜的企业宣传片（语义是项目的"产品 demo"而非"人物介绍"）

💰 定价方案

完全开源免费：

MIT License
- 源代码: github.com/latent-spaces/brag
- 安装费: 0 元
- 月费: 0 元
- 订阅: 0 元
- 商业使用: 允许（含商用 Logo 二次开发）

第三方依赖费用：

依赖 用途 费用
Hyperframes 视频渲染引擎 按次计费（$0.1/段）或自带 BYOK
Ende.app 背景音乐 免费 CC-BY（已获授权）
Kenney.nl 音效素材 免费 CC0
Impeccable Demo 站点主题 开源 MIT

新用户福利：自带 5 个 demo 网站（含 PRODUCT.md + index.html）作为学习材料，可直接 fork 改造为自己的项目

🎯 总结

/brag 把"做完项目 → 让别人知道"这件事的全流程压缩到一行命令。对于每周发 1-2 个开源项目、每天发 3-5 条社交媒体短视频的从业者来说，它是把"剪辑外包"成本打到接近 0 的唯一开源路径。

7 种风格预设覆盖从严肃企业发布会到搞笑 App Store 大字体的全光谱；3 种格式适配 X/小红书/微信公众号；自动写分享文案让你发布即用。

推荐指数： ⭐⭐⭐⭐☆（4.5/5）

适合人群：GitHub 活跃开发者 / 独立开发者 / AI Agent 重度用户 / 内容运营矩阵团队

立即体验：brag Launch Site（也由 /brag 自身生成）

GitHub 仓库：latent-spaces/brag

数据截至 2026-07-02，最新信息请以 GitHub 为准。