Communitygithub.com

wifecooky/bio-growth-animation

검은 배경의 과학 아카이브 스타일로 생물 성장 애니메이션을 제작합니다. 독창적인 단계별 소재, 연속 변형, 해부학적 주석 및 MP4 내보내기를 포함합니다.

bio-growth-animation란 무엇인가요?

이 스킬은 생물의 성장 단계별 이미지를 활용하여 지속적으로 성장하는 과학 아카이브 스타일의 짧은 비디오를 제작합니다. 연속 변형 및 인터페이스 시스템을 재사용하지만, 새로운 생물의 이미지, 단계 이름, 해부학적 제어점 및 인선 위치는 완전히 새로 설계되어야 합니다. 기본 설정은 10초, 3:4 세로 비율 900x1200, 60fps, 검은 배경, 음성 해설 없음이며, 사용자 요청에 따라 조정 가능합니다. 2~8단계를 지원하며, 개구리나 나비와 같은 변태 과정은 형태가 연속적인 구간으로 분할하여 설계되어야 합니다. 생성된 프로젝트는 HyperFrames 기반으로 구성되며, 내장 CLI를 통해 스냅샷 확인 및 MP4로 내보낼 수 있습니다. 이 스킬은 Claude Code, Cursor 등의 에이전트 환경에서 실행되며, 워크플로우는 시퀀스 확정, 소재 제작, 설정 작성, 프로젝트 생성, 중간 프레임 검사, 최종 내보내기 단계로 구성됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wifecooky/bio-growth-animation/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

생물 성장 애니메이션

생물의 단계별 이미지를 지속적으로 성장하는 과학 아카이브 스타일의 짧은 비디오로 제작합니다. 연속 변형 및 인터페이스 시스템은 재사용하지만, 새로운 생물의 이미지, 단계 이름, 해부학적 제어점 및 인선 위치는 완전히 새로 설계해야 하며 단순히 해마 제목만 변경해서는 안 됩니다.

기본값: 10초, 3:4 세로 900x1200, 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를 고정한 후 인선을 계속 늘리지 마십시오.
  • 단일 일시 정지된 GSAP 타임라인이 속성 setter를 구동합니다. seek에 의해 억제된 onUpdate 콜백에 의존하지 않으며, 실제 클록을 사용하지 않습니다. 이미지 디코드 및 메쉬 구축이 완료된 후 타임라인을 등록하고 사용 가능한 __hfForceTimelineRebind()를 호출합니다.
  • 내장 윤곽 보간은 투명 이미지의 알파에 임계값을 적용합니다. 반투명 해파리/얇은 날개의 경우 촉수와 얇은 가장자리가 손실되는지 확인하고 실제 소재에 따라 morph.alphaThreshold를 조정합니다. 물리적 투명 재질의 유지를 보장하지 않습니다.

빠른 검증 및 호출 예시

스킬에는 원본 해마 소재와 검증된 설정이 포함되어 있어 회귀 검사에 사용할 수 있지만, 새 생물 소재를 가장하는 데 사용할 수 없습니다.

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

일반적인 요청: "이 스킬을 사용하여 해파리가 작은 것에서 큰 것으로 성장하는 애니메이션을 만들어 주세요. 10초, 청록색, 60fps."

생성기 유지 관리를 위해 python3 scripts/test_create_project.py 및 node scripts/test_renderer.mjs를 실행할 수 있습니다. 이들은 이미지 API를 호출하거나 렌더링을 수행하지 않습니다.

사용자가 기존 짧은 비디오만 수정하려는 경우, 소재와 레이아웃을 유지하고 해당 설정이나 런타임을 조정합니다. 전체 이미지 세트를 다시 생성하지 마십시오. 내장 생성기는 프로젝트의 config.json에서 새 동일한 디렉토리로 재구축할 수 있으며, 검증 후 새 결과를 선택합니다.

관련 스킬