brag开发者指南:如何扩展和定制你的视频生成技能
【免费下载链接】bragYou built it. Now brag. Turn the project you just created into a short, shareable launch video with one command.项目地址: https://gitcode.com/gh_mirrors/brag1/brag
brag是一款强大的Claude Code技能,能将你创建的项目通过一个命令转换为简短、可分享的启动视频,包含音乐、动画和分享文案。本指南将帮助开发者深入了解如何扩展和定制brag的视频生成能力,打造独具特色的项目展示视频。
了解brag的核心工作流程
brag的视频生成过程分为四个主要步骤,每个步骤都为扩展和定制提供了可能性:
- 项目检查:自动扫描项目目录,提取关键信息以规划视频内容
- 规划与故事板:创建创意方案和分镜头脚本,确定场景、文本、时间和音效提示
- 交给Hyperframes处理:将创意方案转换为视频实现
- 验证、渲染和交付:生成最终视频、海报和分享文案
brag核心功能展示:一键将项目转换为启动视频
定制视频风格:掌握七种内置基调
brag提供七种预设基调,每种基调会改变脚本能量、节奏、排版风格和过渡效果。通过--tone参数可以轻松应用这些基调:
| 基调 | 能量特点 | 适用场景 |
|---|---|---|
default | 活泼、简洁、适合发布 | 通用场景,展现良好氛围 |
polished | 严肃、优雅 | 非玩笑性质的正式项目 |
yc-parody | 冷静的创业风格 | 荒诞项目的伪严肃展示 |
chaotic | 快速、响亮、激进 | 夸张和不受约束的展示 |
deadpan | 平静、枯燥、低调 | 以严肃方式呈现幽默内容 |
cinematic | 戏剧化、预告片规模 | 大场面、大宣称的展示 |
app-store | 流畅、功能卡片式简洁 | 企业级但不乏味的展示 |
要自定义基调,可以在调用时提供创意方向,如:/brag --tone "2016年虚假A轮融资风格"。
Horse Tinder示例展示了app-store基调的应用效果
扩展音频体验:音乐与音效定制
音频是视频体验的重要组成部分,brag提供了丰富的音频定制选项:
音乐选择与配置
brag内置了多个"Happy Beats / Business Moves"系列音乐轨道,适用于不同基调:
happy-beats-business-moves-vol-1.mp3:全节奏高能轨道,适合default和app-store基调happy-beats-business-moves-vol-9.mp3:中等能量,适合default和yc-parody基调happy-beats-business-moves-vol-10.mp3:紧凑循环,适合default和chaotic基调happy-beats-business-moves-vol-11.mp3:温暖商务风,适合yc-parody和app-store基调happy-beats-business-moves-vol-12.mp3:稳定简洁,适合polished和cinematic基调
要添加自定义音乐,可将音频文件复制到brag-output/composition/assets/music/目录,然后在HTML中引用:
<audio id="bg-music" />Fish Flight School示例中的音频效果增强了视觉体验高级定制:创建自定义故事板模板
要实现高度定制化的视频,你可以创建自己的故事板模板。故事板文件位于输出目录的brag-plan.md中,包含场景描述、文本、时间和转场效果。
以下是一个自定义故事板的示例结构:
# brag-plan.md ## 创意角度 极简主义展示,突出核心功能,使用冷色调和简洁动画 ## 故事板 Hook (2s) → 产品展示 (5s) → 核心功能演示 (10s) → 号召性用语 (3s) ### Scene 1: Hook (0:00-0:02) - 文本: "革命性的项目展示方式" - 动画: 淡入效果 - SFX: impact/impactBell_heavy_000.ogg at 0.1s ### Scene 2: 产品展示 (0:02-0:07) - 文本: "Fish Flight School" - 动画: 缩放效果 - SFX: interface/drop_001.ogg at 0.25s
你可以根据项目需求,创建不同的故事板模板,然后在调用brag时指定使用哪个模板。
自动化扩展:使用脚本分析音乐提示
brag提供了一个Python脚本用于分析音乐提示,位于skills/brag/scripts/analyze_music_cues.py。你可以使用这个脚本来为自定义音乐生成提示 metadata:
uv run --project skills/brag/scripts \ python skills/brag/scripts/analyze_music_cues.py your-music.mp3 \ --output-json cues/your-music.music-cues.json \ --output-md cues/your-music.music-cues.md
这个脚本会生成音乐的节拍、强度峰值和提示点,帮助Hyperframes更好地同步视频动画与音乐节奏。
Taxi for Taxis示例展示了音频与视觉的精准同步
集成自定义技能:扩展brag的能力范围
brag设计为可扩展的技能,你可以通过创建自定义技能来增强其功能。自定义技能应遵循以下结构:
skills/ your-custom-skill/ assets/ # 自定义资源 references/ # 参考文档 SKILL.md # 其他技能文件
然后通过符号链接将自定义技能添加到brag的技能目录:
ln -s /path/to/your-custom-skill skills/brag/your-custom-skill
总结与下一步
通过本指南,你已经了解了如何扩展和定制brag的视频生成技能。从定制基调、音频体验,到创建自定义故事板和集成新技能,brag提供了丰富的扩展可能性。
要开始使用brag,首先克隆仓库:
git clone https://gitcode.com/gh_mirrors/brag1/brag
然后探索skills/brag/目录下的文件,了解更多实现细节。你可以从修改现有基调开始,逐步尝试更复杂的定制。
无论是为开源项目创建展示视频,还是为商业产品制作营销材料,brag都能帮助你快速生成高质量的视频内容。通过定制和扩展brag,你可以打造出真正独特的项目展示体验!
【免费下载链接】bragYou built it. Now brag. Turn the project you just created into a short, shareable launch video with one command.
项目地址: https://gitcode.com/gh_mirrors/brag1/brag
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考