Communitygithub.com

TurkiHassan/period-launch-video

创建一个24秒正方形(1440²,60fps)循环产品发布视频,整个故事发生在字标的句号内部——虹膜打开显示夜景照片,玻璃UI从 ask → find → write → night → results → 手机锁屏 → proof → CTA 依次变化,然后关闭回到应用图标旁边的句号内。基于单一画布、seek(t) 函数、Playwright 渲染(含运动模糊)、节拍同步音效、-14 LUFS。支持阿拉伯语 RTL 模板(若存在则使用 Geist + Thmanyah,否则使用 IBM Plex Sans Arabic),配置驱动。每当用户提到“夜间换班视频”、“نفس فيديو النقطة”、“方形发布视频”、“句号内广告”、类似 مستخرج 的发布/推广视频,或者粘贴包含“inside the period of the wordmark”/iOS 玻璃面板/goo-split 胶囊的简报时——即使没有明确指定此技能,也应使用。同时涵盖获取匹配的夜间/白天照片(Higgsfield、本地 Codex image_gen,或为 Gemini/ChatGPT 准备的提示词)。

period-launch-video 是什么?

此技能是一个用于生成 24 秒正方形循环产品发布视频的自动化管线。视频的核心创意是将整个产品故事呈现在其字标的句号内部,通过鸢尾花式打开、玻璃 UI 元素序列动画(ask → find → write → night → results → 手机锁屏 → proof → CTA),最后关闭回到句号内。它使用 Playwright 进行渲染,支持运动模糊和节拍同步音效,最终输出达到 -14 LUFS 的专业音频标准。该技能为阿拉伯语 RTL 布局进行了专门优化(使用 Geist + Thmanyah 字体作为备选,否则使用 IBM Plex Sans Arabic),并且完全由 `config.js` 驱动,开发者只需填充产品名称、标语、文案和四张照片即可。它支持多种照片获取途径:Higgsfield MCP(带积分)、本地 Codex 的 image_gen,或为 AI 图像生成准备提示词。工作流程包括:项目搭建、输入收集(图标、音乐、文案)、照片对齐与调色、六个关键帧的节拍图预览与审批,最后是渲染、验证和交付。内置的扫描脚本确保循环无缝,音效峰值检测确保音频质量,并且支持通过编辑 `T` 参数重新调整时间。作为技能的一部分,它能够智能识别用户关于“句号内视频”的请求,即使他们未明确命名该技能。

兼容平台✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add TurkiHassan/period-launch-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Period launch video

一个 24 秒循环视频,产品的整个工作过程在其字标的句号内展现。所有内容都打包在 template/ 中:渲染器(index.html,所有内容位于 config.js)、渲染、扫描和音频脚本、字体、真实的 macOS 指针以及经过峰值测量的音效。你的工作主要是选择内容和照片,然后运行管线。在更改任何动画之前,请先阅读 references/craft.md。它包含了方向、节拍图以及已经解决的坑点。

工作流

1 · 设置

~/.claude/skills/period-launch-video/scripts/new_project.sh <project>/brag-output/<slug>

将输出放入用户的项目中。如果存在类似 brag-output/ 的 gitignored 文件夹,请使用它。该脚本还会从此 Mac 复制真实的 macOS 指针(make_pointers.py,不可重新分发)并安装 Playwright。为了匹配原始外观,请将 Thmanyah Sans woff2 文件(thmanyah-sans-{400,500,700}.woff2)放入 assets/fonts/。如果没有这些文件,则使用 IBM Plex Sans Arabic。

2 · 从项目中收集输入(仅询问缺失的部分)

  • 身份信息来自已发布版本。 使用 App Store 截图、iOS 资源目录(图标、颜色)以及应用自身的示例数据和文案。忽略过时的网络资源。如果你无法判断哪个版本是当前上线的版本,请询问。这是第一次运行时的主要修正。
  • 图标: 将方形应用图标复制到 assets/img/icon.png。模板本身会应用 iOS 圆角遮罩。
  • 歌曲: 如果项目已有曲目则使用之;否则询问。运行 python3 find_hit.py assets/music/song.mp3 并设置 config.song.hit(≈ 报告的打点 − 0.04)和 bpm。enterAt(默认 3.10)是打点时刻,位于第一个胶囊处。保持 enterAt + 20 beats 大约为 13.5 秒,以便“结果”落在第 20 拍。
  • 文案: 填写 config.js:名称(一个单词,将成为黑色字标加上句号)、标语、两行开场文本、ask 胶囊、工作内容、find/write/night 标签、3 个结果、通知、5 个库行、图表值以及 CTA。保持所有数字在节拍间一致。使用西文数字。保持严格的 JSON 格式,因为 audio.py 会解析它。
  • 诚实性检查: 如果故事情节暗示了产品不存在的功能(例如,整夜批量处理),请在渲染前指出并提供中性的措辞。

3 · 照片(四张图版)

遵循 references/image-prompts.md。根据可用条件选择路径:

  1. 带有积分的 Higgsfield MCP。 先处理白天,然后夜间和黎明作为白天工作的编辑,再加上外部。先预估成本。
  2. 本地 Codex(which codex)。scripts/codex_image.sh 使用用户的 ChatGPT 订阅中的 Codex 内置 image_gen。
  3. 无积分也无 Codex。 向用户提供四个填好的提示词(使用 Gemini 进行编辑),等待文件。

然后:

python3 check_align.py      # night/dawn 必须相对于 day 是位移 (0,0)
python3 grade_plates.py     # → assets/img/*.jpg + 模糊副本;预览 out/plates.jpg

4 · 节拍图 + 六张静帧 → 渲染前审批

node stills.mjs 1.30 7.35 10.10 14.60 17.30 23.25     # open, find, write, results, phone, out
python3 sheet.py out/review-sheet.jpg out/stills/t{1.30,7.35,10.10,14.60,17.30,23.25}.png

首先自己检查每一张静帧:文字是否合适、没有裁剪、玻璃图层在背景图上是否可读。然后向用户展示拼合图(SendUserFile)以及从 index.html 中的 T 构建的节拍图表格。只有在用户批准后才进行渲染。

5 · 渲染、验证、交付

./build.sh out/<slug>-launch.mp4     # 4 个渲染工作进程 → scan.py + scan_local.py → 时间线 + 音频 → H.264/AAC
  • scan.py 必须报告接缝差异约为 0(干净的循环),且没有尖峰或阶跃。
  • scan_local.py 中的打点,如果是计数器声或打字声则没问题。其他任何声音都是真实的爆音:找出导致该问题的交接点并修复。然后仅重新渲染那些帧:node render.mjs a b,并使用 build.sh 中的 ffmpeg 命令重新编码。
  • 在每个计数器结束时抽取一帧,确认显示的是确切的最终数字。
  • 报告规格(1440²、60fps、1440 帧、24.0 秒、LUFS、峰值)、任何未解决的诚实性标记以及文件路径。

超越默认值的适配

  • 重新调整时间: 编辑 index.html 中的 T(保持 0.8 秒的滑动),然后重新运行 node timeline.mjs && python3 audio.py。
  • 库行 固定为 5 行(由布局决定)。图表轴有 3 个标签(开始、中间、结束)。
  • 从左到右(LTR)的产品(英文字标): 模板是按 RTL 布局的。句号位于左端,行和胶囊靠右对齐,扫描和图表从右向左运行。对于 LTR,镜像这些锚点(align、R/L 边缘、scanX、cpt),并将图标放在左侧。为此留出时间,并检查每一张静帧。

相关技能