Arranque 動畫 (Arranque motion)
從儲存庫根目錄開始操作,並確保已安裝 Node 24 及其相依套件。實作人員須遵循閘門流程;導演在核准前須驗證評分表。保留 S01/S02 作為已核准的參考依據。僅實作用戶授權的場景。
在參考資料中,repo:path#symbol 表示相對於根目錄的檔案及其匯出項目;請在本機端開啟該檔案。參考資料/腳本/資產的連結均相對於此技能所在目錄。
單一來源:.agents/skills/arranque-motion/ (Codex 探索路徑)。Claude Code 透過 .claude/skills/arranque-motion 連結 (junction) 來探索此技能;若在新克隆的儲存庫中缺少此連結,請執行 enlazar-skills。僅編輯單一來源;請勿將此內容複製到其他檔案,也勿編輯 skills-lock.json(該檔案記錄遠端技能)。
0. 合約 (Contract)
歷史外部規格 ../SO-ARR-BIOS-001 v2.0.0.md(§8 場景、§9、§12 及技術操作)為選用的作者編寫背景資訊,不包含在此儲存庫中。若在新克隆的儲存庫中進行檢查,請使用本機合約及 tests/fixtures/boot-contract.json 作為對話/分鏡參考資料。請閱讀 src/arranque/escenas.ts (ContratoEscena/ESCENAS)、tiempo.ts、dialogo.ts、subtitulos.ts、anclas.ts、recursos.ts、audio.ts(位於 src/arranque/ 下),以及 docs/arranque/README.md / VOCES.md。
根據 BIOS 基準檢查輸入、輸出、持續時間、角色與前置條件。若缺少合約/提示 (cue),請在生成授權場景前先建立它。使用完整單字在片段內新增 ANCLAS_VISUALES;執行 node tests/validar-h02.mjs。
通過條件: 可追溯的合約、不重疊的相對提示、錨點 (anchors) 存在且嚴格按場景順序排列。請閱讀信號與能量。
1. 節拍表 (Beat sheet)
將範本複製到審查記錄中。填寫 節拍 → 技術事實(來自規格,A0x 或 B/C/D,取決於階段) → 動作 → 錨點詞彙 → 使用 anclasDeEscena 計算的影格。將預期、反應與穩定與每個動作關聯。請審查表演與攝影機。
使用 node .agents/skills/arranque-motion/scripts/buscar-camara.mjs --help;使用說話者與目標區域(前方目標 / 後方目標)執行搜尋工具。
通過條件: 每個動作都說明一個事實;無幻燈片風格的視覺元素:米色背景、卡片、靜態面板、時間標籤或標題。導演可以將每個節拍與其詞彙/影格進行比較。
2. 實作 (Implementation)
閱讀確定性架構。首先產生計畫:
node .agents/skills/arranque-motion/scripts/nueva-escena.mjs --id S03 --nombre "第一道指令" --componente S03PrimeraInstruccion --dry-run
生成器僅為授權場景在 src/arranque/ 下建立純粹的 cine/guion/Sxx.ts 與 escenas/SxxNombre.tsx。它會輸出註冊條目;不會修改 Root。骨架缺乏已核准的編排:將範例攝影機/狀態替換為前一剪接。在 src/Root.tsx 中註冊,置於對應里程碑的資料夾內,保留 CRLF;在 src/arranque/anclas.ts 中新增錨點,並在 src/arranque/cine/guion/registro.ts 中新增條目/連結,以供 validar-cine 與其他工具使用。
重複使用 Mundo3D、Actor、SubtituloCine、CapaAudio、useCoreografia;capas 提供 trazar/puntoEn/dParcial、SenalViajera、OndaAlterna、FlujoContinuo 與 FiltrosBrillo;instrumentos 提供 Trazas/escalon/subidaEstabilizada。Actor 提供 manoEnPantalla/anguloVentilador。請查閱參考資料以取得實際簽名與來源。
通過條件: 腳本獨立於 DOM 與 React;f 將影格轉換為秒;共享的投影攝影機;持續的狀態與角色在剪接處連結。請勿修改吉祥物檔案或相依項目。
3. 數值驗證 (Numerical validation)
node tests/validar-cine.mjs
node tests/validar-h02.mjs
npx --no-install tsc
npx --no-install eslint src
通過條件: 所有指令退出碼為 0。validar-cine 遍歷影格、測量完整說話者 ≥200 像素、色帶 y≤885、使用亂序搜尋測試確定性,以及檢查已註冊的連結。h02 檢查合約、對話、字幕、錨點、技術值與音訊。tsc/eslint 檢查整合性。這些檢查不能取代視覺檢查。
4. 渲染與檢查 (Render and inspection)
閱讀效能與渲染。在主機端:
node .agents/skills/arranque-motion/scripts/revisar-escena.mjs --composicion MacroEncendido --anclas --secuencias --video --escala 0.5 --dry-run
node .agents/skills/arranque-motion/scripts/revisar-escena.mjs --composicion MacroEncendido --anclas --secuencias --video --escala 0.5
審查工具 將 PNG、分頁式 HTML/Chrome 工作表、選擇性 MP4、索引與清單(影格、雜湊值、引數)儲存在 out/revision/COMPOSICION/FECHA-HORA/ 中。預設包含錨點、開始/結束與剪接的兩側。檢查動作周圍完整的 ±radius 序列;展開 radius 或影格以納入預期與穩定。在迭代時重複使用 --bundle RUTA;然後使用 --escala 1 --video --bundle RUTA 產生 1080p。若需在不渲染的情況下產生 HTML,請使用 --hoja manifest.json 搭配現有 PNG。
通過條件: 每個錨點/剪接都有證據;每個動作都有序列,並且預覽與 1080p 版本皆已審查。在此 GPU 上將一個影格渲染兩次並比較 SHA-256。在沙盒中,請勿執行 Remotion CLI(esbuild Access denied);請勿取代 bundler/renderer 的匯入。將計畫交付給主機,並將渲染標記為待辦。
5. 評論與修正 (Critique and correction)
逐項應用評分表:在節拍表中記錄 PASS/FAIL 及證據檔案/影格。修正失敗項目並對受影響區域重複閘門 3–5,直到所有項目通過。若缺少影片、對比度測量或導演驗證,請勿宣告核准。
6. 回歸測試與交付 (Regression and delivery)
node .agents/skills/arranque-motion/scripts/regresion-visual.mjs --manifiesto .agents/skills/arranque-motion/assets/regresion/macro-encendido.json --bundle out/bundle
node tests/validar-rigs.mjs
node tests/verificar-mascotas.mjs
node tests/validar-svg-mascotas.mjs
node .agents/skills/arranque-motion/scripts/validar-skill.mjs
比較工具使用八個已核准的影格。通過條件: 在參考機器/GPU 上雜湊值完全相同,且所有指令退出碼為 0。僅在核准視覺變更後使用 --actualizar,並保留先前的證據與理由。技能驗證工具檢查結構、引用、說明與探索路徑;使用 --permitir-pendiente 可進行臨時驗證,但不聲明已安裝連結。comun.mjs 集中管理 CLI、目錄與 HTML 工作表;請勿使用其記錄的時鐘來驅動動畫。
交付變更的檔案、節拍表/評分表、清單、含退出碼的指令執行結果、比較結果與主機待辦項目。請勿將數值測試當作視覺品質的保證。