@autoaiai/aicut 0.1.11 → 0.1.13

package/skills/video-shot-analysis-feishu/SKILL.md

@@ -1,173 +0,0 @@
----
-name: video-shot-analysis-feishu
-description: "视频拉片到飞书多维表格：当用户上传视频并要求拉片、拆镜头、分析分镜、复盘爆款视频、倒推生成分镜提示词或视频生成提示词，并把结果写入飞书表格/Base 时使用。基于 ffmpeg 抽镜头截图，基于 lark-cli 写入飞书 Base。 Runs in AICUT: the film is film.html, a page per shot, drawn by `aicut look` and `aicut render`."
-license: MIT
-source: "wocha-xiaoli/video-shot-analysis-feishu"
----
-
-# 视频拉片到飞书 Base
-
-## 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.
-
-
-把用户上传的视频拆成镜头级记录，分析每个镜头的画面、时长、叙事作用、景别、运镜、声音/字幕，并倒推出可复刻的「生成分镜提示词」和「生成视频提示词」，最后写入飞书多维表格。
-
-## 必用依赖
-
-- 先按任务读取 `lark-shared` 与 `lark-base` skill；如果用户明确要求普通电子表格，再读取 `lark-sheets`。
-- 使用本 skill 的 `scripts/extract_shots.py` 先抽镜头段和代表截图。
-- 用 `lark-cli base +...` 操作多维表格；附件截图必须用 `+record-upload-attachment` 上传，不能手写附件 token。
-
-## 输入判断
-
-最少需要：
-
-- 本地视频路径，或用户上传的视频文件。
-- 飞书目标：Base 链接/token + 表名/table-id；如果用户没有给目标，只问这一项。
-
-如果用户只说“建一个表”，默认创建名为 `视频拉片分析` 的 Base 表。截图里的结构属于 Base，不默认用普通 Sheets。
-
-## 推荐字段
-
-字段顺序按截图习惯设计，新增了倒推提示词字段：
-
-```json
-[
-  {"name":"镜头序号","type":"number","style":{"type":"plain","precision":0}},
-  {"name":"镜头截图","type":"attachment"},
-  {"name":"起止时间码","type":"text"},
-  {"name":"时长","type":"number","style":{"type":"plain","precision":2}},
-  {"name":"概述","type":"text"},
-  {"name":"叙事作用","type":"text"},
-  {"name":"景别","type":"select","multiple":false,"options":[
-    {"name":"远景","hue":"Gray","lightness":"Lighter"},
-    {"name":"全景","hue":"Blue","lightness":"Lighter"},
-    {"name":"中景","hue":"Blue","lightness":"Light"},
-    {"name":"中近景","hue":"Orange","lightness":"Lighter"},
-    {"name":"近景","hue":"Orange","lightness":"Light"},
-    {"name":"特写","hue":"Wathet","lightness":"Lighter"},
-    {"name":"大特写","hue":"Purple","lightness":"Lighter"},
-    {"name":"屏幕录制","hue":"Green","lightness":"Lighter"},
-    {"name":"混合","hue":"Gray","lightness":"Light"}
-  ]},
-  {"name":"画面元素","type":"text"},
-  {"name":"镜头运动","type":"text"},
-  {"name":"转场/剪辑","type":"text"},
-  {"name":"字幕/台词","type":"text"},
-  {"name":"声音/音乐","type":"text"},
-  {"name":"情绪/节奏","type":"text"},
-  {"name":"视觉风格","type":"text"},
-  {"name":"倒推生成分镜提示词","type":"text"},
-  {"name":"倒推生成视频提示词","type":"text"},
-  {"name":"备注/置信度","type":"text"}
-]
-```
-创建字段前必须先 `+field-list` 查看现有字段，缺什么补什么，避免重复建字段。
-```
-
-## 工作流
-
-1. **准备素材**
-   - 确认视频路径存在。
-   - 运行：
-     ```bash
-python3 ~/.config/opencode/skills/video-shot-analysis-feishu/scripts/extract_shots.py \
-       "/path/to/video.mp4" \
-       --out-dir "./lapian_output" \
-       --threshold 0.32 \
-       --min-gap 0.45
-```
-```
-- 输出包括 `shots.json`、`shots.csv`、`frames/*.jpg`、`analysis_prompt.md`。
-
-2. **镜头分析**
-   - 逐张查看代表截图；短视频要尽量逐镜头分析，不要只粗略概括。
-   - 如果同一镜头内信息变化大，必要时回看该片段或补抽帧。
-   - 记录每个镜头：发生了什么、为什么放在这里、怎么引导观众、可复刻的镜头语言。
-
-3. **倒推提示词**
-   - `倒推生成分镜提示词`：写给图片/分镜生成模型，关注静态画面、构图、人物/界面、景别、光线、文字。
-   - `倒推生成视频提示词`：写给视频生成模型，必须包含时间轴、镜头运动、动作、声音/台词、转场和结尾停帧。
-   - 如果画面含中文 UI/字幕，提示词里明确“所有可见文字使用简体中文，禁止英文界面词”。
-
-4. **写入 Base**
-   - 先读取真实结构：
-```
-```bash
-lark-cli base +table-list --base-token <base_token>
-     lark-cli base +field-list --base-token <base_token> --table-id <table_id>
-```
-```
-- 缺字段时按上面的 schema 用 `+field-create` 串行创建。
-   - 对每个镜头先 `+record-upsert` 写非附件字段，拿到 `record_id`。
-   - 再上传截图：
-```
-```bash
-lark-cli base +record-upload-attachment \
-       --base-token <base_token> \
-       --table-id <table_id> \
-       --record-id <record_id> \
-       --field-id "镜头截图" \
-       --file "./lapian_output/frames/shot_001.jpg"
-```
-```
-5. **校验**
-   - 上传后抽查 `+record-list --limit 3`，确认文本字段和附件都存在。
-   - 汇报总镜头数、写入成功数、附件成功数、失败项和飞书链接。
-```
-
-## 分析口径
-
-- `概述`：只写画面事实和主要动作，不写长篇评论。
-- `叙事作用`：解释这个镜头在注意力、信息推进、情绪、信任、卖点展示、转场中的作用。
-- `景别`：从远景/全景/中景/中近景/近景/特写/大特写/屏幕录制/混合中选一个。
-- `镜头运动`：固定、推近、拉远、横移、跟拍、环绕、摇镜、快速切换、屏幕滚动等。
-- `转场/剪辑`：硬切、跳切、闪白、叠化、缩放转场、字幕承接、动作承接、音频承接。
-- `声音/音乐`：口播、BGM、环境音、音效、停顿、重音；听不清就标注“未识别”。
-
-## 长视频策略
-
-- 3 分钟以内：逐镜头完整分析。
-- 3-20 分钟：先自动切镜头，再按段落合并明显重复的屏录/口播镜头，但保留关键转折点。
-- 超过 20 分钟：先输出章节级结构，让用户确认是否继续做逐镜头 Base。
-
-## 失败处理
-
-- ffmpeg 场景检测结果过碎：提高 `--threshold` 到 `0.42` 或提高 `--min-gap`。
-- 场景检测漏切：降低 `--threshold` 到 `0.22`，或用 `--fallback-interval 1.5` 补采样。
-- 截图超过 20MB 附件限制：脚本默认缩到 720px 宽；仍超限就用 `--width 480` 重跑。
-- Base 链接是 `/wiki/`：先用 wiki 节点解析真实 `obj_token`，再作为 `--base-token`。
-
-## Source
-
-Rewritten for AICUT from [`wocha-xiaoli/video-shot-analysis-feishu`](https://github.com/wocha-xiaoli/video-shot-analysis-feishu)
-(MIT), SKILL.md. The method is that skill's own; the way it runs is AICUT's.

package/skills/video-shotcraft/SKILL.md

@@ -1,267 +0,0 @@
----
-name: video-shotcraft
-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 video-shotcraft 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 运镜 + 节奏卡点 + 声音设计）。当用户要求\"用 video-shotcraft 做视频/宣传片\"、把前端项目/网页做成产品视频、点名 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: "kingselyjoe/video-shotcraft-dsh"
----
-
-# video-shotcraft：电影感产品视频制作
-
-## 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/桌面产品宣传片，但镜头卡本身是通用动效词汇——
-也可以单独抽卡做任意视频里的单个镜头。
-
-## DSH 运行约定
-
-- `{skill_dir}` 是当前 `SKILL.md` 所在目录。读取镜头卡、模板、Gallery 索引和资产时，
-  使用 `{skill_dir}/...` 绝对定位，不假设 DSH 当前工作目录就是 skill 目录。
-- 制作代码与渲染产物必须写入用户确认的目标项目/输出目录，不修改 `{skill_dir}` 内的模板
-  真源；需要模板时先复制到目标目录。
-- 浏览器截图、npm 安装、长时间渲染和剪映工程导出前，说明将访问的页面、目标路径和预期
-  产物。不得采集登录凭据、私有客户数据或未授权页面。
-- DSH 的 shell/workspace 工具负责确定性文件与命令操作；涉及并行审片时，只有运行环境
-  确实提供子任务能力才使用，否则在当前任务内完成同一验收清单。
-
-## 调用时先判断模式
-
-完整宣传片有三种互不合并的模式。在开始素材采集、分镜或实现前，先判断用户
-是否已经明确选择；已经选择时直接执行，不重复询问，也不要改成另一种模式。
-
-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 推荐哪一种模式及其依据和取舍。
-
-然后明确询问：**“根据上面的产品检查，我推荐使用 ×× 模式。要按这个模式继续吗？”**
-同时告知用户：可在 `{skill_dir}/gallery/api/library.json` 检索全部镜头卡与样式，
-并从卡片的“参考实现”定位准确的 demo TSX 源码。
-
-用户尚未提供可检查的项目或页面时，简要介绍三种模式再询问；不要仅因 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。
-   方法论见 `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`。
-
-所有模式成片交付后，默认询问用户一次是否需要同时导出**剪映工程文件**
-（可在剪映里改字幕内容/字号/颜色、分镜头变速/重排、调整或替换音频）；
-用户需要或直接点名导出时，读 `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 页面相机——一切"真实页面"镜头的地基）、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`。
-- `jianying-export/` 剪映工程导出模块：`mac_draft.py`（Mac 剪映 11.2
-  实测通过）、`windows_draft.py`（按上游支持路径实现，未真机验证）、
-  `smoke_test.py`（新环境先跑的最小冒烟测试）。流程、时间线提取与建轨
-  方法见 `references/jianying-export.md`；需 venv + `pip install
-  pyJianYingDraft`。
-- `gallery/` 静态镜头索引：运行 `cd gallery && python3 -m http.server 4178`
-  可在本地浏览、搜索并多选复制 152 张卡和 209 个样式名称。仓库不承诺随包提供
-  MP4 预览；没有预览时，以配方卡和准确 demo TSX 源码为准。
-
-## Source
-
-Rewritten for AICUT from [`kingselyjoe/video-shotcraft-dsh`](https://github.com/kingselyjoe/video-shotcraft-dsh)
-(Apache-2.0), SKILL.md. The method is that skill's own; the way it runs is AICUT's.

package/skills/video-shotcraft/docs/deepseek-harness.md

@@ -1,69 +0,0 @@
-# DeepSeek Harness 使用指南
-
-video-shotcraft 以 DSH 原生 filesystem skill 方式运行。安装器会将完整镜头卡、Remotion
-组件、模板和音频资产复制到 `$DSH_HOME/skills/video-shotcraft`，默认是
-`~/.dsh/skills/video-shotcraft`。
-
-## 安装
-
-Windows PowerShell：
-
-```powershell
-git clone https://github.com/kingselyjoe/video-shotcraft-dsh.git
-cd video-shotcraft-dsh
-.\install-dsh.ps1
-```
-
-macOS / Linux：
-
-```bash
-git clone https://github.com/kingselyjoe/video-shotcraft-dsh.git
-cd video-shotcraft-dsh
-bash install-dsh.sh
-```
-
-需要 Python 3.10+ 运行安装管理器，并需要 Node.js、npm、npx 执行 Remotion 工作流。
-
-## 诊断
-
-```bash
-python scripts/dsh_manager.py doctor
-python scripts/dsh_manager.py --json doctor
-```
-
-诊断会检查 SKILL.md、manifest、安装副本、所有权标记和 Node 工具链。
-
-## 使用
-
-```text
-使用 video-shotcraft 检查这个前端项目，推荐适合的宣传片制作模式。
-使用 video-shotcraft 的 Ink Press 模板，为当前产品制作一支 30 秒宣传片。
-使用 video-shotcraft 的 spotlight-hero-card 做一个独立产品特写镜头。
-```
-
-完整视频工作流会创建或修改 Remotion 项目并可能执行浏览器截图、npm 安装和渲染。Skill
-应先确认目标项目目录、输出目录和制作模式；不得读取或拍摄登录凭据、客户数据或未授权页面。
-
-## 本地 Gallery
-
-仓库包含完整镜头索引和静态 Gallery。动态 MP4 不随 Git 仓库分发时，仍可通过镜头卡、
-demo TSX 和本地模板完成选择与实现：
-
-```bash
-cd gallery
-python -m http.server 4178
-```
-
-打开 `http://localhost:4178/library.html`。没有本地 MP4 的卡片以文字说明和源码为准。
-
-## 更新与卸载
-
-```bash
-git pull
-python scripts/dsh_manager.py install
-python scripts/dsh_manager.py doctor
-python scripts/dsh_manager.py uninstall
-```
-
-非本工具管理的同名目录默认不会覆盖。`install --force` 会先生成带 UTC 时间的备份；卸载
-只删除带 `.dsh-package.json` 所有权标记的目录。