Communitygithub.com

生物生長動畫

製作黑底科學檔案風的生物生長動畫,包含原創階段素材、連續形變、解剖標註與 MP4 匯出。適用於「換一種生物做類似海馬生長動畫」、標本演化動效或生長序列;明顯變態發育須按形態連續的階段分段設計。

生物生長動畫 是什麼?

此技能(wifecooky/bio-growth-animation)旨在幫助使用者為任意生物創建從早期發育到成熟階段的連續生長動畫,最終產出科學檔案風格的 MP4 影片。它特別適合需要展示物種變態發育或形態連續變化的場景,例如從海馬換成另一種生物製作類似的生長動畫。技能的核心工作流程分為六大步驟:先確定生物的生長序列並確保階段姿態連續,接著使用內建工具生成帶透明背景的階段素材。然後填寫 JSON 配置文件,從內建的海馬範例複製結構,並為新生物重新標定語義控制點(如頭、軀幹、附肢)。之後利用 Python 腳本生成專案,該專案會內嵌 GSAP、形變渲染器等 HyperFrames 依賴,並輸出結構化的專案檔。使用者需在本地 Node.js 22+、FFmpeg 和 Chrome/WebGL 環境下渲染影片。值得注意的是,技能特別強調動畫的平滑性,規定只能使用單一連續生長進度驅動所有控制點,禁止透過跳回時間點替換圖片來偽造平滑效果。它還提供了快速驗證腳本,並保留原有海馬素材作為回歸測試使用,但嚴格禁止將其冒充為新生物的素材。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wifecooky/bio-growth-animation/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

生物生長動畫 是做什麼的?

將生物階段圖製作成持續生長的科學檔案短片。復用的是連續形變與界面系統;新生物的圖像、階段名稱、解剖控制點和引線位置必須重新設計,不能只改海馬標題。

預設:10秒、3:4豎版900×1200、60fps、黑底、無配音、概念數據。使用者給出其他時長、視覺參考或交付形式時按其要求調整。內建HUD範本支援3:4及同比例解析度,支援2–8階段;其他縱橫比需要實際修改版面,不能直接拉伸畫面。

工作流程

  1. 確定生長序列。 使用請求裡已有的生物和視覺方向。階段需有可對應的姿態;普通體型增長可直接連續形變,蛙/蝶等長出或失去肢體的變態發育先讀素材與形態指導,按拓撲連續的區間分段。概念圖不冒充實測發育數據;知識講解中的階段和事實要先核實。

  2. 製作並檢查素材。 新素材使用可用的內建 imagegen,背景設為透明;完整提示詞與背景清理策略見素材與形態指導。採用同一鏡頭、朝向與光照。先看真實輸出,再讀取實際尺寸、確定格線邊界;灰底、霧狀矩形和相鄰格漏入都應在動畫前處理。不要預設為提示詞裡的尺寸已實現。

  3. 填寫配置。 讀配置說明,從 assets/examples/seahorse.json 複製結構,但為新生物重新標定語義控制點。設定標題、階段、尺寸錨點、兩組指標、標註與配色。圖集路徑相對設定檔;所有控制點使用單格原始像素。關鍵姿態要有連續的頭/軀幹/附肢對應關係。

  4. 生成專案。 以當前技能目錄作為 BIO_SKILL_DIR,在工作目錄呼叫:

    python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config work/specimen/config.json --validate-only
    python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config work/specimen/config.json --out work/specimen/project
    

    輸出目錄必須不存在或為空,腳本不會覆蓋既有專案。它複製本地GSAP、字型、形變渲染器,內嵌配置並產生HyperFrames專案;現有素材的渲染不呼叫圖像API。專案使用Python3生成,影片驗證/匯出需要Node.js 22+、FFmpeg和可用的Chrome/WebGL。HyperFrames CLI固定在已驗證版本,首次執行可能需要下載依賴。

  5. 看過渡,不能只看階段端點。 在生成專案中執行 npm run check -- --snapshots,查看首個可見幀、每兩個姿態之間的中間幀、成熟體與最終保持幀。需要定點截圖時執行 npx hyperframes snapshot --at <逗號分隔的時間>。複查第一張截圖,防止非同步初始化造成首幀未綁定時間軸。確認沒有網格翻折、眼睛重影、尾圈破洞、圖集裁斷、標題遮擋或引線脫離身體。

  6. 完成匯出。 使用者要成片時按已授權範圍匯出,避免重複詢問已給出的製作要求:

    npm run render -- --quality delivery --output renders/growth.mp4
    ffprobe -v error -select_streams v:0 -show_entries stream=width,height,r_frame_rate,duration,nb_frames -of json renders/growth.mp4
    

    查看匯出影片的過渡中間幀。交付MP4、配置/專案原始檔案和素材提示詞;使用者可見檔案放到目前工作區約定的outputs目錄,暫存圖、日誌和檢查幀留在work。不要發佈或上傳到外部服務,除非使用者要求。

已有HyperFrames相關技能時沿用其執行時期與CLI約定;這裡的範本負責生長動畫的具體生成,不重新收集對話裡已經確定的偏好。

平滑性必須保留的實作

  • 主體只有一個連續生長進度;眼、吻/口、軀幹、附肢與卷尾等控制點隨同一進度變化。不能退回0.3秒換圖來代替平滑生長,單純提高fps也不能修復換圖感。
  • 共享三角網格把鄰接紋理扭到共同形狀;Catmull-Rom控制空間軌跡,距離場插值收攏輪廓,減少透明度疊化的雙重邊緣。複雜拓撲變化不能靠增加控制點硬撐。
  • 標註線直接讀取形變後的控制點;數值直接格式化當前進度,保留小數位。不要固定初始 stroke-dasharray 後繼續拉長引線。
  • 單一paused GSAP時間軸驅動屬性setter;不依賴被seek抑制的onUpdate回呼,不使用真實時鐘。圖像decode及網格構建完成後再註冊時間軸,並呼叫可用的 __hfForceTimelineRebind()。
  • 內建輪廓插值會對透明圖的alpha取閾值:對半透明水母/薄翅必須檢查觸手和薄邊是否遺失,按實際素材調 morph.alphaThreshold;不承諾保持物理透明材質。

快速驗證與呼叫範例

技能自帶原海馬素材和已驗證配置,用於回歸檢查,不能冒充新生物素材:

python3 "$BIO_SKILL_DIR/scripts/create_project.py" --config "$BIO_SKILL_DIR/assets/examples/seahorse.json" --out work/growth-smoke

典型請求:「用這個skill做一段水母從小到大的生長動畫,10秒、青藍色、60fps。」

維護產生器時可執行 python3 scripts/test_create_project.py 和 node scripts/test_renderer.mjs;它們不呼叫圖像API或進行渲染。

使用者只想修改現有短片時,保留其素材與版式,調整對應配置或執行時期;不要重新生成整套圖像。內建產生器支援從專案 config.json 重建到新的同級目錄,驗證後再選用新結果。

相關技能