Communitygithub.com

MattiaIppoliti/tia-skills

在沒有特定工作流程適用時,創作或編輯自訂的 HyperFrames 合成影片。適用於較長或多場景作品、品牌與形象影片、蒙太奇、靜態循環、靜態標題卡、素材混剪及自由創作。若是簡短、無旁白、以動畫為主的單元(包含動態標題),請改用 motion-graphics 工作流程。

tia-skills 是什麼?

此技能專為需要彈性與框架無關的影片創作而設計,核心是生成 Remotion + React 架構的 HyperFrames 合成。它處理較長、多場景的敘事作品、品牌影片、蒙太奇和自由形式創作,但當需要簡短、無旁白、以動畫為主的單元(包含動態標題)時,會引導使用者使用專用的 motion-graphics 工作流程。此技能能適應不同的專案狀態:從全新的專案(透過執行 `/hyperframes` 並初始化目錄)、現有的 BRIEF.md 或專案檔案(檢測到的工作流程或 `flow: companion` 時接手),到特定的編輯請求。它強制執行嚴格的依賴加載規則,以確保品質,例如在撰寫任何場景佈局前讀取 `/hyperframes-core`,或在進行多場景剪輯時讀取 `/hyperframes-creative` 來獲取故事結構。主要工作流程支援兩種模式:`automation`(代理程式自主選擇並執行最佳路徑)和 `companion`(代理程式扮演導演角色,提供「天花板級」的處理方案——包含完整的敘事弧線、設計規格和動態處理——讓使用者可以協作調整,而不是從零開始拼湊)。該設計確保代理程式不僅僅是執行任務的承包商,而是主動的創意合作夥伴。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/general-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

⚠ 合約狀態:尚未移植至 Remotion

此技術堆疊的輸出框架為 Remotion + React(/hyperframes-core)。本技能仍描述已淘汰的 HTML + data-* + 暫停的 GSAP 時間軸 管道,其捆綁的腳本仍會以該合約格式輸出 index.html。

在移植完成前:

  • 請勿 執行 npx hyperframes <anything>——該 CLI 已淘汰。/hyperframes-cli 已將每個舊指令對應到其 Remotion 等效指令。
  • 請勿 將其 data-* 標記或 GSAP 時間軸程式碼複製到 Remotion 專案中。
  • 應 從中汲取其工藝:故事架構、剪輯節奏、視覺設計、以及螢幕上應出現內容的決策。這部分與框架無關,也是本技能保留的原因。
  • 應 透過 /hyperframes-core 的合約來表達結果:使用 <Composition>、<Sequence> 以及從 useCurrentFrame() 衍生的數值。

請在您的摘要中說明您何時需要繞過此問題,以便完成移植。

一般影片

在依賴此工作流程之前,請執行:

npx hyperframes skills update general-video

成功(無操作)表示技能是最新的。如果更新失敗,請直接顯示失敗訊息,不要憑記憶繼續。

1. 套用跨領域來源適配器

  • 媒體: 對於任何音訊、圖片、圖示、標誌、語音、調色、LUT、效果處理、字幕或媒體操作需求,請載入 /media-use,並遵循 ../media-use/references/resolve.md(解析、採用、重複使用)和 ../media-use/references/setup-providers.md(提供者、認證)。模糊的素材反饋和具名樣式,應在編輯前使用 ../media-use/references/media-treatments.md;請勿隨意使用 CSS/SVG/透明度來模擬支援的媒體效果。在執行第一個需要認證的提供者操作前,請執行 npx hyperframes auth status 並逐字回報其輸出。如果顯示為登出,請套用 ../hyperframes-core/references/brief-contract.md 中的閘道規則:協作模式下等待登入或明確的離線選擇;自主模式下則陳述狀態並透過可用的離線提供者繼續。當沒有離線提供者能滿足必要功能時,請回報阻礙。單純的本機採用不需要認證閘道。
  • Figma: 如果有任何輸入是 figma.com 網址,請先執行 /figma。使用其匯出的資產、設計記號、元件或分鏡圖框架進行建構。請勿直接呼叫 Figma 連接器,因為它們會跳過 SVG 清理、媒體來源追溯和品牌記號繫結。

這些適配器不會改變 /hyperframes 所選的工作流程。

2. 從專案狀態開始

套用第一個符合的列;不要評估較低順序的狀態列:

狀態動作
特定編輯進行編輯,保留現有專案決策,然後重新執行受影響的檢查。不要重新開始探索。
BRIEF.md 存在讀取它。如果 workflow 指定了另一個工作流程且 flow 不是 companion,則移交。不詢問簡報問題。
無簡報,但 hyperframes.json 或 STORYBOARD.md 存在從檔案和記錄的偏好設定繼續。僅根據已知事實回填 BRIEF.md。
全新創作執行 /hyperframes 及其意圖層。僅在 workflow: general-video 或 flow: companion 時返回此處。

對於新專案,請從簡報中選擇一個 kebab-case 目錄名稱,並在撰寫簡報前建立框架:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

然後使用 ../hyperframes-core/references/brief-format.md 在專案根目錄撰寫 BRIEF.md。在現有專案中,根目錄是包含 hyperframes.json 的目錄。僅記錄簡報格式指定的、已確認且由偏好設定支援的欄位,使用 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>;切勿記錄推斷的預設值。此處 <MEDIA_DIR> 是已安裝的 /media-use 技能目錄,<PROJECT_ROOT> 是包含 hyperframes.json 的目錄。如果意圖層採用了配方,請立即使用 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name> 套用,並且不要再詢問。

3. 解讀執行模式

僅使用 ../hyperframes-core/references/brief-contract.md 中的標準術語:

欄位含義效果
flow由誰主導automation:選擇並執行路徑。companion:在對話中共同創作。
storyboard分鏡板是否為審查介面yes:執行計畫和草稿審查。no:不透過分鏡板直接建構。
衍生的 mode檢查點閘道的行為方式遵循簡化合約。切勿要求使用者命名模式。

不要為這些狀態創造同義詞。持續的「直接建構」訊號由意圖層處理,並以 flow: automation、storyboard: no 的形式到達。

  • 對於 flow: automation,選擇路徑並在第一次進度更新中用一行說明。
  • 對於特定編輯,進行編輯,不要創造新的路徑。

對於現有素材的硬剪輯、修剪、拼接或重新排序,請將相同的影片來源複製到多個剪輯元素中。在每個副本上,使用 data-media-start 加 data-duration 設定來源範圍,然後使用 data-start 設定編排的位置/順序。單獨編寫的音訊在匹配的 <audio> 元素上遵循相同的剪輯範圍和時間。/hyperframes-core 負責此時間編輯;僅對視覺屬性動畫(如縮放、推進、平移、裁切、遮罩或內部包裝器上的 clip-path)使用 /hyperframes-keyframes。從 ../hyperframes-core/references/editing-recipes.md 複製完整的合約。

協作流程

當 flow: companion 時:

  • 讀取 BRIEF.md,並將已接受的 ## Assets 和 ## Customizations 與專案工件進行比對。完成已接受但仍未完成的工作;保持已完成的工作不變;不要再次提供已接受的功能,就好像它是新的一樣。
  • 以導演的身份到來,而不是承包商。 選擇協作模式的使用者選擇的是參與和品質;誠實的回應是你所能設計的最佳版本,而不是最小、最能辯解的版本。第一個計畫就是天花板級處理方案:故事弧線(借用最接近的類型鏡頭——選單 § 類型鏡頭)、設計規格、每個場景的具名動態處理(參見 § 5 的計畫規範)、過場、音訊識別——音樂和聲音標記,或刻意的靜音——使用者素材的放置,以及設計好的開場和結尾。用一句話說明每個層級增加了什麼;在提到它們時,標記昂貴的層級(渲染時間、登入、計費)。使用者是從上往下修剪處理方案;他們絕不應該逐一批准來拼湊一個。
  • 天花板屬於概念,而不是工具箱。 每個層級都必須服務簡報的訊息——一個會以同樣方式裝飾任何影片的處理方案只是裝飾。工藝提升至天花板;內容絕不超出被要求的範圍(§ 6)。
  • 在檢查點之間,../hyperframes/references/capability-menu.md 有兩種作用。作為觸發列表:當使用者提到某項功能的輸入,或建構過程達到其需求時,提供相關功能。作為每個階段的升級管道:一個計畫、草稿或建構檢查點可能附帶一兩個針對使用者正在查看的材料所提供的功能(「場景3的靜態畫面想要計數效果」)。在提供之前先讀取它;切勿傾倒整個目錄。
  • 使用者接受某項功能後,立即產出該功能的工件,並將決策記錄到匹配的 BRIEF.md 正文區段中。僅在使用者明確更改時,才改寫 frontmatter 欄位並記錄已確認的偏好設定。
  • 保持相同的分鏡板、驗證、最終預覽和渲染審核閘道。協作模式改變的是誰在掌舵,而不是對品質的要求。

4. 在每個階段前載入必要知識

當條件匹配時,這些讀取是強制性的:

條件在執行前讀取
任何合成 HTML 或場景佈局/hyperframes-core;使用 references/determinism-rules.md 了解其佈局合約
任何非平凡的創作或視覺處理/hyperframes-creative → references/house-style.md 和 references/video-composition.md
任何動態、動畫或場景過場/hyperframes-animation;遵循其路由到匹配的規則、適配器、藍圖或過場參考
storyboard: yes../hyperframes-core/references/storyboard-format.md 和 ../hyperframes-core/references/review-loop.md
任何媒體資產或操作,包括旁白、背景音樂、音效、字幕、調色或變換/media-use;對於框架播放和放置,也請讀取 /hyperframes-core → references/media.md
多場景組合../hyperframes-core/references/production-loop.md
flow: companion,在第一次計畫之前/hyperframes-creative → references/story-spine.md 和 references/house-style.md;最近的類型鏡頭和完整的 ../hyperframes/references/capability-menu.md——天花板級處理方案是根據這些設計的,而不是回憶
協作功能提供、捕捉、節拍網格、生成式影片、地圖、發布或跨工作流程功能../hyperframes/references/capability-menu.md
設計規格存在,在最終批准之前/hyperframes-creative → references/design-adherence.md

不要用記憶來取代這些讀取。只有在匹配的參考文件被實際載入時,漸進式揭露才能節省上下文。

5. 執行合成

使用此依賴順序。僅當其輸入不存在時才跳過某個階段。

  1. 計畫。 陳述觀眾的觀看歷程、結構、節奏和持續時間驅動因素。對於簡短的單一場景,使用一個檔案;對於三個或更多硬場景剪輯或任何重複使用的場景,使用子合成。閱讀 /hyperframes-creative → references/story-spine.md 以了解敘事弧線,references/beat-direction.md 以了解節奏,以及 /hyperframes-core → references/project-structure.md 以了解結構。對於開放式多場景簡報,透過 /hyperframes-creative → references/prompt-expansion.md 擴展提示。多場景計畫會引用每個場景的形狀:當有匹配的藍圖時,引用來自 /hyperframes-animation → blueprints-index.md 的藍圖 ID;當沒有匹配的藍圖時,則引用其組合的具名規則(來自 rules-index.md)——動態名稱來自這些索引,絕不憑空發明。故事的真實性決定了哪些場景存在;引用只是為其添上裝飾。多場景計畫也會被記錄為分派工件:在 STORYBOARD.md 中為每個場景建立一個 ## Frame N 區塊——包含 status: outline、一個宣告的 src:、藍圖/規則引用和節拍文字——即使 storyboard: no 也是如此。該區塊是分派單位;分鏡板僅是審查介面。
  2. 按需求審查計畫。 對於 storyboard: yes,對這些區塊執行共享的審查循環。對於 storyboard: no,繼續進行,不開啟分鏡板。如果仍然發生計畫暫停,

……

[為翻譯而截斷]

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

相關技能