Marketing Studio Agent 是面向 Claude Code 的智能体驱动视频渲染引擎，属于 reason-machines/marketing-skills 技能集合。它的核心用途是：在产品仓库中运行 /marketing 命令，一次性生成完整的发布素材套件，包括 3D Logo 揭示动画、屏幕录制的产品演示、带配音与音乐的发布主视频、按平台裁剪的社交短片，以及 OG 素材。所有渲染都在中央引擎仓库中完成，使用 Remotion、Blender、Playwright 和 ElevenLabs。
主要能力
/ marketing 命令会运行完整流水线：品牌引导（从设计系统推导品牌令牌，或提示输入）、Logo 揭示（Blender 3D 动画在 Remotion 中合成）、产品演示（Playwright 捕获运行中的应用并加入镜头缩放）、发布视频（30-90 秒主视频，组合演示、Logo 与文案）、音轨（ElevenLabs 配音与音乐，按视频配乐）、社交短片（针对 X、LinkedIn、TikTok 的平台特定剪辑）、OG 素材（静态图、动画循环、README GIF）。
各素材类型也可单独运行：/logo-reveal、/product-demo、/launch-video、/audio-track、/social-clip、/og-assets。
安装方式
克隆引擎仓库：git clone https://github.com/ucsandman/marketing-studio.git，进入目录后执行 cd studio && npm install && cd ..。可选配置：复制 .env.example 为 .env，设置 Blender 路径、ElevenLabs API 密钥。将技能安装到 Claude Code：node scripts/install-skills.mjs。验证工具链：python launch.py --check。安装脚本会把技能复制到 ~/.claude/skills 并链接到克隆的引擎路径。
品牌配置
品牌在 brands/<id>.json 中定义，包含 id、name、tagline、colors（13 个颜色字段）、fonts（heading、body、mono）以及 voice（tone 与 avoid 列表）。需要在 studio/src/lib/brand.ts 中注册品牌，使用 zod 定义 BrandSchema 并提供 getBrand 函数。还需在 studio/src/brands/<id>Mark.tsx 中添加 Logo 标记组件。
手动渲染
可在 studio 目录下使用 Remotion 命令直接渲染任意合成：LogoReveal、ProductDemo、LaunchVideo、SocialClip、AnimatedOG，通过 --props 传入 JSON 参数。也可使用 feeder 脚本：capture.mjs 捕获产品演示、render_logo.py 渲染 Blender Logo、generate.mjs 生成音频（配音或音乐）。Props 可通过 scripts/build-launch-props.mjs 与 scripts/build-social-props.mjs 生成，避免手工编辑 JSON。
环境变量
.env 中可设置 BLENDER_PATH、ELEVENLABS_API_KEY、COMFYUI_URL，均为可选；缺少时 feeder 会优雅降级。
验证与测试
python launch.py --check 执行完整工具链健康检查；node scripts/smoke.mjs 渲染每个合成的第 0 帧作为冒烟测试；cd studio && npm test 进行品牌 schema 校验；python launch.py 启动 Remotion Studio 进行交互预览。
关键模式
流水线会写入 .marketing-run.json 运行清单，记录已完成步骤、当前步骤与 props，重新运行 /marketing 会从上次未完成步骤恢复。产品演示捕获使用测量缓动实现专业缩放（cubic ease-out）。动画 OG 循环必须首尾帧一致以实现无缝循环。社交短片按平台定义宽高比与安全区：X 与 LinkedIn 为 1280x720，TikTok 与 Instagram 为 1080x1920。
故障排查
Blender 未找到时，可在 .env 设置 BLENDER_PATH 或跳过 3D Logo 揭示（流水线回退到 2D）。ElevenLabs 限流（429）时音频生成可选，流水线会在 API 失败时渲染无配音视频。Playwright 捕获超时时，确保开发服务器在正确端口运行，捕获脚本会等待 networkidle 状态。Remotion 内存错误时，设置 NODE_OPTIONS="--max-old-space-size=8192"。品牌 schema 校验失败时，运行 cd studio && npm test 查看违规项，要求全部 13 个颜色、3 个字体与 voice 规则。
文件结构
仓库包含 brands/（品牌令牌 JSON）、studio/（Remotion 项目与所有合成）、feeders/（blender、capture、audio、comfy）、skills/（Claude Code 技能）、scripts/（安装、props 构建、冒烟测试）、props/、assets/、out/、examples/。
最佳实践
品牌变更后运行冒烟测试；使用 props 构建脚本而非手工编辑；UI 工作最后拍摄演示，先运行 /polish 与 /frontend-verify；画面锁定后再配乐；在 /marketing 前先单独测试各技能；运行期间不要删除 .marketing-run.json 以保留恢复能力。
相关技能
/polish（演示拍摄前的最终 UI 质量检查）、/frontend-verify（无头路由验证，检查控制台错误与失败请求）、/de-vibe（发布前移除 AI 生成痕迹）、/launch（按渠道生成公告草稿）。所有支持技能随 scripts/install-skills.mjs 一起安装。
限制
资料未提供收费、价格、平台支持范围、渲染效果保证等信息。部分功能依赖外部工具（Blender、ElevenLabs、ComfyUI），缺少时相应能力会降级或跳过。