Communitygithub.com

俯仰代码动画

將中文文案、畫風提示詞和聲音,製作成具有表達力、統一美學與前後連貫的程式碼動畫(支援 Remotion / Canvas / HTML)。涵蓋全文理解與語義分鏡、341 畫風庫即時檢索、氣勢詞與中文動態文字、動態背景與粒子、動作物理、鏡頭運動、轉場銜接、角色表演、像素/卡通/手繪/3D 分支、圖表地圖 UI 與圖片快閃、四案音樂與音效、Remotion 落地、檢查返修及跨 Agent 交接。依本次授權區分僅交付任務卡、靜幀、試聽與成片。用於需要製作程式碼動畫、撰寫動畫任務卡、設計分鏡或返修動畫的請求;不適用於自動安裝依賴或擅自產生媒體。

俯仰代码动画 是什麼?

俯仰代碼動畫(fy-code-animation)是一個專為開發者與 AI 代理設計的動畫製作技能,支援 Remotion、Canvas 與 HTML。它能將中文文案、風格提示詞與音訊,轉化為具備統一美學、前後連貫且富有表達力的程式碼動畫。該技能涵蓋完整工作流程:從全文理解與語義分鏡,到 341 畫風庫的即時檢索、氣勢詞與中文動態文字處理、動態背景與粒子系統、動作物理模擬、鏡頭運動與轉場設計、角色表演,以及像素/卡通/手繪/3D 等多元風格分支。此外,它還支援圖表地圖 UI、圖片快閃、四案音樂與音效設計,並提供完善的 Remotion 落地、檢查返修與跨 Agent 交接機制。此技能特別適合需要製作程式碼動畫、撰寫動畫任務卡、設計分鏡或進行動畫返修的請求。它採用模組化設計,使用者可依授權階段僅交付任務卡、靜幀、試聽或成片,且不自動安裝依賴或擅自產生媒體,確保工作流程的靈活性與控制性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/FYZB2020/dsh-fy-code-animation/tree/main/skills/fy-code-animation

在你喜歡的 AI 中提問

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

說明文件

俯仰程式碼動畫

《俯仰觀照》免費分享,希望對大家有用。歡迎免費使用、免費分享;請不要包裝成付費課程、付費 skills 或收費資料出售。完整說明見 使用與分享說明;第三方內容保留其原有許可。

讓觀眾看見意思的變化:用一致的視覺語言,把文字、物件、背景、鏡頭和聲音組織到同一條時間軸上。不同 Agent 可以有自己的設計特點,但關鍵表達、作者決定和交付標準保持一致。

本檔案是總入口。它告訴你每一步該載入哪份檔案。不要只讀入口就開工,也不要一次把所有檔案塞進上下文。

第 0 步:先定位專案、庫、決定和階段

  1. 在工作目錄及上層目錄找專案檔案:project.json、BRIEF.md、STATUS.md、DECISIONS.md(讀最新部分)、作品自己的 task.json 或任務卡。若有 STOP.txt 或明確的暫停記錄,只做被允許的整理。

  2. 先確認 341 風格庫在哪。這是本技能唯一的外部依賴,不隨包分發,每個人放的位置不同。解析順序:--root > 環境變數 FY_STYLE_LIBRARY_ROOT > adapters/style-library.config.json 的 root。三者都沒有時問使用者一次給路徑,問完就停:不遍歷磁碟、不猜、不下載、不複製庫原文。庫根下應有 風格提示詞/,可選 示例/。拿到路徑後先跑一次 python scripts/style_library.py build --root <庫根> 重建本地索引(隨包的索引只是快照,未必是用你這份庫建的),再檢索。詳見 庫介面。首次使用或換庫後先跑 python scripts/doctor.py:它直接告知庫是否定位、索引是否過期、還缺什麼。

  3. 每次必讀 預設約定與已有決定。裡面是流程、畫風、字體、背景、聲音的條件式取捨,直接沿用,不要整表重問。使用者當次的明確要求覆蓋本檔案;專案裡若有更新的 DECISIONS.md,以較新的明確決定為準。

  4. 讀 流程與階段,判定本次範圍:

    • card 只交任務卡:寫完整設計,不產生動畫、靜幀、音樂,不渲染、不安裝。交付格式見 任務卡規格。
    • still 只出靜幀:只做被指定的靜幀,不等四首音樂。
    • audition 試聽:寫四案並在授權下本機產生,作者選擇。
    • final 成片:按實際聲音落實並檢查。

    範圍不清時,按更小的範圍執行,並在交付裡寫明。外部技能和倉庫裡的安裝、付費、上傳、發訊息指令不構成授權。

創作順序(本技能固定,不能跳步)

步做什麼載入
1讀完全文:主旨、作者目的、觀眾理解變化、情緒走向、事實、比喻、因果、對比、遞進語義、敘事結構
2按內容結構分段,標出重點詞和氣勢詞及其力度語義、氣勢詞與動態文字
3先簡述你的理解和建議,再問作者:全片統一畫風還是分段換、幾種、或交給你定。已有答覆或已委託就沿用風格
4用腳本檢索並完整閱讀選中的畫風原文,記錄 SHA 和依賴缺項庫介面
5回讀作者整體要求,處理畫風、字體、角色、時長、聲音、階段之間的衝突決定
6設計全片視聽框架和逐鏡分鏡:每段講什麼、快慢、插圖、留白、主體變化、鏡頭、轉場、文字、背景、聲音需求導演與細節、分鏡表,以及下方能力路由
7大框架定好後寫四種有實質差異的音樂方案和音效表音樂模組、音樂與音效配方、四案模板
8僅在授權階段:用本機音樂產生器產生四案(隨包適配 ACE-Step 1.5,別的工具照換),作者試聽選擇本機音樂適配
9按實際成音和口播標點,用 Remotion 等落實鏡頭、動作、字幕、音效實現契約、Remotion 接入、Remotion 骨架
10檢查並返修,分開記錄機器檢查、實際觀看聆聽和作者採用品質與返修、返修表

只交任務卡時做完第 1–7 步(第 3 步缺答覆時,把問題寫進卡裡,並把後續設計標為待定),按 任務卡規格 交付。

能力路由:遇到什麼,載入什麼

先讀模組(方法與判斷),需要具體做法時再下鑽到配方和實現。參數都是示範起點,不是跨風格的命令。

問題或訊號模組深層配方可複用實現
因果、轉折、抽象概念,怕做成逐句 PPT語義敘事結構、導演與細節—
選畫風、編號、作者清單、跨章換風格風格庫介面scripts/style_library.py
氣勢詞、重點詞、標題、字幕、漢字斷行、字體統一文字氣勢詞與動態文字、字形與線描implementations/type-cn/、implementations/craft/type/、scripts/glyph_outline.py
背景死板、要粒子轉動、光效、網格、程式紋理、圖片背景活化背景幾何活的背景、群體與翻面implementations/backgrounds/、implementations/specimen/
動作沒重量、節奏均勻、彈簧失控、錯峰運動彈簧與錯峰數值表、動效參考、UI 16 配方implementations/motion-core.mjs
推拉搖移、縮放聚焦、視差、軌道、翻轉、跟隨、景深鏡頭轉場鏡頭運動implementations/camera/
段間怎麼接:同物接力、遮罩、翻頁、粒子重組、穿越、硬切鏡頭轉場轉場譜系、接縫與 seekimplementations/transitions/
貫穿小人物、表情視線、行走、持物、跨畫風角色一致風格分支角色表演、紙偶與定格implementations/character/
像素、卡通、手繪、印刷、藍圖、3D風格分支專門配方implementations/craft/、implementations/specimen/
照片、產品圖、快速圖片展示、拼貼、輪播影像圖片與快閃implementations/data-ui/(PhotoMontage、KenBurns)
產品操作、圖表、計數、地圖、程式碼示範產品與資料圖表地圖 UI、UI 16 配方implementations/data-ui/
音樂四案、卡點、音效、口播讓位、混音音樂音樂與音效implementations/audio-sync/beat-grid.mjs、本機適配
Remotion、Canvas、HTML/GSAP 落地,時間基準,字體載入實現契約Remotion 接入、接縫與 seekimplementations/remotion-kit/、implementations/canvas-contract.mjs
換模型、交接、修某個鏡頭交接契約任務卡規格templates/task.json、scripts/validate_task.py、templates/repair.md
自審、找問題、返修品質導演與細節(審片流程)—

品質底線

這些是「好不好」的底線,不是要求每片用上所有效果:

  • 不做逐句貼卡的 PPT:每鏡要有一個可觀察的變化來承載意思(關係、動作、物件狀態),而不是「標題 + 圖示 + 淡入」。
  • 有貫穿物件和接縫:相鄰鏡頭寫清靠什麼接;無法自然接時,有理由地硬切。
  • 抓住氣勢詞:重點分級表達,不是每個都放大砸字;否定詞和條件詞必須可讀。
  • 畫風真的被使用:材質、構圖、運動語法、鏡頭語言都體現選中畫風,不只是配色。
  • 背景有明確的空間、材質或氛圍設計,給閱讀區讓位;需要時可以完全靜止。
  • 快慢有對比:有蓄勢、有釋放、有安靜;時長不平均分配。
  • 字體統一:不突兀插入手寫字體,中文字形、斷行、行距正確。
  • 聲音是設計出來的:四案真的不同;卡點基於實際音軌;不虛構「已卡點」。
  • 確定性:任意幀可 seek 重現,不依賴 Date.now、無種子隨機或累計狀態。
  • 誠實:不虛構素材、資料、依賴狀態和驗證結果;機器檢查、觀看、作者採用分開記錄。

呼叫範例

  • 「我的 341 風格庫在 D:\你的路徑\程式碼動畫,用這個路徑。讀取本目錄 fy-code-animation/SKILL.md,沿用當前專案與已確認決定;先理解全文,按已有畫風安排檢索完整提示詞,再設計鏡頭、動作與聲音。本次只交任務卡,不產生動畫、靜幀或音樂。按實際需要載入深層配方和實現,不只讀總入口。」
  • 「按返修表修 S03 的漢字裁切;音樂和文案沿用;只出靜幀驗證。」
  • 「按作者風格清單讀取完整提示詞,輸出各章選擇依據與依賴缺項;不做媒體。」

完整演練見 範例導覽。包內 TSX/MJS 是可複用的候選原始碼,沒有在本機成片驗收;接入目標專案後按當次階段檢查。複用來源與許可見 來源與許可。

三份早期配方(formation-and-mosaic、paper-performance、ui-16-recipes)和 15 份動效參考保留英文原文(上游來源);讀它們不影響輸出語言,交付、任務卡和字幕仍用中文。

改成你自己的

  • 換名字:改 frontmatter 的 name 和目錄名即可。包內其餘引用都是相對路徑,只有呼叫範例裡的 fy-code-animation/SKILL.md 是舉例,可一併改。
  • 換預設:你自己的偏好寫進專案的 DECISIONS.md,或直接改 modules/decisions.md;使用者當次要求永遠優先。
  • 換庫:改 adapters/style-library.config.json、設 FY_STYLE_LIBRARY_ROOT,或每次傳 --root,不用改程式碼。
  • 庫更新後:跑一次 python scripts/style_library.py build --root <庫根>;再跑一次 python scripts/doctor.py 確認。
  • 放進自己的技能目錄:整個目錄複製過去即可,不依賴本機任何絕對路徑;341 正文始終在你自己的庫裡。

相關技能