editorial-card-video

内容表 → 成片的一键视频生成 skill。只需填一份 content-spec（标题、要点、配图、BGM），即可自动生成一支 20-24 秒的纸感编辑风信息卡视频：米白纸底、Swiss 杂志排版、右侧活卡——卡内视频实时播放、层叠入场、锚定微漂，宛如会呼吸的杂志页。

内置六类场景蓝图、13 个可参数化组件、三种杂志卡形态（单视频卡 / 三联实况卡 / 深色满版卡），换主题只改一个 JSON 文件。自带全套 QC 门禁：卡面完整性六查、卡区动态量对标、落位-结束帧回归检查——多轮实战打磨踩过的坑已全部固化为规则，照清单跑即可稳定出片。

安装

# Claude Code
git clone https://github.com/huangserva/editorial-card-video.git ~/.claude/skills/editorial-card-video
# Codex CLI
git clone https://github.com/huangserva/editorial-card-video.git ~/.codex/skills/editorial-card-video

快速开始

1. 复制 examples/family-ai-assistant.content-spec.json，改成你的内容（文案长度边界见 references/content-spec-guide.md）
2. 卡内视频素材放入你的素材目录（3:4 竖版、密关键帧，规格见 references/live-media-rules.md；assets/card_media_pack/ 有可直接用的示例段）
3. 生成活卡 → 生成并渲染主片：

node scripts/generate_guizang_live_cards.mjs --spec your-spec.json --out-dir out/cards
node scripts/generate_editorial_card_video.mjs --spec your-spec.json \
  --live-cards-dir out/cards/output --out-dir out --project out/project \
  --output out/final_1920x1080.mp4 --render

4. 按 references/qc-checklist.md 跑 QC 门禁（Card-Face Integrity 六查为必过项）

目录

• SKILL.md — agent 入口：何时用、端到端工作流、gate 纪律
• references/ — 风格语言（实测色值/字号）、场景蓝图、卡面解剖、内容表指南、活媒体规则、QC 清单、翻车史
• scripts/ — 生成 ×2 + QC ×8，全部参数化输入输出
• examples/ — 两份已验证的 content-spec
• assets/ — 13 个 HyperFrames 组件、示例卡片视频素材包

依赖

Node.js (ESM)、ffmpeg、Python 3（Pillow/numpy）、HyperFrames（npx hyperframes）。assets/vendor/gsap.min.js 为 GSAP（Webflow 许可，免费使用）。

设计源流

卡面设计语言致敬 归藏社交卡 Skill（设计参考，非运行时依赖；扩展新卡形态时推荐阅读其风格系统）。

License

未定（保留所有权利）。商用/分发请先联系作者。