Jacky-motion
Turn Chinese voiceover scripts into record-ready motion HTML, with optional SRT autoplay, B-roll frames, and 16:9 or 3:4 layouts.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/jackywxsz--jacky-motion)HTML
<a href="/listings/jackywxsz--jacky-motion"><img src="/api/listings/jackywxsz--jacky-motion/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
使用通用 Skills 安装器:
npx skills add https://github.com/Jackywxsz/Jacky-motion
也可以直接从公开 GitHub 仓库导入到支持 Agent Skills 的应用。
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 163 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: jacky-motion2-0
- description: Jacky Motion 2.2 Hybrid:把中文口播稿变成可录屏的信息动画单文件 HTML。可选纯 HTML 手动推进(16:9 或 3:4)或配合 SRT 自动播放(16:9,含 B-roll 录屏画框)。流程为审稿、分镜、锁风格、装配与视觉验收;七种重点风格共享同一套版式、动效与质量门禁。
- metadata:
- version: "2.2.1"
- ---
- # Jacky Motion · 口播信息动画导演
- 把中文口播稿变成可直接录屏的信息动画 HTML。你不是 PPT 模板机,而是同时理解口播节奏、信息架构、视觉审美与动效物理的演示导演。
- 首要目标:观众听口播时,屏幕上的信息一眼看懂、层级清楚、节奏同步、画面高级。HTML 只承担关键转折、核心框架和记忆点,不把全文搬上屏幕。
- 第一性原则:
- ```text
- 口播节拍 → 观众注意力落点 → 信息关系变化 → 最终记忆点
- ```
- 每个 beat 回答四问:第一眼看哪里?这一秒理解什么关系?动画如何让关系发生变化?最终定格帧能否独立成立?
- 核心判断:信息表达 > 版式 > 动画 > 装饰。先设计最终帧,再反推运动;静止帧已能讲清关系时,不强行重构。
- ## 第零步:选择运行模式
- 开始审稿前先锁定模式;用户已说清时直接记录,不重复追问。
- | 模式 | 输入 | 输出与控制 | 画幅 |
- |---|---|---|---|
- | `standard` 纯 HTML | 口播稿 | 点击、Space 或方向键手动推进,适合边讲边录 | 16:9 或 3:4 |
- | `srt` 自动播放 | 口播稿 + 已校对 `.srt` | SRT 主时钟自动播放,自动安排带标题的 B-roll 录屏画框 | 16:9 |
- 路由规则:
- 1. 用户提供 SRT,或明确要求自动播放、严格同步、B-roll 录屏窗口时,选择 `srt`。
- 2. 用户只提供口播稿,或需要 3:4 竖版时,选择 `standard`。
- 3. 用户要求自动播放但没有 SRT 时,先索要已校对 SRT;禁止按字数估算时间。
- 4. 用户没有偏好时默认 `standard`,不把 SRT 变成使用门槛。
- 5. 两种模式共享审稿、分镜、七种风格、版式骨架、视觉门禁和运动语言;SRT 只增加时间轴、自动播放与 B-roll 规则。
- ## 架构
- ```text
- 共享视觉核心
- + standard:16:9 / 3:4 固定基座 + 手动推进
- + srt:16:9 自动播放基座 + SRT 主时钟 + B-roll
- ```
- - `standard`:16:9 用 [base-template.html](assets/base-template.html),3:4 用 [base-template-portrait.html](assets/base-template-portrait.html)。
- - `srt`:只用 [base-template-srt.html](assets/base-template-srt.html),再读取 [SRT 时间轴](references/srt-autoplay.md)、[SRT 装配增量](references/srt-production.md)、[SRT Beat 增量](references/srt-beat-contract.md) 与 [SRT 验收增量](references/srt-quality-check.md)。
- - 生成时只填模板注入点,不改 RUNTIME CORE 与 RUNTIME JS;不在 beat 内另写状态机、事件监听或独立计时器。
- ## 生产流程
- ### 共享流程
- ```text
- P1 审稿 → 确认 → P2 分镜 → 确认 → P3 锁风格与 Beat Contract → 确认
- ```
- | 阶段 | 单一入口 | 产出 |
- |---|---|---|
- | P1 审稿 | [script-audit.md](references/script-audit.md) | 通过 / 轻改 / 重写,停等确认 |
- | P2 分镜 | [storyboard.md](references/storyboard.md);原语查 [information-primitives.md](references/information-primitives.md) | 画幅、模式与分镜表,停等确认 |
- | P3 锁风格 | 所选 `styles/{id}.md` + [hybrid-quality-gate.md](references/hybrid-quality-gate.md) + [beat-contract.md](references/beat-contract.md) | 全片风格与 beat 契约,停等确认 |
- ### Standard 收尾
- ```text
- P4 按 html-production.md 装配 → P5 按 quality-check.md 验收 → 交付
- ```
- 3:4 必须加读 [portrait-adaptation.md](references/portrait-adaptation.md),并从 [layout-skeletons-portrait.md](references/layout-skeletons-portrait.md) 选择 V 骨架;16:9 从 [layout-skeletons.md](references/layout-skeletons.md) 选择 L 骨架。
- ### SRT 收尾
- ```text
- P3.5 锁 SRT 覆盖与 B-roll → 确认 → P4 装配自动播放 HTML → P5 视觉与同步验收 → 交付
- ```
- 先运行 `node scripts/parse-srt.mjs input.srt`。SRT 是唯一主时钟,但不是字幕层;最终 HTML 不显示逐句字幕、不生成配音、不嵌入 audio/voice。
- ## 七个重点风格
- | 风格 | 最适合 | 画面气质 |
- |---|---|---|
- | [apple-tech-gradient](styles/apple-tech-gradient.md) | AI 工具、产品概念、抽象机制 | 黑色空间里概念被光场托起 |
- | [finance-studio-cards](styles/finance-studio-cards.md) | 财经、商业模式、指标关系 | 演播室信息屏,主数字与传导路径 |
- | [editorial-magazine](styles/editorial-magazine.md) | 深度观点、文化商业洞察 | 正在重排的中文杂志跨页 |
- | [newspaper-evidence](styles/newspaper-evidence.md) | 新闻、历史、案例、证据链 | 整理过的调查档案 |
- | [paper-craft-studio](styles/paper-craft-studio.md) | 课程、教育解释、亲和品牌 | 暖纸工作台上逐层摆清概念 |
- | [paper-collage](styles/paper-collage.md) | 小红书、测评、经验清单 | 新潮复古贴纸手账跨页 |
- | [sketch-note](styles/sketch-note.md) | 科普、教学、新手向讲解 | 白纸黑线知识手稿 |
- 选择规则:内容适配优先;全片只用一个主风格。没有指定时,按适配度给出精简选择表,只推荐一个并停等确认。`apple-light-blue-glass`、`ink-framework`、`manifesto-poster` 是兼容资产,不进入默认推荐闭环。
- ## 不可违背的总规则
- 1. **单一视觉中心**:每个 beat 只有一个第一眼落点和一个核心信息关系。
- 2. **舒展而不空洞**:最多两个大信息区;先确定 primary、secondary、negative space,再写 CSS;禁止中心堆叠、随机散点和整屏大卡片。
- 3. **信息分布可证明**:16:9 主体不得长期挤在中央 40%;3:4 常规页最终态纵向有效跨度达到舞台高度 62% 以上。
- 4. **文字短于口播**:中文标题按语义短语断行;禁止单字孤行、挤压、溢出和用缩小字号掩盖布局问题。
- 5. **final-state-first**:CSS 静止态就是最终帧;时间线只用 `gsap.from/fromTo` + `clearProps`,结束后完全静止可截图。
- 6. **四段式镜头**:核心 beat 能说明 `glance → reconstruct → push → lock`。Claim 页可省略 reconstruct,但必须保留明确落点和记忆定格。
- 7. **逐项揭示**:口播逐个讲的清单按 step 揭示;禁止多项同时 stagger 涌入。
- 8. **运动预算**:每 beat 最多 1 个结构运动、2 组辅助出现、1 次锁定强调;动画总时长必须短于该段口播。
- 9. **编号分层**:章节装饰号、流程编号与页码使用不同角色,不能压线、压字或互相冒充。
- 10. **元素不重叠**:任何真实重叠、裁切、越界或引导线穿越内容都判失败;先改结构,再重截。
- 11. **风格必须显性**:每个 beat 至少使用一个所选风格的签名组件或构图,核心 beat 至少两个。
- 12. **token 纪律**:beat CSS 只消费风格变量与签名类,不硬编码颜色和字体。
- 13. **3:4 不是缩放**:左右结构转上下,横向路径转纵向,3×2 转 2×3,只使用 V 骨架。
- 14. **SRT 时间完整**:所有时间区间属于 `motion` 或 `broll`;相邻不重叠,未覆盖空档不超过 500ms;step 使用真实语义触发 cue。
- 15. **B-roll 是正式画面**:只显示 `B-ROLL`、序号和 4-18 字具体标题,不用空白页或“这里放素材”等制作备注。
- 16. **真实浏览器验收**:至少检查首屏、最密 beat、多步最终帧、B-roll(如有)和收束页;截图失败即不交付。
- ## 校验命令
- Standard:
- ```bash
- node <SKILL_ROOT>/scripts/validate-motion-html.mjs output.html
- node <SKILL_ROOT>/scripts/check-layout-browser.mjs output.html
- ```
- SRT:
- ```bash
- node <SKILL_ROOT>/scripts/validate-motion-html-srt.mjs output.html
- node <SKILL_ROOT>/scripts/check-layout-browser-srt.mjs output.html
- ```
- Playwright 不可用时,改用 Agent 浏览器或人工截图,不为安装依赖阻塞交付。
- ## 资源导览
- ```text
- jacky-motion2-0/
- ├── SKILL.md
- ├── assets/
- │ ├── base-template.html
- │ ├── base-template-portrait.html
- │ ├── base-template-srt.html
- │ └── styles/{id}.css
- ├── styles/{id}.md
- ├── references/
- │ ├── script-audit.md / storyboard.md / beat-contract.md
- │ ├── layout-skeletons.md / layout-skeletons-portrait.md
- │ ├── portrait-adaptation.md / motion-language.md
- │ ├── html-production.md / quality-check.md
- │ └── srt-autoplay.md / srt-production.md / srt-beat-contract.md / srt-quality-check.md
- └── scripts/
- ├── parse-srt.mjs
- ├── validate-motion-html.mjs / check-layout-browser.mjs
- └── validate-motion-html-srt.mjs / check-layout-browser-srt.mjs
- ```
- ## 长内容处理
- | 长度 | 处理 |
- |---|---|
- | 1-3 分钟 | 单一 storyboard,5-8 beat |
- | 3-8 分钟 | 主轨压缩,9-14 beat;细节交给口播或 B-roll |
- | 8 分钟以上 | 拆成多集或多文件;单文件只做总览主轨 |
README.md · README · 269 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Jacky Motion
- 把中文口播稿变成可直接录屏的信息动画 HTML。
- Jacky Motion 不是 PPT 模板,也不把全文做成大字幕。它先拆解口播的信息骨架,再用明确的视觉中心、画面重构、渐进揭示和记忆定格,让观众跟着口播节奏理解复杂内容。
- <p align="center">
- <img src="docs/gallery/apple-tech-gradient-1.png" alt="Apple Tech Gradient 开场落点" width="32.5%">
- <img src="docs/gallery/paper-craft-studio-2.png" alt="Paper Craft Studio 关系重构" width="32.5%">
- <img src="docs/gallery/paper-collage-3.png" alt="Paper Collage 最终定格" width="32.5%">
- </p>
- ## 两种运行模式
- 同一个 Skill,在开始时按输入自动分流:
- | 模式 | 你提供 | 生成结果 | 适合场景 |
- |---|---|---|---|
- | **纯 HTML** | 中文口播稿 | 手动推进的单文件 HTML,支持 16:9 与 3:4 | 边讲边录、自由掌握停顿、竖屏内容 |
- | **HTML + SRT** | 口播稿 + 已校对 `.srt` | 按字幕时间自动播放的 16:9 HTML,含 B-roll 录屏画框 | 固定口播成片、严格同步、自动录屏 |
- 没有 SRT 时默认使用纯 HTML,不增加上手门槛。SRT 只作为时间主轴,不生成语音,也不会把字幕逐句铺到画面上。
- ## 核心能力
- - **信息先行**:每个画面只讲一个核心关系,屏幕文字短于口播。
- - **四段式镜头**:`glance → reconstruct → push → lock`,从第一眼落点走到最终记忆帧。
- - **渐进揭示**:清单、流程和对比随口播逐步出现,不一次性堆满。
- - **稳定排版**:禁止中心拥堵、单字孤行、重叠、溢出和引导线穿越内容。
- - **双画幅**:纯 HTML 支持 1920×1080 横屏与 1080×1440 竖屏,竖版使用独立布局而非缩放。
- - **自动录屏**:SRT 模式提供倒计时、暂停、跳转、重播和 B-roll 画框。
- - **可验证交付**:静态校验 + 真实浏览器截图检查,不以“代码能打开”代替视觉验收。
- ## 七种风格实测
- 下面 21 张图全部使用当前 `2.2.1` 规则重新生成,并在 1920×1080 真实浏览器中验收,不复用历史版本截图。每种风格固定展示三种能力:
- 1. **开场落点**:第一眼能否立刻找到核心判断。
- 2. **关系重构**:流程、对比或层级能否舒展推进。
- 3. **最终定格**:动画停止后能否留下可独立截图的记忆帧。
- ### Apple Tech Gradient
- **适合内容:** AI 工具、产品概念、抽象机制、发布会式观点。
- **视觉语言:** 黑色空间、低强度暖光、SF 系无衬线与克制毛玻璃。热力橙只标记关键判断,留白用于建立聚光感,不把内容塞进卡片墙。
- **表达强项:** 用尺度、远近和玻璃层级呈现抽象概念从模糊到清晰的过程。
- <p align="center">
- <img src="docs/gallery/apple-tech-gradient-1.png" alt="Apple Tech Gradient 开场落点" width="32.5%">
- <img src="docs/gallery/apple-tech-gradient-2.png" alt="Apple Tech Gradient 关系重构" width="32.5%">
- <img src="docs/gallery/apple-tech-gradient-3.png" alt="Apple Tech Gradient 最终定格" width="32.5%">
- </p>
- <p align="center"><sub>01 开场落点 · 大标题与主玻璃面板 02 关系重构 · 三段理解路径 03 最终定格 · 单一结论锁定</sub></p>
- ### Finance Studio Cards
- **适合内容:** 财经解读、商业模式、公司分析、指标关系与风险判断。
- **视觉语言:** 黑蓝演播室信息屏、等宽主数字、青绿传导路径;琥珀色只承担风险语义。主指标最亮,辅助指标主动退后。
- **表达强项:** 先让观众看到主数字,再沿独立连接轨道理解数字背后的因果链。
- <p align="center">
- <img src="docs/gallery/finance-studio-cards-1.png" alt="Finance Studio Cards 开场落点" width="32.5%">
- <img src="docs/gallery/finance-studio-cards-2.png" alt="Finance Studio Cards 关系重构" width="32.5%">
- <img src="docs/gallery/finance-studio-cards-3.png" alt="Finance Studio Cards 最终定格" width="32.5%">
- </p>
- <p align="center"><sub>01 开场落点 · 主 KPI 与辅助指标 02 关系重构 · 指标传导路径 03 最终定格 · 决策结论与风险阈值</sub></p>
- ### Editorial Magazine
- **适合内容:** 深度观点、文化观察、商业洞察与人物叙事。
- **视觉语言:** 中文衬线标题、编辑红、巨型描边页码、拉引和规则线。版面像经过主编重排的杂志跨页,而不是普通图文卡片。
- **表达强项:** 用标题、拉引和章节秩序控制阅读先后,让观点显得有重量但不拥挤。
- <p align="center">
- <img src="docs/gallery/editorial-magazine-1.png" alt="Editorial Magazine 开场落点" width="32.5%">
- <img src="docs/gallery/editorial-magazine-2.png" alt="Editorial Magazine 关系重构" width="32.5%">
- <img src="docs/gallery/editorial-magazine-3.png" alt="Editorial Magazine 最终定格" width="32.5%">
- </p>
- <p align="center"><sub>01 开场落点 · 标题与拉引 02 关系重构 · 三条编辑规则 03 最终定格 · 跨页式观点收束</sub></p>
- ### Newspaper Evidence
- **适合内容:** 新闻事件、历史、政策、案例拆解、证据链和调查复盘。
- **视觉语言:** 黑白米色纸面、衬线剪报、来源编号、胶带、短红线与结论印章。所有材料明确标注为真实来源或版式示意。
- **表达强项:** 先呈现材料,再让批注贴合证据,最后盖章锁定有边界的结论。
- <p align="center">
- <img src="docs/gallery/newspaper-evidence-1.png" alt="Newspaper Evidence 开场落点" width="32.5%">
- <img src="docs/gallery/newspaper-evidence-2.png" alt="Newspaper Evidence 关系重构" width="32.5%">
- <img src="docs/gallery/newspaper-evidence-3.png" alt="Newspaper Evidence 最终定格" width="32.5%">
- </p>
- <p align="center"><sub>01 开场落点 · 主证据剪报 02 关系重构 · 一主两辅证据板 03 最终定格 · 调查结论盖章</sub></p>
- ### Paper Craft Studio
- **适合内容:** 课程、教育解释、亲和品牌与友好型产品说明。
- **视觉语言:** 暖纸工作台、奶油纸面、蓝黄绿模块和轻微错层。手作感来自纸张材质与裁边,不依赖幼稚插画或随意倾斜。
- **表达强项:** 把复杂内容像整理纸片一样分层归位,特别适合步骤、系统和模块关系。
- <p align="center">
- <img src="docs/gallery/paper-craft-studio-1.png" alt="Paper Craft Studio 开场落点" width="32.5%">
- <img src="docs/gallery/paper-craft-studio-2.png" alt="Paper Craft Studio 关系重构" width="32.5%">
- <img src="docs/gallery/paper-craft-studio-3.png" alt="Paper Craft Studio 最终定格" width="32.5%">
- </p>
- <p align="center"><sub>01 开场落点 · 主纸面与三层信息 02 关系重构 · 三步模块展开 03 最终定格 · 纸堆式结论收束</sub></p>
- ### Paper Collage
- **适合内容:** 小红书、测评、经验清单、生活方式和种草内容。
- **视觉语言:** 复古纸底、厚边贴纸、硬阴影、胶带、票据与马克笔。纸片可以有角度,但版面轴线和注意力顺序保持稳定。
- **表达强项:** 在保持社交内容活力的同时,用贴纸层级完成问题、理由和行动方向的渐进揭示。
- <p align="center">
- <img src="docs/gallery/paper-collage-1.png" alt="Paper Collage 开场落点" width="32.5%">
- <img src="docs/gallery/paper-collage-2.png" alt="Paper Collage 关系重构" width="32.5%">
- <img src="docs/gallery/paper-collage-3.png" alt="Paper Collage 最终定格" width="32.5%">
- </p>
- <p align="center"><sub>01 开场落点 · 主判断与辅助贴纸 02 关系重构 · 三张叙事卡依次推进 03 最终定格 · 马克笔观点锁定</sub></p>
- ### Sketch Note
- **适合内容:** 教学、科普、教程、新手向方法讲解。
- **视觉语言:** 白纸淡方格、楷体手写、墨线框、铅笔旁注和一支红笔。圈、线、箭头只用于解释,不作为无意义装饰。
- **表达强项:** 像老师边讲边画,把抽象关系拆成可以跟随的线稿推演。
- <p align="center">
- <img src="docs/gallery/sketch-note-1.png" alt="Sketch Note 开场落点" width="32.5%">
- <img src="docs/gallery/sketch-note-2.png" alt="Sketch Note 关系重构" width="32.5%">
- <img src="docs/gallery/sketch-note-3.png" alt="Sketch Note 最终定格" width="32.5%">
- </p>
- <p align="center"><sub>01 开场落点 · 红笔圈出核心判断 02 关系重构 · 手绘因果链 03 最终定格 · 波浪线与圈注收笔</sub></p>
- 全片只使用一个主风格。Skill 会根据内容给出风格选择表,并只推荐一个最合适的方向。
- ### SRT B-roll 录屏画框
- 当某一段更适合展示真实网站、产品或操作时,SRT 模式会生成带具体小标题的正式录屏窗口,而不是留一张空白制作备注。
- 
- ## 工作流
- ```text
- 选择模式
- → P1 审稿
- → P2 分镜
- → P3 锁风格与 Beat Contract
- → [SRT 模式追加 P3.5 时间轴确认]
- → P4 装配 HTML
- → P5 视觉与同步验收
- ```
- 审稿、分镜与风格阶段会停下来确认,把返工尽量留在写代码之前。
- ## 安装
- 使用通用 Skills 安装器:
- ```bash
- npx skills add https://github.com/Jackywxsz/Jacky-motion
- ```
- 也可以直接从公开 GitHub 仓库导入到支持 Agent Skills 的应用。
- ## 使用示例
- 纯 HTML 横屏:
- ```text
- 使用 Jacky Motion,把这篇中文口播稿生成 16:9 可录屏信息动画 HTML。先审稿,按完整流程推进。
- ```
- 纯 HTML 竖屏:
- ```text
- 使用 Jacky Motion,把这篇口播稿生成 3:4 竖版信息动画。使用 paper-craft-studio 风格。
- ```
- SRT 自动播放:
- ```text
- 使用 Jacky Motion,把这篇口播稿和已校对 SRT 生成 16:9 自动播放 HTML,并为真实产品展示区间安排 B-roll 录屏画框。
- ```
- ## 播放控制
- **纯 HTML**
- - 点击、`Space`、`→`:推进
- - `←`:回退
- - `R`:重播当前 Beat
- - `F`:全屏
- **SRT 自动播放**
- - 点击“准备录屏”:请求全屏并倒数 3 秒
- - `Space`:暂停 / 继续
- - `←` / `→`:前后跳转 5 秒
- - `R`:从头重播
- - `F`:全屏
- ## 校验
- 纯 HTML:
- ```bash
- node scripts/validate-motion-html.mjs path/to/output.html
- node scripts/check-layout-browser.mjs path/to/output.html
- ```
- SRT 自动播放:
- ```bash
- node scripts/parse-srt.mjs path/to/input.srt
- node scripts/validate-motion-html-srt.mjs path/to/output.html
- node scripts/check-layout-browser-srt.mjs path/to/output.html
- ```
- 浏览器检查脚本会优先使用现有 Playwright;不可用时可改用 Agent 浏览器或人工截图,不要求用户为此单独搭建复杂环境。
- ## 仓库结构
- ```text
- .
- ├── SKILL.md
- ├── agents/openai.yaml
- ├── assets/
- │ ├── base-template.html
- │ ├── base-template-portrait.html
- │ ├── base-template-srt.html
- │ └── styles/*.css
- ├── styles/*.md
- ├── references/
- │ ├── 共享视觉、版式与动效规则
- │ └── SRT 时间轴与验收增量
- ├── scripts/
- │ ├── 纯 HTML 校验器
- │ └── SRT 解析与校验器
- └── docs/gallery/
- ```
- ## 边界
- - 输出 HTML,不直接渲染 MP4。
- - 不提供 TTS,不生成或嵌入音频。
- - SRT 自动播放当前固定为 16:9;3:4 使用纯 HTML 模式。
- - 真实数据、引用与截图由用户提供;Skill 不捏造来源。
- ## 反馈
- 欢迎通过 [GitHub Issues](https://github.com/Jackywxsz/Jacky-motion/issues) 提交问题与建议。
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.