序言(首先运行)
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
_TEL_TIER="${_TEL_TIER:-anonymous}"
_TEL_PROMPTED=$([ -f ~/.superstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
mkdir -p ~/.superstack
echo "TELEMETRY: $_TEL_TIER"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
if [ "$_TEL_TIER" != "off" ]; then
_TEL_EVENT='{"skill":"video-craft","phase":"launch","event":"started","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}'
echo "$_TEL_EVENT" >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
_CONVEX_URL=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"convexUrl":"[^"]*"' | head -1 | cut -d'"' -f4 || echo "")
[ -n "$_CONVEX_URL" ] && curl -s -X POST "$_CONVEX_URL/api/mutation" -H "Content-Type: application/json" -d '{"path":"telemetry:track","args":{"skill":"video-craft","phase":"launch","status":"success","version":"0.2.0","platform":"'$(uname -s)-$(uname -m)'","timestamp":'$(date +%s)000'}}' >/dev/null 2>&1 &
true
fi
如果 TEL_PROMPTED 为 no:在开始技能工作流之前,询问用户关于遥测的问题。选项:A) 当然可以(匿名)B) 不用了,谢谢。这只会发生一次。
技能用错了? 请参见 SKILL_ROUTER.md 了解所有可用技能。
视频精修
为 Remotion 视频提供帧级视觉构图与产品演示展示。该技能让视频的每一帧看起来都经过刻意设计,而不仅仅是正确动画。
marketing-video 处理生产管线(访谈、叙事、动画机制、渲染)。该技能处理每一帧静态画面的外观——构图、设备框架、背景、特效选择以及结束卡片设计。
权限模型
marketing-video→ 生产管线、动画机制、基础质量(字体最小值、安全区、弹簧物理)design-taste→ 美学方向。该技能消费它,而不是重新定义它。- 该技能 → 面向限时观看的帧构图、产品演示展示、结束卡片设计、特效系列
继承(不重新陈述): 来自 marketing-video 的字体最小值、移动安全区、文本可读性、弹簧默认值。来自 design-taste 的色彩克制、不对称性、留白。
何时触发
- 审查 Remotion 合成片的视觉质量时
- 构建带截图的产品演示视频时
- 设计结束卡片/行动号召帧时
- 用户说“视频帧看起来很普通”或“让这个看起来更精致”时
marketing-video在创意指导或构建阶段调用该技能时
不要在“创建视频”或“营销视频”时触发——这些路由到 marketing-video。
工作流
- 检查
design-taste获取美学方向(或让用户选择一个) - 确定相关参考:
- 合成视频帧或结束卡片 → references/frame-composition.md
- 构建产品演示场景 → references/product-demo-patterns.md
- 为每个场景生成 帧简报
- 在渲染前运行预检清单
帧简报(每个场景)
场景:[名称]
时长:[秒/帧数]
宽高比:[16:9 / 9:16 / 1:1]
焦点:[眼睛最先注意到的元素]
原型:[Hero / 产品 / 分屏 / 数据 / 对比 / 结束卡片]
设备:[笔记本电脑 / 手机 / 浏览器 / 无]
所需素材:[截图路径、logo、图标名称]
背景:[径向渐变+噪点 / 截图模糊 / 网格 / 纯色]
特效系列:[发光 / 动能 / 液态 / 音频锁定 / 深度 / 无]
动画:[入场弹簧配置、保持帧、退出]
预检清单
- 每帧有一个清晰的焦点
- 截图放置在设备框架中,而非浮动原始图像
- 背景具有深度(渐变+噪点或暗角),而非纯色平面
- 每个文本块在屏幕上最多 8 个词
- 每帧文本保持时间 >=
(词数 x 0.3) + 1秒 - 结束卡片至少 3 秒且仅有一个动作
- 每个视频只使用 1-2 种特效系列
- 在任何帧工作之前选定美学方向
资源
references/
- references/frame-composition.md — 帧原型(16:9 和 9:16)、限时可读性、背景深度、特效系列、结束卡片原型(简洁/指标/行动/循环)
- references/product-demo-patterns.md — 可直接用于 Remotion:设备框架(笔记本电脑/手机/浏览器)、光标编排、缩放方案、截图预处理、注释模式
跨技能参考
marketing-video— 生产管线、动画机制、基础质量规则design-taste— 在帧工作前消费的美学方向number-formatting— 用于帧中显示的任何指标
遥测(最后运行)
_TEL_END=$(date +%s)
_TEL_DUR=$(( _TEL_END - ${_TEL_START:-$_TEL_END} ))
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
if [ "$_TEL_TIER" != "off" ]; then
echo '{"skill":"video-craft","phase":"launch","event":"completed","outcome":"OUTCOME","duration_s":"'"$_TEL_DUR"'","session":"'"$_SESSION_ID"'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","platform":"'$(uname -s)-$(uname -m)'"}' >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
true
fi
根据工作流结果将 OUTCOME 替换为 success/error/abort。