@autoaiai/aicut 0.1.11 → 0.1.13

package/skills/ai-media-quality-review/SKILL.md

@@ -1,72 +0,0 @@
----
-name: ai-media-quality-review
-description: "Inspect generated images, video and audio before delivery using deterministic metadata, contact-sheet, black-frame and silence checks plus visual and listening review. Use to accept, reject or repair Magic Hour media outputs; it does not generate media or predict audience performance. Runs in AICUT: the film is film.html, a page per shot, drawn by `aicut look` and `aicut render`."
-license: MIT
-source: "magichourhq/skills"
----
-
-# AI media quality review
-
-## Running it in AICUT
-
-AICUT's film is `film.html`: it cuts pages, footage, pictures and sound together on tracks. A page is a web page that
-sets `window.film = { frame(t) }` and draws that moment — no framework, no build step, no composition object, no
-`registerRoot`. Five shots are five pages cut together, not one page that changes scene, so each shot stays trimmable
-and replaceable in Studio.
-
-```sh
-npx -y @autoaiai/aicut@latest          # the manual: the format and the commands, always current
-npx -y @autoaiai/aicut@latest open .   # make this folder a film and print Studio's address
-npx -y @autoaiai/aicut@latest look     # a contact sheet of the whole film, its sound, and a determinism check
-npx -y @autoaiai/aicut@latest look 4.5 # one frame, full size — look at the PNG, not at the code
-npx -y @autoaiai/aicut@latest render   # the MP4, beside film.html
-```
-
-Run the manual before the first film: it is authoritative for the format, and this skill is about the method above it.
-
-Where the words below name another program's part, it becomes this:
-
-| elsewhere | in AICUT |
-|---|---|
-| composition, timeline, project file | `film.html`; tracks and clips inside it |
-| a scene, a sequence, a slide | a page (`pages/<name>.html`) cut onto a track |
-| `useCurrentFrame()`, `interpolate()` | `frame(t)` — the picture depends only on `t`, never on state or `Date.now()` |
-| a still, a screengrab | `aicut look <t>` |
-| `render` / `build` / `export` | `aicut render` (the person can also export from Studio) |
-| a dev server, a preview window | `aicut open` and the Studio address it prints |
-
-Hard rules that hold whatever the method says: the picture depends only on `t`; every value in the person's prompt is
-binding; look at the frames `look` writes before saying a film is done.
-
-
-Review the actual downloaded file against its brief and source media. Resolve `scripts/inspect_media.py` relative to this installed skill's `SKILL.md`, not the user's project directory. Run that absolute script path when FFmpeg and FFprobe are available:
-
-```sh
-python3 /absolute/path/to/ai-media-quality-review/scripts/inspect_media.py /absolute/path/to/output.mp4 --output-dir /absolute/path/to/review
-```
-```
-The script creates `probe.json`, `review.json` and a contact sheet, image preview or waveform. For video it also saves `first-frame.jpg` and `last-frame.jpg` from the first and final decoded frames; the contact sheet alone need not include those moments. It reports technical signals; it does not decide whether the creative result is good. A failed rerun clears an earlier `review.json` in a writable output directory before input and dependency checks. Other artifacts may remain from earlier runs; use only the artifacts listed in a newly successful report. Treat a nonzero exit or missing report as unverified, never as a clean result.
-```
-
-## Apply the acceptance criteria
-
-Read the original request and list the few required outcomes and protected details. Inspect the generated artifacts at full size and the intended delivery size.
-
-- **Image:** composition, crop, identity, anatomy, hands, geometry, product/character details, required text and logos, unwanted text and visible artifacts.
-- **Video:** first and last frames, intended action and camera, identity/object continuity, flicker, warping, abrupt cuts, actual dimensions, frame rate, duration and audio streams.
-- **Speech/music:** listen through the full export; check intelligibility, pronunciation, last word or phrase, clipping, silence, mouth timing, cut points and synchronization.
-
-Inspect `first-frame.jpg` and `last-frame.jpg` as well as the contact sheet. A gradual fade can darken a face without crossing the black-frame threshold; an empty `black_segments` list does not rule it out. Review contact-sheet flags in context. Intentional black or silent sections are not defects. A clean diagnostic report cannot prove smooth motion, accurate lip sync, good music or a compelling result. Full-speed viewing and listening remain required for those claims.
-
-Return a compact verdict for each requirement: pass, fail or unverified, with the observed evidence. A successful request, valid file or plausible thumbnail is not a quality pass.
-
-When repair is authorized, identify the smallest failed requirement and return to the last accepted source. Change the relevant reference, prompt, route, interval or deterministic finishing step. Do not regenerate an accepted shot to fix captions, crop or assembly, and do not continue spending beyond the existing limit.
-
-Deliver the accepted file and retain the review folder with it. State any unavailable playback, listening, source comparison or broad-subject validation.
-
-## Source
-
-Rewritten for AICUT from [`magichourhq/skills`](https://github.com/magichourhq/skills)
-(MIT), skills/ai-media-quality-review/SKILL.md. The method is that skill's own; the way it runs is AICUT's.
-
-The repository holds 20 skills; this is the one its entry stands for.

package/skills/ai-product-video/SKILL.md

@@ -1,296 +0,0 @@
----
-name: ai-product-video
-description: "Create cinematic product videos from shot recipe cards, a validated template, and code/audio assets (AICUT + real page screenshots + 2.5D camera moves + beat-synced cuts + sound design). Use when the user asks to turn a frontend project or webpage into a product video, says \"use ai-product-video to make a video/promo\", names the Ink Press template or asks to reproduce its effect, or wants a single shot card's motion. 用镜头配方卡 + 已验收模板 + 代码/音频资产制作电影感产品视频（AICUT + 真实页面截图 + 2.5D 运镜 + 节奏卡点 + 声音设计）。当用户要求\"用 ai-product-video 做视频/宣传片\"、把前端项目/网页做成产品视频、点名 Ink Press 模板或要求复刻模板片效果，或要用镜头卡做单个动效镜头时使用。 Runs in AICUT: the film is film.html, a page per shot, drawn by `aicut look` and `aicut render`."
-license: Apache-2.0
-source: "dlazy-ai/ai-product-video"
----
-
-# ai-product-video：电影感产品视频制作
-
-## Running it in AICUT
-
-AICUT's film is `film.html`: it cuts pages, footage, pictures and sound together on tracks. A page is a web page that
-sets `window.film = { frame(t) }` and draws that moment — no framework, no build step, no composition object, no
-`registerRoot`. Five shots are five pages cut together, not one page that changes scene, so each shot stays trimmable
-and replaceable in Studio.
-
-```sh
-npx -y @autoaiai/aicut@latest          # the manual: the format and the commands, always current
-npx -y @autoaiai/aicut@latest open .   # make this folder a film and print Studio's address
-npx -y @autoaiai/aicut@latest look     # a contact sheet of the whole film, its sound, and a determinism check
-npx -y @autoaiai/aicut@latest look 4.5 # one frame, full size — look at the PNG, not at the code
-npx -y @autoaiai/aicut@latest render   # the MP4, beside film.html
-```
-
-Run the manual before the first film: it is authoritative for the format, and this skill is about the method above it.
-
-Where the words below name another program's part, it becomes this:
-
-| elsewhere | in AICUT |
-|---|---|
-| composition, timeline, project file | `film.html`; tracks and clips inside it |
-| a scene, a sequence, a slide | a page (`pages/<name>.html`) cut onto a track |
-| `useCurrentFrame()`, `interpolate()` | `frame(t)` — the picture depends only on `t`, never on state or `Date.now()` |
-| a still, a screengrab | `aicut look <t>` |
-| `render` / `build` / `export` | `aicut render` (the person can also export from Studio) |
-| a dev server, a preview window | `aicut open` and the Studio address it prints |
-
-Hard rules that hold whatever the method says: the picture depends only on `t`; every value in the person's prompt is
-binding; look at the frames `look` writes before saying a film is done.
-
-
-一个自包含的制作能力库：152 张镜头配方卡（附 demo 实现源码）、一支已验收的
-完整宣传片模板、可复用组件与音频资产、六阶段工作流。
-当前 focus 是 web/桌面产品宣传片，但镜头卡本身是通用动效词汇——
-也可以单独抽卡做任意视频里的单个镜头。
-
-## 调用时先判断模式
-
-完整宣传片有三种互不合并的模式。在开始素材采集、分镜或实现前，先判断用户
-是否已经明确选择；已经选择时直接执行，不重复询问，也不要改成另一种模式。
-
-1. **直接使用模板**：保持 Ink Press 原有替换流程。读 `template/TEMPLATE.md`，
-   按既有镜头结构替换目标产品的截图、文案和品牌信息。
-2. **自主自由创作**：读 `references/pipeline.md`。Agent 根据用户已有要求和项目
-   内容，自主决定视觉方向、镜头映射、分镜、素材和音频，连续推进到成片；不在
-   产品简报、styleframe、镜头映射或分镜阶段暂停等待用户确认。
-3. **共同创作**：读 `references/guided-free-creation.md`。Agent 先提出有依据的
-   判断和方案，由用户依次确认产品简报、需求决策、视觉方向、镜头映射和最终
-   分镜；分镜放行后再进入 `references/pipeline.md` 的最终素材采集与制作阶段。
-
-用户提供了项目路径、网址、录屏或页面截图但尚未选模式时，先做一次**最小、
-只读的产品检查**：了解产品定位、主要功能、页面视觉、可展示状态和素材风险；
-不修改业务项目、不采集敏感数据、不写视频代码。检查后给出三种模式，并说明：
-
-- Ink Press 是否适合该产品、适合与不适合的具体依据；
-- 自主自由创作与共同创作各自是否适合、预计会保留哪些产品视觉线索；
-- Agent 推荐哪一种模式及其依据和取舍。
-
-然后明确询问：**“根据上面的产品检查，我推荐使用 ×× 模式。要按这个模式继续吗？”**
-同时告知用户：152 张镜头卡都在 `references/shots/` 下，按 camera / typography /
-transition / ui-entrance 等类别分目录，可以直接翻目录挑镜头。
-
-用户尚未提供可检查的项目或页面时，简要介绍三种模式再询问；不要仅因 Ink Press
-是现成模板就默认推荐它。
-
-- 用户选择模板：完整阅读 `template/TEMPLATE.md`，按原模板流程执行。
-- 用户选择自主自由创作：完整阅读 `references/pipeline.md`，Agent 自主推进，不逐阶段等待确认。
-- 用户选择共同创作：完整阅读 `references/guided-free-creation.md`，按其中的确认节点协作。
-- 用户尚未决定：停在此处等待选择；不要默认替用户选择，也不要开始制作。
-
-**例外一：用户已点名 Ink Press 模板时，视为模板模式已选定。**
-例如“用 Ink Press 模板给我的产品做宣传片”。此时不要再询问，直接完整阅读
-`template/TEMPLATE.md` 按模板路线执行。
-
-**例外二：用户已明确指定要使用或参考某些镜头卡时，镜头约束已经选定。**
-例如“用 `deck-deal-flyin` 和 `row-embed` 做这支视频”或“参考
-`spotlight-hero-card` 的效果”。此时不要介绍模板、也不要询问是否使用模板；
-按镜头卡名称解析规则确认指定镜头，完整阅读每张卡，并按卡片的“参考实现”
-定位准确 demo 源码。单镜头可在目标素材明确后执行；完整宣传片若尚未说明采用
-自主自由创作还是共同创作，只询问这两种模式，指定镜头作为后续制作约束，不自动
-等同于共同创作。
-
-## 四种用法
-
-1. **完整宣传片（模板路线）**：想要和模板片高度相似的效果 →
-   读 `template/TEMPLATE.md`，按“换产品复现指南”替换素材逐镜头适配。
-2. **完整宣传片（自主自由创作）**：要新风格并授权 Agent 自主决定 → 读
-   `references/pipeline.md`，从产品理解连续推进到终检，中途不逐阶段等待确认。
-3. **完整宣传片（共同创作）**：要参与关键决策 → 读
-   `references/guided-free-creation.md`，确认产品简报、需求决策、视觉方向、
-   镜头映射和最终分镜；放行后从流水线的最终素材采集继续。
-4. **单镜头/单动效**：从 `references/shots/` 选卡（可让用户直接翻类别目录挑），
-   读卡全文并按“参考实现”定位准确 demo 源码，适配到目标素材。
-
-## 自主自由创作与共同创作的边界
-
-**自主自由创作**把创意和工程决策交给 Agent。Agent 从项目内容动态推导产品重点、
-视觉方向、镜头映射、分镜、素材处理与音频方案，记录关键判断后直接执行；除非缺少
-无法安全推断的必要输入，否则不提问、不逐阶段暂停，也不要求用户确认中间产物。
-用户已有的明确要求始终是约束，不能被 Agent 的默认选择覆盖。
-
-**共同创作**才使用逐阶段确认。默认读 `references/guided-free-creation.md`，每轮只问
-1–3 个最能减少返工的问题，并在产品简报、需求决策、视觉方向、镜头映射和最终分镜
-处暂停等待用户确认。用户确认业务与创意方向；Agent 自主完成采集方式、实现参数、
-SFX 钉帧、Remotion 工程、渲染和技术 QA。
-
-共同创作中，用户明确说“你全权决定”或“跳过确认直接做”时，切换为自主自由创作
-并记录这一选择；不要一边声称自主推进，一边继续要求逐阶段确认。
-
-功能到镜头的映射只是“选用哪些运动语法”，不是完整分镜。共同创作确认映射后，
-Agent 必须继续给出镜头顺序、时长、具体画面、页面状态、素材来源、字幕、转场和
-SFX；只有完整分镜确认后才进入最终素材采集。用户给出镜头名时，只需提供卡名
-或“卡名 · 样式名”，Agent 负责读取本地配方卡和 demo 源码。
-
-## 核心理念
-
-1. **复刻既有页面必须用真实截图；手搓 UI 限非复刻场景，且质量与表达
-   明确性是硬门槛。** 表现产品真实页面时第一步就起本地 dev server，
-   用无头浏览器截全页 2x 纹理 + 元素级抠图 + layout.json 坐标表。
-   非复刻场景（抽象开场/品牌段/独立展示组件）允许手搓 UI，但达不到
-   出版级质感或观众看不懂它表达什么，就回截图路线。页面数据按风险处理：
-   公开演示数据只有在产品简报明确确认后才可保留；客户、个人、内部、密钥、
-   实时或其他敏感数据必须用虚构或脱敏内容，且在采集前冻结。
-
-2. **整支视频的视觉语言必须从产品自身生长，不能另造一套不相干的
-   “宣传片皮肤”。** 做 styleframe 前，先从产品/网站的设计系统、源码或
-   computed styles 中提取并写入设计 spec：字体家族与字重、字号层级、
-   行高/字距，栅格、间距、对齐、信息密度与圆角，以及背景/表面/正文/
-   强调/状态色、渐变和材质。片中所有标题、字幕、数字、字卡、版式、
-   转场、粒子、光效和其他动效配色都必须复用或克制扩展这套 tokens，
-   同时匹配产品的调性、品味和质感。走模板或镜头卡路线时，只继承其
-   镜头结构、运动语法、节奏和已调参数；字体、排版、配色与材质必须按
-   目标产品重新蒙皮。若因叙事需要偏离产品视觉，共同创作先说明理由并让用户
-   确认；自主自由创作把理由与取舍写入设计 spec 后继续。
-
-3. **电影感来自运镜、光影、节奏与声音的配合，不来自炫技动画。**
-   被反复认可的是：单主角完整动作弧（聚光→推近→悬浮→归位）、
-   物理隐喻驱动的加速度（发牌）、侧斜机位 orbit 环绕特写、
-   riser→impact→sparkle 的声音句式。批量元素入场靠运动本身，
-   不靠逐个发光——装饰性 glint/泛光群发即廉价，单点高质量光效可做。
-
-4. **每个镜头只讲一个动效；关键信息落定后必须呼吸。**
-   一种动画手法（飞入/堆叠/翻页）全片只当一次主角，重复镜头、重复
-   tagline 一律删。节奏偏好是单向的：历史反馈全部指向"放慢/停留"，
-   从未有一次"太慢了"——品牌字标落定 hold ≥1s、批量动效收尾留 0.5s
-   静止、开场主体动作给足 3s。排时间线时预先给 hold/rest 留帧预算。
-
-5. **强节奏 BGM 的片子，所有转场和动效必须卡在拍上。**
-   BGM 用 `dlazy search_audio` 取（本库不再内置曲库，见 `## dlazy 工具链`）。
-   用户已选好音乐 → 开工前先做节奏分析（librosa 网格拟合求真实
-   BPM/相位 + kick/snare/hihat 三分类鼓点定位），网格按瞬态覆盖率
-   验收通过后才分镜；时间线用拍号 `beatF(n)` 写，稀疏重音钉真实
-   瞬态而非网格插值点，渲后从成片抽音轨回测切点误差 ≤3f。
-   方法论见 `references/music-beat-sync.md`。
-   配了 BGM 的片子终渲固定交付两版：带 BGM 版 + 无 BGM 版（保留 SFX），
-   靠 `bgm` inputProp 从同一时间线渲出，方便用户后期自配音乐。
-
-6. **用镜头卡动效必须先定位准确的 demo 实现代码。**
-   先在 `references/shots/` 下确认卡名与卡内样式名，再按卡片文档的
-   “参考实现”定位具体 TSX。配方卡给的是语义和参数表，准确的 demo 源码
-   才是调校过的参数真相（缓动、时值
-   配比、摘罩时机、已知坑的规避写法）。允许适配性改动，但卡上
-   "已知坑/命门"标注的参数不得降档——质量标准只升不降。凭卡名和
-   理解新写＝放弃全部调校积累。
-
-7. **共同创作把廉价确认物前置，自主自由创作把同样的判断留作执行记录。**
-   产品简报→需求到执行决策表→文字方向→styleframe→镜头映射→分镜的顺序不变；
-   共同创作逐级交给用户确认，自主自由创作由 Agent 自主选定并连续推进。两种模式
-   都不应在方向未定时进入逐镜头实现。
-
-8. **验收贯穿全程 + 交付前独立审查。** 阶段 5 起每个镜头用
-   `npx remotion still` 出静帧自检、每轮修改后整片渲染 + ffmpeg
-   抽帧回看；交付前必须派一个干净上下文的 subagent 做独立终检。审查输入
-   包含成片、关键帧、产品简报、需求到执行决策表、当前模式确认或记录的视觉方向/styleframe、功能到镜头映射、
-   镜头卡名/变体、准确 demo TSX、最终分镜、选中的镜头卡和
-   审美准则；按 `references/final-review.md`
-   同时检查方案一致性、功能完整性、镜头还原度、视觉/音频技术质量和数据安全，
-   逐条出带帧号证据的报告。制作者对自己的产出有确认偏差，首检永远不能交给用户。
-
-9. **确定性渲染**：禁 `Date.now()`/`Math.random()`，一切伪随机固定
-   种子（mulberry32/哈希，seed 从 index 派生），逐帧可复现。
-
-## 工作流
-
-自主自由创作按 `references/pipeline.md` 从阶段 0 连续执行，不逐阶段等待用户确认。
-共同创作先按 `references/guided-free-creation.md` 完成阶段 0–3 的产品理解、视觉方向、
-镜头映射和分镜确认，再从流水线阶段 4 的最终素材采集继续，不得重复提问或重新设计。
-阶段 2–3 扫 `references/shots/` 各卡 frontmatter 按能量曲线选镜头；阶段 5–7 持续
-对照 `references/aesthetic-rules.md` 自检；阶段 6 读
-`references/sound-design.md`；卡点片全程贴 `references/music-beat-sync.md`。
-
-## dlazy 工具链
-
-画面由 Remotion 生成，**音乐、补充音效、旁白、字幕和 B-roll 走
-[dlazy](https://dlazy.com) CLI** —— 一条命令覆盖多家模型，不用自己对接各家 API。
-
-### 准备
-
-```bash
-dlazy login      # 设备码流程，远程终端也能用；key 自动写入 ~/.dlazy/config.json
-dlazy -h         # 列出当前账号可用的全部工具
-```
-```
-也可以不全局安装：`npx @dlazy/cli@1.2.3 <command>`。
-已有 API key 时用 `dlazy auth set <key>`（在
-https://dlazy.com/dashboard/organization/api-key 获取）。
-```
-
-### 速查
-
-| 用途 | 命令 |
-|------|------|
-| BGM（本库不内置曲库） | `dlazy search_audio --query "<mood>"` |
-| 补充音效（自带 149 个不够时） | `dlazy search_audio --query "<sfx>"` 或 `dlazy keling-sfx -h` |
-| 旁白 TTS | `dlazy -h` → 选，再 `dlazy <tts-tool> -h` |
-| 字幕逐词时间轴 | `dlazy fun-asr --audio_url <wav> --format json`（或 `dlazy elevenlabs-stt`），读返回的 `data.words[]` |
-| 补充图片 | `dlazy search_image --query "<关键词>"` 或文生图工具（`dlazy seedream-5.0 -h`、`dlazy jimeng-t2i -h`、`dlazy banana2 -h`）|
-| B-roll 真实运动镜头 | `dlazy -h` → 选一个视频生成工具，再 `dlazy <tool> -h` |
-
-**首次付费调用前先 `dlazy <tool> -h` 确认工具名与参数**——可用工具随账号而变，
-不要凭印象拼模型名。多个独立生成（多镜头、多变体、多音色）并发跑，别串行等。
-
-### 旁白（可选，默认不加）
-
-产品宣传片的默认形态是画面 + 字幕 + 声音设计，不配人声——旁白会挤掉运镜和
-节奏的表现力。只有用户明确要旁白，或片子承担"讲清楚一件复杂事"的任务
-（功能讲解、教程向）时才加，且必须在阶段 3 分镜放行前定下来（旁白长度直接
-决定镜头时长，事后补配等于重排时间线）。要加就走：
-
-1. **选 TTS**：`dlazy -h` 看可用音色工具，跨语言优先多语种模型；先 `-h` 确认参数。
-2. **先试 2 句再全量**：拿分镜里最长和最短的两句渲一遍确认语速音色，
-   再渲全篇存 `public/narration.wav`。
-3. **真实时长回写分镜**：TTS 实际长度几乎不等于估算值——按它重排镜头帧预算，
-   不要让画面先做完再迁就音频。
-4. **字幕**：`dlazy fun-asr --audio_url public/narration.wav --format json` 拿逐词
-   时间轴（媒体字段支持本地路径，CLI 会自动上传），取返回的 `data.words[]`
-   （每项含 `start`/`end`/`text`）喂给 `assets/lib/Caption.tsx`。
-5. **混音**：有旁白时 BGM 压到 0.12–0.18（无旁白是 0.34），SFX 避开人声句子
-   的起止帧。
-
-不加旁白的片子照旧用画面字幕承担解说，别留哑巴段落。
-
-## 何时读哪个文件
-
-| 时机 | 读 |
-|------|----|
-| 项目启动且模式未定 | 最小只读检查，然后提供三种完整宣传片模式并推荐 |
-| 自主自由创作 | pipeline.md（Agent 自主完成阶段 0–7，不逐阶段等待确认） |
-| 共同创作 | guided-free-creation.md（确认阶段 0–3），再从 pipeline.md 阶段 4 继续 |
-| 用户已选 BGM | music-beat-sync.md（先分析再分镜） |
-| 走模板路线 | template/TEMPLATE.md 全文 |
-| 分镜设计 | sequences/ 桥段模板（全片骨架先填空）；shots/ 全部 frontmatter；选中的卡读全文 |
-| 逐镜头实现 | 该镜头卡全文 + 按“参考实现”定位的准确 demo 源码全文 + assets/lib/ 对应组件 |
-| 声音设计 | sound-design.md + assets/audio/ |
-| 验收 | final-review.md + aesthetic-rules.md 全文过 checklist（独立 subagent 执行） |
-
-## 资产使用方式
-
-- `assets/lib/` 组件 **copy 进新项目**后自由修改（不 import 本库）。
-  清单：PageCam（2.5D 页面相机——一切"真实页面"镜头的地基）、DigitRoll、
-  FlashCut、Caption、FlatPanel、VerticalTicker（3D 无限滚动墙）、
-  helpers(rand/shake/camera/motion)。FlatPanel 与 helpers/camera 需要
-  `three` + `@react-three/fiber` + `@remotion/three` 依赖，其余仅需 remotion。
-- `assets/scripts/capture-template.mjs` 复制后改顶部 CONFIG（BASE/路由/选择器）。
-- `assets/audio/` 音效直接复制使用（免费商用授权，见 audio/ATTRIBUTION.md）：
-  `audio/sfx/<类别>/` 149 个音效按场景分 16 类
-  （transition impact riser camera ui text paper film light data scifi mech
-  glass fluid crowd counter），找音先进类别目录，清单见 sound-design.md。
-  词汇表 sparkle 的目录名是 `light/`（无 `sparkle/`）；S1 禁音色不禁动作——
-  画面真有点击/开关就该配拟音，但 `ui/` 里一半是合成反馈音（tone/bleep/
-  notification）需逐个试听、不可整目录放行（名单见 sound-design 3.3）；
-  长样本与轻音素材各有名单需特殊处理（sound-design 4.1）。
-- `demos/` 各卡实现源码：多数为自包含灰阶 demo（部分 import
-  `demos/_fixtures/Fixtures.tsx` 的假 UI 场景件，个别 import
-  `demos/_textures/` 的真实页面纹理），copy 进 Remotion 项目即可跑；
-  个别 demo 用到 `@remotion/motion-blur`（CameraMotionBlur），需
-  `npm i @remotion/motion-blur`，名单见 `demos/README.md`。
-- `template/` Ink Press 的完整镜头结构与场景源码（36.2s / 1085 帧）。
-  **原片截图素材未随本库分发**（那是另一个产品的真实页面），照它的镜头
-  结构做、素材换成目标产品自己的，详见 `template/TEMPLATE.md`。
-  样片没拉也能用，只是没有动态预览。
-
-## Source
-
-Rewritten for AICUT from [`dlazy-ai/ai-product-video`](https://github.com/dlazy-ai/ai-product-video)
-(Apache-2.0), SKILL.md. The method is that skill's own; the way it runs is AICUT's.

package/skills/ai-product-video/references/aesthetic-rules.md

@@ -1,177 +0,0 @@
-# 审美准则（判例式）
-
-来源：多支宣传片实战返工的判例沉淀（成片模板见 `template/`）。
-
-**使用方式**：
-- 每条 = 规则（一句可执行的话）+ 判例（用户原话 / 返工经过）+ 自检问题，三要素缺一不可。
-- pipeline.md 阶段 7 验收时**逐条过一遍**，输出自检报告，格式：`编号 ✓` 或 `编号 ✗(位置)`（位置 = 镜头名/帧号）。
-- 准则可以有意识违反（风格需要时），但每次违反必须写进该项目的说明文档（写明违反了哪条、为什么）。
-- 编号体系：R(节奏) / Q(质感·运镜·构图) / S(声音) / C(文案) / P(流程)，编号一经发布不重排，新增条目只追加。
-
-## 目录
-
-- 节奏（R）
-- 质感、运镜与构图（Q）
-- 声音（S）
-- 文案（C）
-- 流程（P）
-
----
-
-## 节奏（R）
-
-### R1. 关键信息落定后必须呼吸，品牌字标 hold 满 1 秒
-规则：承载信息的元素（字卡/数字/网格全貌）落定后静止 ≥1s 再切镜；呼吸感停顿优先给品牌记忆点（wordmark 落定时刻），不给普通内容卡片。
-判例：用户："第一个标题打出来之后停留一秒"、"不是第一个字卡，我说的是开头和结尾的AI field lab出现的动画，出现后延长停留1秒"。先停错了对象、revert 后重做，定案为开头结尾两处 wordmark 各 hold 满 1 秒。
-自检：每个"想让观众记住的画面"是否有完整静止时刻？停顿给的是品牌/关键信息，还是随手给了普通元素？
-
-### R2. 速度感来自加速度，不是匀速快；群体运动挂物理隐喻，收尾留 0.5s 停顿
-规则：飞入/滚动一律非线性缓动 + 非均匀错峰，匀速运动读作廉价 PPT；大量同类元素入场用"越来越快"的硬加速节拍，最好绑一个物理隐喻（如牌堆发牌），满板后静止 0.5s 再切下一拍。
-判例：用户："卡片不断往下堆叠时，应该越来越快，scroll的速度也越来越快，并在最后停顿0.5秒"、"最后速度也不够快……卡片自动按顺序飞向自己的位置，归位越来越快"。先做成加速 scroll + 0.5s 停顿，再改成发牌式硬加速——抽象 flood 五轮不收敛、换成发牌隐喻一轮通过。
-自检：有没有任何元素在做匀速直线运动？批量入场是否越来越快、末尾有无静止呼吸？
-
-### R3. 节奏宁慢勿快：初版默认放慢一档，主体动作弧 ≥3s，交互演示按真人操作速度
-规则：开场主体动作（聚焦→悬浮→归位一条完整弧线）至少 3 秒；模拟真实交互（打字、筛选、点击）按人真实操作的速度走，观众要能跟着做一遍；排时间线时预留 hold/rest 帧预算——第一版几乎总是偏快。
-判例：全片六次独立反馈全部指向"放慢/停留"，从未有一次"太慢了"的反向反馈。用户："第一个镜头还是太快了，放慢到3秒"、"进入搜索框打字，然后筛选出卡片的过程太快了，放慢一些"。开场几经放慢到 3s macro opening，交互段落改成不慌不忙的 type-and-filter。
-自检：把每个镜头当第一次看：哪里没看清？交互段落自己能不能跟着操作一遍？
-
----
-
-## 质感·运镜·构图（Q）
-
-### Q1. 复刻既有页面必须真实截图；手搓 UI 限非复刻场景且质量/表达达标；数据按风险口径处理
-规则：凡是表现产品既有页面的镜头，第一步就用无头浏览器截真实页面（整页纹理 + 元素级抠图 + 坐标 json），不手搓仿真贴图复刻；非复刻场景（抽象开场/品牌段/页面上不存在的独立展示组件）允许手搓 UI，但质量（出版级质感，对照 Q10 标准）与表达明确性（观众一眼看懂它是什么）是硬门槛，达不到回截图路线。公开演示数据只有在产品简报明确确认后可保留；客户、个人、内部、密钥、实时或其他敏感内容必须先虚构、脱敏或冻结。对手搓素材同样适用该口径。
-判例：用户："我希望的是用真实的页面，然后加入动画"、"不要用真实数据，造一份fake的，不要提到客户名字"。改用真实 dashboard 页面重建，此前一下午手搓纹理复刻版整体作废。修订（2026-07-13 用户裁决）："不一定都要来自真实页面截图，可以手搓UI组件，只是要保证质量和表达的明确性"——判例约束收窄为"不用手搓复刻既有页面"。
-自检：每块 UI 素材：它在复刻既有页面吗？是则必须来自截图；手搓件的质感和表达能过 Q10 级审视吗？源数据是否符合已确认的数据口径，且不含未授权的客户、个人、内部或密钥信息？
-
-### Q2. 3D 透视下 UI 纹理按原生尺寸 rasterize 后缩小使用；文字发糊先查纹理分辨率链路
-规则：3D 场景里的 UI 纹理按显示尺寸的 2–4 倍原生栅格化、在 3D 里向下采样（放大走布局级 CSS zoom 而非 transform scale）；文字模糊先查栅格化路径，别先动相机/DoF。
-判例：用户三轮追打："明显卡片变得模糊了"、"还是不够高清……有像素点的方块"、"第一个镜头的文字清晰度还是没有解决"。先调 DoF 治标无效，改成按原生尺寸 rasterize 拿到真正 4x 锐度，最后把 CSS zoom 推广到全部 3D 页面层根治。
-自检：放大/透视镜头逐帧截图看文字边缘：有没有像素方块？纹理源分辨率是否 ≥ 显示尺寸 2 倍？
-
-技法展开（原 hires-rasterize-3d-text 技法卡沉淀于此，参考实现 template/src/aifl/live/PageCam.tsx）：
-- **根因**：Chromium 对 3D 合成层按 1920 布局宽栅格化再 GPU 放大——内容先降采样后放大必糊，与相机/景深参数无关。
-- **解法**：放大量不走 `transform: scale(zoom)` 而走 CSS `zoom` 属性（布局级缩放），让 Chromium 按放大后的设备尺寸栅格化，从高清源向下采样。坐标要按 `Tx = 960/zoom − cx` 换算保持与平面模式取景一致（PageCam.tsx:100-114 有完整推导），漏换算会跑焦点。
-- **配套**：全页 2x（deviceScaleFactor: 2）、hero 元素单独 4x 元素级截图，推进期 6f 交叉淡入盖住低倍页面纹理（淡入太长会看到两层错位）。
-- **排查顺序**：文字糊 → 先查纹理源分辨率链路（截图倍率→栅格化路径→缩放方式），最后才考虑相机。DoF 只做氛围，永远不是清晰度的解法（实证无效）。验证用逐帧截图裁剪放大看字边缘，肉眼看缩略图发现不了。
-
-### Q3. 镜头要稳：产品宣传片默认不加手持抖动
-规则：亮场 UI 宣传片禁用 handheld shake；相机噪声只在暗场氛围片明确追求纪实感时用极小值，且必须自查渲染帧确认无意外抖动。
-判例：用户："镜头视角很差，而且有小抖动不知道怎么回事"。去掉 handheld shake、重新构图后抖动零投诉；另一支暗场氛围片保留 shake=0.02 未被投诉——适用边界由此划定（推测边界）。
-自检：逐镜头看渲染帧：有没有任何非叙事意图的相机抖动？
-
-### Q4. 高光/扫光特效宁缺毋滥：不群发，一个镜头最多给主角一次，且必须裁进圆角边界
-规则：glint/泛光划过类特效不做群发——批量元素入场靠运动本身而非逐个发光；保留的光效必须被承载元素的 border-radius/overflow 裁剪，光溢出圆角是廉价感的典型来源。光效类技术路径本身不封杀：单点、给主角、实现质量过硬的 sheen/泛光可以做，做完对着渲染帧自问"好看吗"再交。
-判例：用户两次否决："不需要每个卡片都闪烁一下"、"卡片出现时的泛光划过的特效取消，不好看"。据此去掉逐卡 glint、撤掉泛光划过、把 chip 高光扫光裁进圆角边界内。澄清（2026-07-13 用户）：否决针对的是"实现的版本不好看"，"不代表这个技术路径/特效类型就不可行"——群发禁令与圆角裁剪不变，但泛光/扫光类手法可以带着更高实现标准重试。
-自检：数一数全片 glint/sweep 出现次数：有没有超过"主角元素一次"？每处光效是否被圆角裁剪？留下的每处光效，正常速度回放自己看过并觉得好看吗？
-
-### Q5. 开场只给一个主角：单主体 + 完整动作弧，胜过群体群舞
-规则：开场信息宁少而聚焦——一个主角元素、一条完整弧线（聚光→推近→悬浮→描边光→归位），多元素并舞撑不起第一印象。
-判例：用户："第一个镜头，只需要聚焦在一张卡片，并让它更有质感"。开场一夜推倒六次，单卡结构定型后直到成片未再动结构。
-自检：开场镜头有几个"想让观众看"的东西？主角的动作弧是否完整（起-承-落）？
-
-### Q6. 机位服务可读性：信息密集镜头正视，文字特写侧向水平，风格化倾斜逐镜头验证
-规则：风格化机位按镜头逐个决定——叙事/情绪镜头可倾斜，列表/堆叠等信息密集镜头保持正视；含文字的卡片特写用侧向水平机位，避免大角度仰拍/俯拍破坏文字可读性；禁止全局一刀切套用某种机位风格。
-判例：全片统一倾斜化被用户否决"做的并不好……对于内容列表页（模板片中为论文列表）的改动也不好，回滚"，随即单独把列表页 revert 回正视；用户："聚焦到一个卡片……是从左侧拍摄而不是从下方"，改为左侧 hero 机位。
-自检：每个倾斜机位镜头：斜的理由是什么？画面里的文字在这个角度还读得清吗？
-
-### Q7. 物件特写四件套：侧面倾斜角 + 可感知高度 + orbit 环绕 + 反差深色材质背景
-规则：物件/资产特写镜头做足环境戏——侧面倾斜机位、堆叠出可感知的体积高度、镜头绕主体环绕，背景用与主场景反差的深色材质（如拉丝金属），再用拉远同步过渡回主场景。
-判例：用户："镜头应该是倾斜从侧面拍摄，堆叠的项目应该有一定的高度，然后镜头围着堆叠做旋转。真个场景应该是暗色的金属质感背景。然后在镜头拉远，同时出现dashboard背景"。从 pile 特写 orbit 初版做到定稿——暗色拉丝金属背景 + 更高的堆叠 + 环绕运镜。
-自检：特写镜头的主体有没有体积感和环境反差？相机是死机位还是有环绕/拉远？
-
-### Q8. 结尾做成"发布会合影"：全片元素四方飞入围住字标，能量推到全片峰值
-规则：多功能产品的收尾用"全家福"结构——每个已展示过的功能抽一个代表元素多方向飞入定格；规格匹配全片能量峰值（crane 运镜 + 舞台光 + 粒子），初版收尾几乎总是偏保守，默认加码一档。
-判例：用户："各个页面的核心元素从不同方向飞来……形成一个类似于合影的画面"、"加一些更多的特效、动画、运镜……像一个产品发布"。从合影式组装做到发布会级别——crane 运镜、舞台光、金粉。
-自检：结尾是不是全片能量最高点？合影里是否每个已展示的功能都有代表元素？
-
-### Q9. 飞入动画的终点必须是页面布局里的真实槽位，元素不悬浮在页面上方
-规则：元素飞入后要"嵌入"页面（归位到真实格位、扩展滚动流），不落地悬浮其上会显得假。
-判例：用户："研究问题的list应该从空中飞入，嵌入dashboard"、"不要让10张项目卡悬浮其上，而是接着往下scroll，然后排到下面去，不要重叠"。据此让行元素飞入并嵌入布局、把网格改成随滚动延展（近整文件重写）。
-自检：每个飞入元素落定后，它在页面布局里有真实坐标吗？有没有元素永久浮在页面之上？
-
-### Q10. 文档类镜头的 mock 内容要出版级：原生排版、文字铺满、完整版式入镜
-规则：观众会读清屏幕上每个字——文档/报告类镜头的 mock 必须用产品原生排版灌满真实密度的假内容，侧栏/评论栏等版式元素完整入镜；"贴图+标语"级别的假文档整镜头返工。
-判例：用户："周报内容的文字要用和现在排版和风格一致的，只是内容mock，文字内容铺满，且要完整展示左边栏和右边评论栏"（模板片中该镜头为周报页）。初版"贴图+标语"级假文档被整镜头重做，最终版为原生排版全量 mock、双栏完整入镜。
-自检：暂停在文档镜头任意一帧：内容读起来像真的吗？版式（侧栏/评论/页眉）完整吗？
-
-### Q11. 要被读的文字有最低有效字高：字幕 ≥5% 帧高，辅助文字 ≥3%；按最终像素量，不按 fontSize
-规则：1080p 成片按手机/内嵌小窗播放校准可读性——镜头叙事字幕**有效字高 ≥56px（≥5.2% 帧高，推荐 60px 档）**，副标题/统计/URL 等辅助文字 ≥32px（≥3%）；有效字高 = fontSize × 全部祖先 scale × 透视压缩（3D 镜头按 `cos(rotY)` 估算），验收量渲染帧上的实际像素，不看代码里的 fontSize。文字只有两态：**"纹理"**（截图 cutout 里的装饰小字，必须明显虚化/降亮度让观众不去读）或 **"要读"**（达标字号 + 足够对比度，压过浅色背景时配 scrim/投影），不存在"重排了但仍读不清"的中间态——读不到的文字宁可删掉。收尾 URL/行动号召是全片最不该小的一行。
-判例：用户（2026-07-25）："里面有几个镜头，你可以发现它配的字很小……现在那些镜头里面的字太小了，根本就看不见"。审查镜头库介绍片：S1/S2/S4 字幕 38–40px（约 3.5% 帧高）、S6 副句 30px、收尾 URL 25px 全部低于线，其中 S2 面板"为可读性重排"的副标题只给了 19px——重排却没达标即中间态反例；六处统一提到 60/40/34px 档后整改通过。
-自检：抽每个含字幕的镜头一帧缩到 480px 宽（模拟手机小窗）：每句还读得清吗？逐帧量"要读"文字的实际像素高：字幕 ≥56px、辅助 ≥32px 吗？有没有哪块文字处于"想让人读但读不清"的中间态？
-
----
-
-## 声音（S）
-
-### S1. 配乐与音效按"片种"选，不按"事件"选：强鼓点电子底 + 电影系 SFX 词汇，禁游戏音包音色（禁音色不禁动作）
-规则：产品宣传片 SFX 词汇表 = whoosh(运镜)/impact(落地)/riser(铺垫)/sparkle(光效)/transition(转场)，禁用游戏音包音色；BGM 选强鼓点、强节奏的电子底（tech-house 类），候选曲必须垫进成片试听——单听曲子无法判断气质。
-判例：用户："这个配乐和音效都太像游戏了。你帮我找那种鼓点强的，节奏感强的，然后音效要那种典型的产品宣传视频的音效"。用 Mixkit tech-house + whoosh/impact/riser/sparkle 整批替换掉此前引入的全部 Kenney CC0 游戏音；BGM 34 分钟内三易其稿后定稿沿用。
-
-**禁的是音色，不是动作**（易误读，务必分清）：本条否掉的是"合成器 pluck/bloop、卡通弹跳、game-over 音阶"这类游戏音包**质感**，不是"不许给点击配声"。画面里真有点击/开关/碎裂，就该配它的拟音——那是 S4 的要求。判别问句：这个音像**真实世界里那个物件发出的声音**（快门、机械开关、玻璃、纸），还是像**游戏引擎里的反馈提示音**？前者用，后者弃。
-- 模板片自己就用 `click-camera.mp3` 且给了全片最高 SFX 响度 0.6——真实快门声，不是 UI 提示音。
-- **`sfx/ui/` 不是"整目录放行"，恰恰是全库最需要逐个试听的一类**：18 个文件里既有真实物件拟音（`switch-light` `switch-tap` `switch-click-quick`，Mixkit 原名就是 light switch），也有一半以上是合成 UI 反馈音（`ui-confirm-bleep` `ui-confirm-tone` `ui-notify-tech` `ui-success-soft` `ui-tone-quick` `ui-popup-dry` `ui-message-pop` 等，原名 tone/bleep/alert/notification）——**后者正是本条要排除的质感**，除非片子刻意要"系统提示"的叙事。名单与取舍见 sound-design 3.3。
-- `sfx/glass/` 是真实碎裂材质音（4 个），不在禁列。
-
-自检：闭眼只听音轨：像产品发布会预告，还是像手机游戏？BGM 是在成片里试听后选定的吗？每个 UI 类音效，是真实物件质感还是游戏反馈提示音？
-
-### S2. SFX 逐拍钉帧管理；连发音效做双样本交替 + 音量阶梯递减 + 间隔加速，不同响度复读
-规则：SFX 用"帧号 + 音源 + 音量"的声明式表集中管理，逐条注释对应的画面动作，杜绝凭感觉铺音效；同类元素连发时防机枪感靠三招——双样本交替、沿序列音量阶梯递减（如 0.40→0.25 六级）、间隔跟随动画曲线加速，密到糊成一片时让声音淡出成 swoosh（本仓库实证无 playbackRate 变调，防机枪不靠变调）。
-判例：用户："周报左侧栏的每周出现时可以换个音效，能配合每个周的出现的"（模板片中为周报页）。先立起逐拍钉帧的 SFX 帧号表结构（沿用至成片），再做 pluck 双样本交替、间隔 8→3f 加速，最后把 per-week pop 六连发音量做成 0.40→0.25 阶梯递减。
-自检：每条 SFX 是否钉在具体帧号并注释了对应动作？连发段落听起来是"数得出来的节奏"还是机械复读？
-
-### S3. 声音在画面锁定后做；时间线一动，SFX 全表重钉
-规则：BGM/SFX 排在画面结构基本锁定之后；任何改变镜头时长/顺序的修改，收尾动作固定包含"全表 SFX 帧号重对"——音画错位是交付前必查项。
-判例：用户："改完这些后重新调整音效位置以匹配新的时间线"。据此按新时间线（总长 1085f）重钉全表 SFX；教训链：首版 SFX 钉完 11 小时后画面大改导致全表重钉，三次重钉中两次纯属画面返工的连带成本。
-自检：本轮有没有镜头时长/顺序变化？变了的话 SFX 表逐条重对过了吗？
-
-### S4. 拟音优先于装饰音：画面动作配该动作的真实声音，音频裁到与动作严格等长
-规则：画面里发生什么动作就配什么声音（打字画面配键盘声、逐条落入配逐个 pop），泛用 swoosh 盖不住有辨识度的画面动作；长样本按画面段落裁剪（Sequence 截断），时长与动作严格等长。
-判例：用户："周报页面内容出现的时候可以配打字音效"（模板片中为周报页）。据此给文档页揭示配打字机音，keyboard.mp3 按语境裁 24f/44f 两个用途。
-
-操作要点（库里的两份特殊名单，见 sound-design 4.1）：**>5s 的长样本（21 个）必须显式给 `durationInFrames`**，漏给会拖过动作结束；带长尾混响的 impact 例外，让尾音自然衰减。**峰值 <-12dB 的轻音素材（7 个）**：`volume` 是乘法系数，给到 1.0 也只是原样播放，仍会被 BGM 盖住——首选换素材或预归一化，必要时给 >1 的增益并以渲染产物验峰。
-
-自检：每个有辨识度的画面动作（打字/点击/落地）有没有自己的拟音？音效有没有拖到动作结束之后还在响？每条音效在成片里真的听得见吗（轻音素材音量够不够）？
-
----
-
-## 文案（C）
-
-### C1. 文案在画面锁定后按最终镜头重写一遍，纯动画段落也配解说
-规则：初稿文案只是占位——画面定稿后对照成片逐镜头重写；纯动画镜头配短解说 caption，不留"哑巴段落"（品牌收尾镜头除外，保持干净）。
-判例：用户："你根据我现在完整的视频内容，重新写文案的词，我感觉现在的和视频画面不是很匹配，再就是在动画的部分是不是也加一些解说？"。据此重写标题文案，并给实拍镜头补上 caption 解说。
-自检：逐句对照：每句文案和它所在的画面匹配吗？有没有超过 3 秒的无解说动画段落？
-
-### C2. 标语写"团队 + 产品功能名 + 具体收益"，抽象隐喻词一律具体化
-规则：标语要具体、带产品功能名（Paper Radar / weekly report），避免抽象隐喻词（board/place 类泛化口号）；重要功能出场前加一张引导字卡。
-判例：用户逐字改稿："'All your research, one board' 改成'All team's research, one place to go'…'The morning reading'那句改成'Paper Radar, tailored for your morning reading'"；"最后文档页展示前，还应该加个文字画面"（模板片中为周报页）。据此三句逐词替换，并加一张文档页 lead-in 引导字卡。
-自检：每句标语里有没有具体的功能名/收益词？有没有只靠隐喻撑着的句子？
-
-### C3. 3D 镜头里的注记文字活在同一 3D 空间：page-space、同透视、斜拍，大字 + 荧光笔 highlight
-规则：给 3D 场景中的主体配画内注记时，文字必须进同一 3D 空间（页面坐标系、同一台相机透视、translateZ 悬浮 + 落影），平面叠字与场景脱节；样式用大衬线字 + 马克笔 highlight 关键词。
-判例：用户："字在左侧，大一些醒目一下，有highlight，然后字的视角也是3d悬空，并且斜着拍摄的"（第一版平面字卡被否后重做）。改为把 hero-hover 注记放进 3D——页面坐标系斜视、马克笔 highlight。
-自检：3D 镜头里的每块文字：它跟着场景相机动吗，还是贴在屏幕玻璃上？
-
----
-
-## 流程（P）
-
-### P1. 交付前必须自己渲染截帧逐一检查，不把首检交给用户
-规则：每轮修改后先自行渲染关键帧截图逐一检查（构图/抖动/文字锐度/穿帮），必要时用像素级工具（裁剪放大/两帧 diff）自证，再交用户。
-判例：用户第一次看片即质问："你自己有截图检查质量吗？镜头视角很差，而且有小抖动不知道怎么回事"。此后管线里长出 crop/diff/measure 自检脚本与 out/qa/ 逐版本静帧归档，双方进入基于帧的评审。
-自检：这一版交出去之前，我自己看过哪些帧？关键镜头有没有截图证据？
-
-### P2. 参考素材先逐帧拆解成手法清单，再逐镜头判断适配性，不全局套用
-规则：有参考片先抽帧做 motion breakdown（每个动画/转场/特效的实现方式清单）写进 spec，按项目适配性取舍；图片参考描述的是"某一类镜头"的感觉而非全片风格令——落地前逐镜头判断适不适用，改完自查再交。
-判例：用户："从原视频里截取尽可能多的帧……加以复现然后适配到我们的项目，不适合的不用强行适配"——把参考片的 motion breakdown 写进 spec 后连续放行；反例：三张参考图被全局套用为统一倾斜机位，被否"做的并不好……回滚"后逐镜头重做。
-自检：参考素材的每个手法有没有"采用/弃用"的显式决定？有没有把一张参考图当成了全片风格令？
-
-### P3. 指代含糊的反馈先确认对象；改错了整 commit 干净 revert，不在错误版本上打补丁
-规则："第一个标题"式模糊反馈先确认所指再动手；落错对象立即整 commit revert 重来；每个改动保持独立 commit 以便干净回滚。
-判例：用户："不是第一个字卡，我说的是开头和结尾的AI field lab出现的动画"。先理解错、hold 了 card1，8 分钟内干净 revert，再对正确对象重做通过。
-自检：这条反馈的指代对象我确定吗？当前 commit 粒度出了错能一键回滚吗？
-
-### P4. 先列功能清单逐一对应镜头；一种动画手法全片只当一次主角，重复镜头/信息一律删
-规则：开拍前列产品功能清单（dashboard/详情/论文/周报/品牌）逐一映射镜头，核心功能漏拍等于返工；一种手法（飞入/堆叠/翻页）全片只当一次主角；剪辑自查按"这个镜头给了什么新信息"过滤，同一素材/信息全片只出现一次，重复即删。
-判例：用户："其他动画有些同质了。没有充分展示整个网站的特性"、"很不错了，但是没有周报部分的展示？"（模板片中为周报页）——据此补功能镜头；"倒数第二个镜头是重复的项目卡片的镜头，可以去掉了"——据此删掉重复的概览镜头、去重收尾标语。
-自检：功能清单每项都有对应镜头吗？有没有两个镜头在用同一种手法当主角、或讲同一件事？