@autoaiai/aicut 0.1.11 → 0.1.13

package/skills/chengfeng-check-updates/SKILL.md

@@ -1,283 +0,0 @@
----
-name: chengfeng-check-updates
-description: "剪辑环境的唯一管理者：就绪检查（skills 是否最新 → Runtime 是否配套）、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用；业务 Skill（剪口播/字幕/画面/导出）第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。 Runs in AICUT: the film is film.html, a page per shot, drawn by `aicut look` and `aicut render`."
-license: Apache-2.0
-source: "Agentchengfeng/chengfeng-videocut-skills"
----
-
-# 检查更新（环境总管）
-
-## 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.
-
-
-环境的一切逻辑只写在本 Skill：skills 版本、Runtime 安装与体检。业务 Skill 第 0 步
-一行引用下面的「就绪检查」，自己不带任何环境逻辑——环境策略要变，只改这一个文件。
-本 Skill 不建项目、不打开 Studio、不转录任何媒体。
-
-## 就绪检查（业务 Skill 的第 0 步从这里执行）
-
-三步走完，输出三态之一：**就绪 / 需新会话 / 停**。
-
-### 一、定位当前 Plugin cache（只读）
-
-从 host 提供的**本 Skill 实际源文件路径**定位：本文件所在目录向上两级就是
-`<插件根>`。用文件读取工具确认 `<插件根>/.codex-plugin/plugin.json` 与
-`<插件根>/scripts/check-plugin-update.cjs` 都存在。路径不可取得、目录层级不符或
-文件不存在时，以 `installed_identity_missing` 停止更新比较；不得调用用户
-`CODEX_HOME` 下的 `codex plugin list` 补猜，也不得搜索整个磁盘。
-
-**此后所有命令里的 `<插件根>` 都代入这个字面路径**（含空格时整段引号包住）。
-命令块不用 shell 变量与命令替换——bash 和 PowerShell 的赋值语法互不兼容。
-检查脚本会从自己所在的 cache 直接读取 installed manifest、provenance、Marketplace
-exact revision 与 bundle digest；检查阶段不依赖用户 Marketplace CLI 输出。
-
-### 二、skills 最新吗
-
-```bash
-node "<插件根>/scripts/check-plugin-update.cjs" --marketplace chengfeng-videocut --json
-```
-```
-（Marketplace 名默认 `chengfeng-videocut`；用户自己配过别的名字就用他配的。）
-
-- `current` → 继续第三步
-- `update_available_confirmation_required` → 展示 `installed`、`candidate` 与候选四项：
-  version、40-hex `snapshotRevision`（B）、40-hex `contentRevision`（A）、
-  `publisherChecksum`（SHA-256），停下等用户确认；确认后走下面「激活」节。
-  激活成功 = **需新会话**：会话开始时 skill 文本已载入，中途更新对本会话不生效，
-  请用户新开会话再继续任务
-  - 若同时有 `legacyInstalledIdentity=true`，说明这是历史 0.10.5 到新证明格式的
-    一次性兼容迁移；仍使用同一确认门，不要求用户预先修改 Marketplace ref
-- `marketplace_not_found` / `marketplace_source_untrusted` /
-  `marketplace_ref_unsafe` → 当前用户 Marketplace 缺失、来源不可信或不是 exact
-  40-hex pin；不调用用户 Codex CLI 修复，报告后继续第三步
-- `installed_identity_missing` / `installed_identity_untrusted` → 当前 cache 身份无法
-  安全读取或证明，不猜版本、不激活；报告后继续第三步
-- `installed_context_mismatch` → 当前 Skill 的真实 cache 路径、Marketplace 名或
-  显式 `CODEX_HOME` 不一致；不搜索其他 cache，也不激活
-- `isolated_stage_failed` / `isolated_stage_schema_invalid` /
-  `isolated_cleanup_failed` → 临时候选 stage、CLI schema 或临时目录清理失败；用户
-  HOME 零写入，报告后继续第三步
-- `update_metadata_untrusted` → version + B + A + SHA-256 证明不成立，不激活；
-  报告后继续第三步
-- `candidate_older_than_installed` → 禁止降级，报告后继续第三步
-- 网络不可达或其他检查错误 → 向用户说明一句，带当前 Runtime 检查继续第三步——
-  **更新检查失败不阻塞干活**
-
-正常检查只允许在临时 `CODEX_HOME` 中用官方 `stable` 发现候选；对用户
-`CODEX_HOME` 不调用任何 `codex` 命令，也不写配置、Marketplace 或 cache。
-当前 cache 的版本目录必须全部是 strict semver；允许残留较低版本，但只把唯一最高
-semver 优先级视为 active。若最高位置存在同优先级目录，返回
-`installed_identity_untrusted`，不得按目录名字面顺序挑选。
-```
-
-### 三、Runtime 配套吗
-
-```bash
-node "<插件根>/scripts/ensure-runtime.cjs" --install-if-missing --json
-```
-```
-- `ready` → **就绪**，业务 Skill 继续
-  - `runtime.kind=desktop-managed` 表示桌面 App 已把随包 Runtime、Bun、FFmpeg 和
-  - `runtime.kind=managed/path/source` 仍是兼容的 CLI 安装来源；后续业务合同相同
-- missing：脚本只提示一次「正在从 GitHub Release 安装」，SHA-256 校验完成后自动续跑
-- `runtime_unhealthy`、安装失败或安装后 doctor 失败 → **停**，报告结构化诊断。
-  **停止就是停止：禁止用自制的审核页、播放器、时间线或任何替代界面继续流程。**
-  产品不可用时做出的任何产出都不可信（真实案例：Runtime 缺失时 Agent 手搓了一个
-  「审片台」网页，其审核决定与产品的账本格式完全不兼容，用户白做一遍）。
-  正确动作只有一个：把结构化诊断给用户，指引安装或上报 Issue
-- `runtime_capability_missing` → **停**：Runtime 健康但低于合同要求。报告两个版本号
-  与差异，指引用户确认后升级（升级替换 `~/.chengfeng-videocut/app`，项目数据不动）；
-  用户未确认前不动现有安装，禁止回退旧剪辑链
-- 就绪检查阶段禁止启动服务、打开 Studio 或创建项目
-```
-
-### 机器前置依赖
-
-支持 **macOS** 与 **Windows 10/11**，分两条安装路径：
-
-```text
-桌面版（推荐）
-  安装并至少启动一次 Chengfeng VideoCut
-  -> App 随包安装 Bun、FFmpeg、FFprobe 和 Runtime
-  -> 不要求用户把这些工具加入系统 PATH
-  -> Skills 通过 ~/.chengfeng-videocut/bin 的稳定入口复用同一服务
-
-纯 CLI 安装
-  macOS     brew install bun ffmpeg
-  Windows   winget install Oven-sh.Bun Gyan.FFmpeg
-            装完新开一个终端/会话，PATH 才生效
-```
-两条路径都仍需要 Node.js ≥ 20 来执行 Plugin 脚本；导出字幕/动画仍需要 Google
-Chrome。纯 CLI 用户自行安装，Windows 可用
-`winget install OpenJS.NodeJS.LTS Google.Chrome`。缺项时必须明确停止，不静默跳过。
-
-Skills 更新身份自证还需要 Git；Windows 可用 `winget install Git.Git`。Git 不可执行或
-无法读取官方 snapshot 的 origin/HEAD/提交关系时，更新检查 fail-closed，但仍按上面
-规则继续 Runtime 检查。
-
-云端转录另需火山引擎凭证：`node "<插件根>/scripts/videocut-cli.cjs" config set transcription.apiKey <key>`。
-
-详细协议见 [Runtime 与产品契约`runtime-and-product-contract.md`。
-```
-
-## Skills 更新：inspect 与激活
-
-纯查看只读当前 Plugin cache：不联网、不调用 `codex`，也不写用户
-`CODEX_HOME`：
-
-```bash
-node "<插件根>/scripts/check-plugin-update.cjs" --marketplace "<市场名>" --inspect --json
-```
-```
-成功返回 `inspected_no_refresh`，只含当前 pinned Marketplace 与 cache 身份，不生成
-远端候选。
-
-联网隔离检查（用户明确说「检查更新」，或就绪检查第二步）：
-```
-```bash
-node "<插件根>/scripts/check-plugin-update.cjs" --marketplace "<市场名>" --json
-```
-```
-- `current`：报告 installed 与临时环境发现的最新发布身份。
-- `update_available_confirmation_required`：展示 installed 与候选四项 version、
-  `snapshotRevision`（B）、`contentRevision`（A）、`publisherChecksum`；停止等用户确认。
-- `legacyInstalledIdentity=true`：当前是兼容的历史 0.10.5 cache。它可以进入上一条
-  正常确认流程；旧身份由 Marketplace exact revision、cache 目录版本、manifest
-  version 与 inventory digest 共同绑定。不要让用户先改 ref，也不要另造一个
-  “迁移成功”状态。
-- `marketplace_not_found` / `marketplace_source_untrusted` /
-  `marketplace_ref_unsafe`：当前用户 Marketplace 缺失、不可信或没有固定到自身 exact
-  40-hex revision；不自动改 ref。
-- `installed_identity_missing` / `installed_identity_untrusted`：当前 cache 不可识别或
-  不可信，不猜 installed 版本。
-- `installed_context_mismatch`：脚本执行位置不是当前 Marketplace 的唯一最高 active
-  cache，或显式 `CODEX_HOME` 与该 cache 所属 HOME 不一致；不跨目录补猜。
-- `isolated_stage_failed` / `isolated_stage_schema_invalid` /
-  `isolated_cleanup_failed`：只说明临时 stage、CLI JSON schema 或清理失败，不暗示
-  用户安装已刷新。
-- `update_metadata_untrusted`：临时 snapshot 缺 B、A、SHA-256/清单复算证明，或
-  manifest、Marketplace revision 与 provenance 的身份互相矛盾。
-- `candidate_older_than_installed`：禁止从较新本地版本降级。
-- 任何 snapshot/parse/version 错误：保留结构化 JSON；用户 HOME
-  `userMutationPerformed=false`。
-
-脚本只在新建的临时 `CODEX_HOME` 中执行官方 Marketplace CLI：先用
-`marketplace add Agentchengfeng/chengfeng-videocut-skills --ref stable` 建立发现源，
-再在同一临时 HOME 内用 `marketplace upgrade` materialize snapshot，并以
-`plugin list` 取得候选。`stable` 解析得到的 40-hex B、provenance 中的 40-hex A、
-manifest version 和可重算 SHA-256 共同构成候选。Git 还必须证明临时 Marketplace
-origin 是官方仓库、HEAD=B、A 是 B 的祖先、Plugin 工作树干净，且 A→B 的 Plugin
-子树只改变 provenance。临时目录使用后删除。用户 HOME 的 Marketplace 必须保持在
-之前确认的 exact B；检查阶段对它连只读 `codex` 命令也不调用。
-
-Windows 上解析 `codex` / `git` 时先按 `PATHEXT` 查找可执行扩展名，再尝试无扩展名
-文件；`.cmd` / `.bat` 经 `ComSpec` 包装。因此 pnpm 同目录的 Unix `codex` shim
-不会遮蔽 `codex.cmd`。
-```
-
-### 用户明确确认后才激活
-
-确认必须发生在用户已看见 exact candidate version、B、A 与 checksum 之后：
-
-```bash
-node "<插件根>/scripts/check-plugin-update.cjs" --marketplace "<市场名>" --activate --confirmed --expected-version "<展示过的版本>" --expected-snapshot-revision "<展示过的B>" --expected-content-revision "<展示过的A>" --expected-sha256 "<展示过的包SHA256>" --json
-```
-```
-脚本必须重新创建临时 `CODEX_HOME`，再次从 `stable` stage 候选，并把四项与
-`--expected-*` 全部比较。stage 前后候选漂移或参数不符返回
-`confirmation_mismatch`，用户 HOME 零写入。通过后记录更新前的 exact
-snapshot revision 与 cache 身份，再只用官方命令对用户 HOME 执行：
-```
-```text
-plugin marketplace remove <市场名>
-plugin marketplace add Agentchengfeng/chengfeng-videocut-skills --ref <B>
-plugin marketplace upgrade <市场名>
-```
-`<B>` 必须是刚刚重新 stage 并与用户确认一致的 40-hex
-`snapshotRevision`；`stable`、其他分支、tag、短 SHA 或任意不同 ref 都返回
-`marketplace_ref_unsafe`。upgrade 后脚本直接从 cache 复读并验证 version + B + A +
-SHA-256，完全一致才返回 `activated`。激活成功后告知用户重启 Codex 或新开会话。
-缺少 `--confirmed` 时返回 `confirmation_required`；任一 expected 字段缺失、不同或
-重新 stage 后漂移时返回 `confirmation_mismatch`，两者都保持用户 HOME 零写入。
-
-进入第一条写命令前，脚本以 CAS 再复读用户 Marketplace 与 active cache。若与
-stage 前保存的旧身份不同，返回 `activation_state_changed`，激活不开始且用户 HOME
-零写入。写事务任一步失败时，脚本先检查 Marketplace 与 cache 的后置状态：
-
-- `activation_failed_no_change`：失败后仍完整等于旧身份；无需回滚，
-  `userMutationPerformed=false`
-- `activation_failed_rolled_back`：候选激活失败，但旧 exact revision 与旧 cache
-  已完整恢复
-- `activation_cache_locked_rolled_back`：失败被识别为 cache/文件句柄占用，且旧状态
-  已完整恢复
-- `activation_failed_rollback_incomplete`：回滚失败，或无法证明 Marketplace 与
-  cache 都回到旧身份；报告实际后置状态并停止
-
-只有后置状态已变化时，才用保存的 old exact revision 执行官方 remove → add
-`--ref <old B>` → upgrade 回滚，并再次直接复读 cache。以上失败状态都不能说
-“已更新”。不得手工复制或删除 cache 来伪造成功；不得触碰
-Runtime、项目、媒体、EDL 或 Studio 状态。
-```
-
-## 用户说「安装剪辑环境 / 装播放器 / 检查环境」
-
-直接跑完整就绪检查；拿到「就绪」后再跑完整自检并原样报告：
-
-```bash
-node "<插件根>/scripts/videocut-cli.cjs" doctor --json
-```
-```
-报告：Runtime 版本与位置、doctor 每项检查结果、缺失项的修法（机器依赖指引安装；
-转录凭证指引 `node "<插件根>/scripts/videocut-cli.cjs" config set transcription.apiKey <key>`）。
-若 `runtime.kind=desktop-managed`，明确说明 Bun/FFmpeg/FFprobe 来自桌面包且无需
-修改系统 PATH。装好后告诉用户：直接说「剪口播」就能开始。
-```
-
-## 边界
-
-- Plugin 版本与 Runtime 版本相互独立；Runtime 的最低兼容与 Release 目标由
-  `runtime-requirements.json` 合同控制，不在本文硬编码任何版本号
-- `stable` 只用于临时发现；不把它写成用户安装的持久 ref，也不把临时 staging、
-  legacy cache 或本地目录说成已激活版本
-- 检查更新阶段对用户 HOME 零 Codex 调用、零写入；只有看见并确认 version + B + A +
-  SHA-256 后才能开始可回滚激活
-- 不发布、不改项目数据或媒体；用户确认后的官方 Codex activation 与 Runtime
-  安装是仅有的写入例外
-- 不搜索 Electron `.app`、NSIS 安装目录或把 Electron 资源路径交给业务 Skill；
-  桌面 App 负责写入稳定 Product 入口，Skills 只认该入口
-
-## Source
-
-Rewritten for AICUT from [`Agentchengfeng/chengfeng-videocut-skills`](https://github.com/Agentchengfeng/chengfeng-videocut-skills)
-(Apache-2.0), plugins/chengfeng-videocut/skills/chengfeng-check-updates/SKILL.md. The method is that skill's own; the way it runs is AICUT's.
-
-The repository holds 7 skills; this is the one its entry stands for.

package/skills/cinematic-product-promo-skill/SKILL.md

@@ -1,295 +0,0 @@
----
-name: cinematic-product-promo-skill
-description: "Create cinematic product promo videos with AICUT, shot recipe cards, real page captures, 2.5D camera moves, beat-synced cuts, reusable code/audio assets, and a validated template. Use when the user asks to turn a frontend project or webpage into a polished product video, invokes cinematic-product-promo-skill, names the Ink Press template, or wants a shot card's motion. 用 AICUT、镜头配方卡、真实页面截图、2.5D 运镜、节奏卡点、可复用代码/音频资产与已验收模板制作电影感产品宣传片；适用于把前端项目或网页做成产品视频、调用 cinematic-product-promo-skill、点名 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: "kiki-lgtm-dot/cinematic-product-promo-skill"
----
-
-# cinematic-product-promo-skill：电影感产品视频制作
-
-## 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.
-
-
-> 本 Skill 是 [Vincentwei1021/video-shotcraft](https://github.com/Vincentwei1021/video-shotcraft)
-> 的重命名发行版。核心方法、镜头卡、模板和素材仍归原项目作者及各素材权利人所有；
-> 本发行版仅调整名称与安装元数据，详见 `NOTICE`、`LICENSE` 和素材归属文件。
-
-一个自包含的制作能力库：157 张镜头配方卡（附 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 推荐哪一种模式及其依据和取舍。
-
-然后明确询问：**“根据上面的产品检查，我推荐使用 ×× 模式。要按这个模式继续吗？”**
-同时告知用户：可前往 https://vincentwei1021.github.io/video-shotcraft/
-浏览动态样片，并挑选希望在视频中使用的动效镜头。
-
-用户尚未提供可检查的项目或页面时，简要介绍三种模式再询问；不要仅因 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` 的效果”。此时不要介绍模板、也不要询问是否使用模板；
-按 Gallery 名称解析规则确认指定镜头，完整阅读每张卡，并按卡片的“参考实现”
-定位准确 demo 源码。单镜头可在目标素材明确后执行；完整宣传片若尚未说明采用
-自主自由创作还是共同创作，只询问这两种模式，指定镜头作为后续制作约束，不自动
-等同于共同创作。
-
-## 四种用法
-
-1. **完整宣传片（模板路线）**：想要和模板片高度相似的效果 →
-   读 `template/TEMPLATE.md`，按“换产品复现指南”替换素材逐镜头适配。
-2. **完整宣传片（自主自由创作）**：要新风格并授权 Agent 自主决定 → 读
-   `references/pipeline.md`，从产品理解连续推进到终检，中途不逐阶段等待确认。
-3. **完整宣传片（共同创作）**：要参与关键决策 → 读
-   `references/guided-free-creation.md`，确认产品简报、需求决策、视觉方向、
-   镜头映射和最终分镜；放行后从流水线的最终素材采集继续。
-4. **单镜头/单动效**：从 `references/shots/` 选卡（或让用户在
-   `gallery/` 画廊里挑），读卡全文并按“参考实现”定位准确 demo 源码，
-   适配到目标素材。
-
-## 自主自由创作与共同创作的边界
-
-**自主自由创作**把创意和工程决策交给 Agent。Agent 从项目内容动态推导产品重点、
-视觉方向、镜头映射、分镜、素材处理与音频方案，记录关键判断后直接执行；除非缺少
-无法安全推断的必要输入，否则不提问、不逐阶段暂停，也不要求用户确认中间产物。
-用户已有的明确要求始终是约束，不能被 Agent 的默认选择覆盖。
-
-**共同创作**才使用逐阶段确认。默认读 `references/guided-free-creation.md`，每轮只问
-1–3 个最能减少返工的问题，并在产品简报、需求决策、视觉方向、镜头映射和最终分镜
-处暂停等待用户确认。用户确认业务与创意方向；Agent 自主完成采集方式、实现参数、
-SFX 钉帧、Remotion 工程、渲染和技术 QA。
-
-共同创作中，用户明确说“你全权决定”或“跳过确认直接做”时，切换为自主自由创作
-并记录这一选择；不要一边声称自主推进，一边继续要求逐阶段确认。
-
-功能到镜头的映射只是“选用哪些运动语法”，不是完整分镜。共同创作确认映射后，
-Agent 必须继续给出镜头顺序、时长、具体画面、页面状态、素材来源、字幕、转场和
-SFX；只有完整分镜确认后才进入最终素材采集。用户从 Gallery 复制镜头名时，只需
-提供卡名或“卡名 · 样式名”，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 的片子，所有转场和动效必须卡在拍上。**
-   用户已选好音乐 → 开工前先做节奏分析（librosa 网格拟合求真实
-   BPM/相位 + kick/snare/hihat 三分类鼓点定位），网格按瞬态覆盖率
-   验收通过后才分镜；时间线用拍号 `beatF(n)` 写，稀疏重音钉真实
-   瞬态而非网格插值点，渲后从成片抽音轨回测切点误差 ≤3f。
-   卡拍管的是时机不是幅度——作用于整画面/相机层的节拍冲击视同
-   大 slam，全片 ≤3 处（aesthetic-rules R4），其余拍点动效只动元素层。
-   方法论见 `references/music-beat-sync.md`。
-   配了 BGM 的片子终渲固定交付两版：带 BGM 版 + 无 BGM 版（保留 SFX），
-   靠 `bgm` inputProp 从同一时间线渲出，方便用户后期自配音乐。
-
-6. **用镜头卡动效必须先解析 Gallery 索引并读准确的 demo 实现代码。**
-   先用 `gallery/api/library.json` 校验卡名与 `style-key`，再按卡片文档的
-   “参考实现”定位具体 TSX。配方卡给的是语义和参数表，准确的 demo 源码
-   才是调校过的参数真相（缓动、时值
-   配比、摘罩时机、已知坑的规避写法）。允许适配性改动，但卡上
-   "已知坑/命门"标注的参数不得降档——质量标准只升不降。凭卡名和
-   理解新写＝放弃全部调校积累。
-
-7. **共同创作把廉价确认物前置，自主自由创作把同样的判断留作执行记录。**
-   产品简报→需求到执行决策表→文字方向→styleframe→镜头映射→分镜的顺序不变；
-   共同创作逐级交给用户确认，自主自由创作由 Agent 自主选定并连续推进。两种模式
-   都不应在方向未定时进入逐镜头实现。
-
-8. **验收贯穿全程 + 交付前独立审查。** 阶段 5 起每个镜头用
-   `npx remotion still` 出静帧自检、每轮修改后整片渲染 + ffmpeg
-   抽帧回看；交付前必须派一个干净上下文的 subagent 做独立终检。审查输入
-   包含成片、关键帧、产品简报、需求到执行决策表、当前模式确认或记录的视觉方向/styleframe、功能到镜头映射、
-   Gallery 卡名/变体、准确 demo TSX、Gallery 参考样片/抽帧、最终分镜、选中的镜头卡和
-   审美准则；按 `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`。
-
-### 交付收尾（所有模式共用）
-
-成片交付后，在最后按 1-2-3 依次说这三件事，每件只说一次，用户拒绝或
-不回应就不再提：
-
-1. **发布时推荐（非强制）在简介 @ 一下本 skill 作者**：成片归用户自己所有，
-   免费商用、不强制署名；@ 作者纯自愿，发到社交平台时在简介带一句即可——
-   X [@VincentWei93](https://x.com/VincentWei93) ·
-   抖音 [@Vincent](https://www.douyin.com/user/MS4wLjABAAAAK1pkjBxilk2Oi_9h_vFyD-lTAu9CTlvhmOtkosDvvxg) ·
-   小红书 [@Vincent](https://xhslink.cn/m/At9iP2d5C1V)
-   （三个账号都要贴出可点的链接，不能只给 handle——抖音/小红书的名字搜不到人）。
-   用户问到商用授权时才补一句：唯一要自行确认的是渲染引擎
-   [Remotion 的独立许可](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md)，
-   个人与小团队免费、公司可能需要付费。
-2. **邀请把成片放到作品展示页**：展示页
-   https://vincentwei1021.github.io/video-shotcraft/showcase.html ，
-   提交入口（点开就是一张表单）
-   https://github.com/Vincentwei1021/video-shotcraft/issues/new?template=showcase.yml 。
-   吸引点说两句：表单里可以留自己的 X / 抖音 / 小红书账号，别人看到作品就能
-   顺着找到用户；视频不大（10MB 以内）直接拖进表单，大文件贴一个能直接下载的
-   链接，作者看过之后就会帮他上线。**这条全程用日常语言说**，不要出现 issue、
-   模板、标签、release、自动化流水线之类的技术词。
-3. **可以导出剪映工程文件**：告诉用户成片还能导成剪映工程，在剪映里自己改
-   字幕内容/字号/颜色、给分镜头变速或重排、调整或替换音频。用户需要或直接
-   点名导出时，读 `references/jianying-export.md` 执行。
-
-## 何时读哪个文件
-
-| 时机 | 读 |
-|------|----|
-| 项目启动且模式未定 | 最小只读检查，然后提供三种完整宣传片模式并推荐 |
-| 自主自由创作 | 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 执行） |
-| 成片交付后（剪映工程导出） | jianying-export.md + `jianying-export/` 平台模块 |
-
-## 资产使用方式
-
-- `assets/lib/` 组件 **copy 进新项目**后自由修改（不 import 本库）。
-  清单：PageCam（2.5D 页面相机——一切"真实页面"镜头的地基）、ClipCard（把外部
-  视频素材 mp4 包成可被镜头卡运镜骨架驱动的"卡片主角"，含 OffthreadVideo
-  交叉淡化循环——素材短于镜头时无缝续播）、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/bgm/` 是节奏感强的 BGM 备选；`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/` 完整可渲染工程：`npm install && npx remotion render
-  src/index.ts AiflPromo out/promo.mp4`。
-- **测试（仓库内自动验证，新增 demo/组件后跑）**：
-  - 纯函数单测：`npm test`（仓库根 vitest，覆盖 `assets/lib/helpers` 的
-    mulberry32 / velocityAt / lagged / dampedSettle / handheld，确定性断言）。
-  - demo 渲染冒烟：`python3 assets/scripts/smoke-render-demos.py` 渲染每个
-    带时长导出 demo 的首帧断言不崩（需 `cd template && npm ci` +
-    motion-blur，详见 `demos/README.md` 测试与验证一节）。
-  - CI（`pr-checks.yml`）已自动跑：tsc 严格编译全部 demo + vitest + 冒烟渲染。
-- `jianying-export/` 剪映工程导出模块：`mac_draft.py`（Mac 剪映 11.2
-  实测通过）、`windows_draft.py`（按上游支持路径实现，未真机验证）、
-  `smoke_test.py`（新环境先跑的最小冒烟测试）。流程、时间线提取与建轨
-  方法见 `references/jianying-export.md`；需 venv + `pip install
-  pyJianYingDraft`。
-- `gallery/` 静态画廊：优先直接给用户在线版
-  https://vincentwei1021.github.io/video-shotcraft/library.html ；
-  本地跑则先 `gallery/fetch-media.sh` 拉样片（mp4 不在 git 里），再
-  `cd gallery && python3 -m http.server 4178`。157 卡 214 条动态样片
-  可浏览/搜索/多选复制卡名——适合让用户看着样片挑镜头。
-
-## Source
-
-Rewritten for AICUT from [`kiki-lgtm-dot/cinematic-product-promo-skill`](https://github.com/kiki-lgtm-dot/cinematic-product-promo-skill)
-(Apache-2.0), SKILL.md. The method is that skill's own; the way it runs is AICUT's.