Communitygithub.com

release-film

에이전트가 릴리스 영상을 기획, 제작 또는 편집하여, 결과물이 샷 하나하나 방어 가능한 모션으로 나오도록 안내합니다. 절차는 '릴리스 영상: 변경된 것, 변경되는 모습', '0 — 이 릴리스에 영상이 필요한가?', '1 — 물어본 후 기다리기'로 진행됩니다. 새로운 작업에서 이 기술이 필요할 때 사용하세요.

release-film란 무엇인가요?

이 스킬(skill)은 AI 에이전트가 소프트웨어 릴리스 영상(release film)을 제작하는 전체 워크플로우를 제공합니다. 릴리스 영상은 일반 제품 프로모션과 달리, 릴리스 태그(tag)에서 가져온 실제 앱 소스를 기반으로 변경된 UI 표면을 벡터(vector)로 재현하고, 실제 커서와 단축키를 사용하여 변경 사항이 제자리에서 변경되는 모습을 보여줍니다. 이 스킬은 `site-promo-film` 엔진을 확장하여, 16서브프레임 모션 블러, 정확한 루프, seek(t) 기반 렌더링 등 동일한 기술 스택을 사용하면서도 릴리스 영상에 특화된 규칙(예: 변경 사항 목록을 태그에서만 가져오기, 최대 3개의 주요 변경 사항만 피처링, 버전 카드로 시작하고 끝내기, 모든 클릭이 시청자에게 보여야 함)을 적용합니다. Claude Code, Cursor, Codex 등 다양한 AI 코딩 도구와 호환되며, 에이전트는 릴리스 노트, 변경 로그(changelog), 소셜 미디어 게시물, 뉴스레터 등에 사용할 짧은 '새로운 기능' 영상을 제작할 수 있습니다. 스킬은 가이드 모드(질문 기반)와 스튜디오 모드(설정 기반)를 모두 지원하며, 최종 결과물은 제품의 키트(kit) 형태로 관리되어 시리즈의 일관성을 유지합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/release-film

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

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

문서

릴리스 영상: 변경된 것, 변경되는 모습

프로모션은 제품을 판매합니다. 릴리스 영상은 **하나의 릴리스 델타(delta)**를 이미 제품을 대부분 알고 있는 사람들에게 보여줍니다. 같은 엔진, 다른 작업: 이전 상태가 중요하며, 모든 주장은 태그(tag)로 제한되고, 영상은 시리즈의 한 에피소드입니다.

이 스킬은 site-promo-film을 확장하며, 형제 디렉토리 ../site-promo-film/에 있습니다. 먼저 해당 SKILL.md를 읽으십시오: 방향, 모양, 금지 사항, 빌드 규칙, 캔버스 함정, 렌더 전 스틸(still), 렌더 및 검증은 모두 변경 없이 적용됩니다. 이 파일은 릴리스가 추가하는 내용만 담고 있습니다.

파일설명
template/release.html엔진과 16초 릴리스 데모: 버전 카드 → 앱의 이전 모습 → 새 컨트롤이 툴바에 나타나 클릭됨 (목록이 재정렬되며 행이 들어 올려짐) → 키캡(keycaps)의 단축키가 새 표면을 염 (열리는 패널(pill)) → 나머지 변경 로그 → 유리 메뉴에서 업데이트 경로 클릭 → 버전 카드로 돌아옴. 하나의 파일로 와이드(wide)와 스퀘어(square) 레이아웃을 지원하며, 각 피처링된 변경 사항은 고유한 조명을 가질 수 있습니다.
../site-promo-film/template/film.js스테이지(서브픽셀 지터(subpixel jitter): 느린 움직임에서 덜거덕거림이나 떨림 없음), FILM.draw (아이콘 및 심볼), 롱 필름 타임라인, 이펙트. 템플릿이 로드하며, 상단과 site-promo-film §5에 문서화되어 있습니다.
../site-promo-film/template/parts.js벡터 파트: 창, 브라우저, 터미널, 장치, 키캡, 스위치, 링.
../site-promo-film/template/fx.js비주얼 — 배경, 조명, 그레인(grain), 유리, 클릭 리플 — 프로모션 템플릿과 공유되며, 해당 문서(§4)에 설명되어 있습니다.
../site-promo-film/scripts/render.mjs, contact.mjs, beats.mjs렌더러, 콘택트 시트(contact sheet) 및 사운드트랙 비트(site-promo-film §7, The beat), 그대로 사용: PAGE=release.html node render.mjs ….
../site-promo-film/scripts/clickcheck.mjs모든 클릭이 보이는가(§3b): 페이지의 각 CLICKS에서 카메라 정지 및 커서 정지. node clickcheck.mjs release.html, 보이지 않는 클릭이 있으면 exit 1.
../site-promo-film/scripts/deliver.mjs완성된 영상과 커버를 별도 폴더에 넣고, 키트가 안전해지면 작업 폴더를 휴지통으로 이동 (site-promo-film §8).

템플릿(또는 제품의 키트(§5)), film.js, parts.js, fx.js (및 설정한 글꼴이 있는 type.js, 헤드라인용 type.js 스타일)와 네 개의 스크립트를 작업 폴더의 src/, ~/Downloads/<product>-<version>-whats-new-work/src/ (~/Downloads는 설정에서 달리 지정하지 않는 한 작업 루트입니다, site-promo-film, 스튜디오 섹션 참조)에 복사하고, 해당 위치에서 npm i playwright-core를 실행합니다. 데모는 8개 워커에서 16서브프레임으로 69초, 디더(dithered) 룩(night)에서는 171초에 렌더링됩니다 (와이드 기준).

? 또는 help와 함께 호출되거나, 대화에서 릴리스를 언급하지 않은 상태에서 아무것도 없이 호출되면: 가이드 모드, ../site-promo-film/guide.md. 버전을 묻고 브리프(brief)를 안내하며, 이 모드에서는 아무것도 렌더링되지 않습니다. 스튜디오(site-promo-film, Studio)도 릴리스 브리프를 작성합니다: kind: release, release.tag에 버전 포함; §1의 질문에 답변합니다.

0 — 이 릴리스에 영상이 필요한가?

사용자가 영상을 요청한 경우에만 질문합니다: 릴리스 명령이 스스로 이 질문을 제기하지 않으며, 여기서는 아무것도 스스로 제안되지 않습니다. 렌더링은 site-promo-film §7의 열 기본값을 따릅니다.

  • 태그에서 목록을 작성하고, 절대 기억으로 하지 마세요: git log --oneline <prev-tag>..<ref>, 머지된 PR, 초안 릴리스 노트. "내 생각에 포함된 것"으로 만든 영상은 빠진 기능이나 이전 릴리스의 기능을 보여줍니다.
  • 다음 조건을 충족해야 합니다: 사람이 보거나 하는 것이 다른 방식으로 제공되는 경우 — 새 표면, 새 컨트롤, 리디자인, 새 단축키. 버그 수정, 속도 개선, 내부 변경은 해당되지 않습니다. 한 줄로 말하고 중단하세요. 보여줄 것이 없는 릴리스의 영상은 숫자가 적힌 타이틀 카드에 불과합니다.
  • 최대 세 가지 변경 사항을 피처링하세요. 나머지는 변경 로그 롤(changelog roll)에 노트에서 그대로 넣거나, 넣지 마세요. 피처링된 변경 사항이 다섯 개면 각각 3초씩이라 슬라이드쇼가 됩니다.

1 — 물어본 후 기다리기

먼저 확인: 제품의 이전 영상(해당 키트, §5), 프로젝트의 릴리스 미디어 저장 위치 지침, 데모 모드 또는 픽스처(fixtures). 키트나 태그의 소스에 없는 에셋(아이콘 마스터, 로고 벡터)은 같은 메시지에서 요청하며, 절대 임의로 만들지 않습니다 (site-promo-film §1). 그런 다음 한 메시지에서 각각 기본값과 함께 질문합니다:

  1. 릴리스 및 참조(ref) (기본값: 태그; 아직 태그되지 않은 경우 main, 이후 태그에서 다시 확인).
  2. 피처링된 변경 사항 (기본값: 로그에서 내 선택, 각각 왜 잘 보여주는지 한 줄 설명).
  3. 길이 (기본값: 피처링된 변경 사항당 약 6–8초 + 버전 카드 약 3초, 총 15–30초; 클릭이 있는 경우 두 배(§3b)). 유튜브용 30초 이상 영상은 챕터(§6)를 포함해야 하며, 더 짧은 영상은 불가능: 유튜브는 최소 3개 챕터, 첫 번째는 0:00, 각각 최소 10초 필요.
  4. 형식: 16:9 마스터(기본값) 및 두 번째 레이아웃으로 스퀘어 컷.
  5. 룩(look) (기본값: 키트의 것; 첫 영상인 경우 site-promo-film §4에 따라 실제 프레임 하나로 룩 시트(looks sheet) 제공).
  6. 저장 위치 (기본값: <product>-<version>-whats-new/, site-promo-film §8에 따라 전달, 완성된 영상과 커버만 보관하고, -work 폴더는 작업 루트(기본값 ~/Downloads)에 유지; 프로젝트의 지침에서 릴리스 미디어 저장 위치를 명시한 경우 해당 위치 사용).
  7. 음악: 기본값 없음. 릴리스 클립은 음소거 자동 재생되므로 텍스트가 모든 것을 전달합니다.

그런 다음 비트 그리드(beat grid)에서 스토리보드 하나 (제품에 키트가 있는 경우: 스타일은 확정되었고 콘텐츠만 선택 사항), 첫 영상인 경우 세 개를 제공합니다. 진행 허가를 기다리세요.

2 — 소스: 앱, 참조(ref) 기준

  • 참조에서 코드를 읽고, 작업 트리(working tree)는 읽지 마세요: git show <ref>:<path>. 코드 보기(View code)는 문자열, 심볼, 간격 및 색상을 제공합니다; 프로젝트의 스크립트된 스크린샷(데모 모드, 픽스처)은 비율을 제공합니다. 실제 데이터가 포함된 캡처는 절대 사용하지 마세요.
  • 이전 상태는 이전 태그의 소스에서 가져옵니다. 기억에서 재현하면 정확히 릴리스가 변경한 세부 사항에서 틀립니다.
  • 화면의 모든 문자열은 참조에 존재합니다: git grep -nF -- '<string>' <ref>가 반드시 일치해야 합니다 (UI 텍스트, 메뉴 항목, 키캡의 단축키: 바인딩을 grep하고 문서는 제외). 소스 언어로 영상을 만드세요.
  • 헤드라인은 릴리스 노트의 혜택 라인(benefit lines)입니다, 몇 단어로: PR 제목이 아니며, 릴리스가 하지 않는 일을 포함하지 않습니다. 공개적인 주장입니다.
  • 기본적으로 꺼져 있는 변경 사항은 화면에 스위치가 필요합니다. 그렇지 않으면 영상이 시청자가 찾을 수 없는 것을 광고하게 됩니다.

3 — 스토리보드 패턴

  • 버전 카드로 열고 닫습니다: 아이콘, 이름, "X.Y의 새로운 기능", 악센트 색상의 버전. 프레임 0이자 마지막 프레임이며, 루프 지점 기준 각 측면 약 1.5초.
  • 제자리에서 변경합니다. 한 비트 동안 표면을 이전 모습으로 보여준 후, 그 위에서 변경이 일어나게 합니다: 컨트롤이 툴바에 착륙하고, 목록이 재정렬되며, 패널에 섹션이 추가됩니다. 이전/이후 레이블이나 분할 화면 없음: 전환이 설명입니다. 변경이 착륙할 때 카메라를 확대하고, 사용될 때 축소합니다.
  • 새 표면은 그것을 여는 것에서 자랍니다: 클릭, 메뉴 항목, 단축키. 단축키는 헤드라인 슬롯의 키캡에 표시되며, 표면이 응답하는 비트에서 눌립니다.
  • 하나의 피처링된 변경 사항, 하나의 헤드라인, 하나의 상호작용. 헤드라인은 변경이 착륙할 때 나타나며, 그 전에는 나타나지 않습니다: 시청자가 먼저 보고, 그다음에 무엇인지 읽습니다.
  • 챕터는 고유한 색상을 가질 수 있습니다. 조명이 있는 룩의 경우, 룩의 keys가 각 피처링된 변경 사항이 착륙할 때 색상을 변경하고, 버전 카드에 첫 번째 색상을 다시 가져옵니다 (데모처럼). 제품의 색상이 의미(계정, 상태)를 가질 때는 생략합니다.
  • 나머지 변경 로그는 헤드라인 슬롯에 짧은 롤로, 레이블("X.Y에도 추가됨")과 노트에서 그대로 가져온 세에서 다섯 줄, 비트당 한 줄. 나머지가 명명할 가치가 있을 때만 사용합니다.
  • 업데이트 경로에서 닫으며, 실제로 클릭됩니다: 제품의 새 버전으로 가는 자체 경로 (업데이트 확인… 메뉴 항목, 스토어 버튼, 사이트 URL). 그런 다음 UI가 다시 아이콘으로 축소됩니다. 메뉴에서 강조 표시된 행은 그 순간 커서 아래에 있는 행으로, 커서 자체 트랙에서 계산되므로, 행 위를 지나가면 실제 메뉴처럼 해당 행이 켜집니다.
  • 진행률 표시줄, 챕터 카운터 또는 "NEW" 배지 없음: 헤드라인 변경 자체가 챕터 나누기입니다.
  • 제자리 변경이 유일한 형식은 아닙니다. 키트의 마지막 영상이 이미 이 방식을 사용했다면 다양하게: 설명하는 화면으로 열리는 노트, 3D 깊이의 변경된 표면, 동일한 프레임의 이전/이후 wipe, 새 흐름의 튜토리얼. site-promo-film §2에 카탈로그가 있습니다; 릴리스 영상은 하나를 선택하여 스토리보드에 명시합니다.
  • 주요 릴리스는 긴 영상을 포함할 수 있습니다 (1–3분, 피처링된 변경 사항당 하나의 챕터, 루프 없음) site-promo-film §2b의 타임라인에 따라, 소셜 게시물용 짧은 클립과 별도로.

3b — 모든 클릭이 보여야 함

릴리스 영상은 대부분 클릭이며, 클릭은 시청자가 착지하는 것을 반드시 봐야 하는 비트입니다. 30초 컷은 움직임이 너무 빠르고 일부 클릭이 누락된 상태로 재생되었습니다. 측정 결과: 두 번의 클릭이 프레임이 1255 및 1414 px/s로 움직일 때 발생했으며, 대부분의 클릭은 목표에서 20-45 pt 떨어진 정지된 커서에 착륙했습니다. 아래 규칙에 따라 타이밍을 맞춘 60초 컷은 모든 클릭이 2 px/s 미만, 1 pt 이내에서 측정되었습니다.

  • 카메라는 클릭 전에 도착해야 합니다. 클릭을 담기 위한 카메라 이동을 클릭 약 1.3초 전에 시작하고, UI가 응답한 후에만 이동합니다.
  • 커서는 누르기 전에 멈춥니다: 각 이동에 느린 스프링으로 약 2초를 줍니다 (가로 f 0.85, 세로 0.75; 짧은 이동은 더 빠를 수 있음), 그래서 0.5초 동안 정지합니다.
  • 누르는 동안 유지되며, 충분히 길게 눌러 보이도록 합니다 (내리기 0.05초, 올리기 0.14초 후), 더 큰 링 포함; 다음 이동은 누른 후 0.3초 이후에 시작합니다.
  • 클릭이 여는 것은 클릭한 것을 덮지 않습니다: 패널은 해당 항목 아래에서 떨어지고, 창은 알림이 온 옆에서 자라며, 시트(sheet)는 버튼을 누른 후 0.15-0.2초 후에 닫힙니다. 첫 번째 60초 마스터는 셸(shell)을 누른 항목 위로 자라게 하여 숨겼습니다. 정확한 시간의 스틸은 이를 절대 보여주지 않았고, mp4에서 뽑은 프레임도 마찬가지였습니다.
  • 확인하기: 진행 전에 node clickcheck.mjs release.html 실행 (클릭 지점의 카메라, 누르기 전 및 동안의 이동 거리 측정; 두 템플릿 모두 통과), 렌더 후 각 클릭 시간에 mp4에서 프레임 추출 (site-promo-film §7).
  • iPhone 또는 iPad에서 (브리프의 frame, site-promo-film §0) 클릭은 탭(tap)입니다: 화살표가 그려지지 않고, 손가락은 탭하는 동안만 표시됩니다 (룩의 리플이 있는 누르는 부드러운 디스크). 페이지는 여전히 CLICKS를 선언하며, curX(t) / curY(t)는 손가락이 있는 곳입니다: 탭 사이의 다음 탭 지점으로 점프하고 각 탭 전후에 정지하므로, clickcheck.mjs는 클릭과 동일하게 탭을 측정하며, CLICKS가 없는 페이지도 exit 2를 반환합니다. 위의 규칙과 카메라 규칙은 그대로 적용됩니다.

4 — 레이아웃: 슬롯(slot)과 자유 영역(free region)

템플릿은 수동 조정 대신 카메라를 계산합니다. fit(rect, head)는 월드 rect가 자유 영역 (와이드의 경우 헤드라인 슬롯 옆, 스퀘어의 경우 아래, 또는 헤드라인 없이 전체 프레임)을 채우도록 하는 카메라를 반환하며, zmax에서 제한됩니다. 세 가지 규칙, 각각 데모 빌드 중 측정됨:

  • 헤드라인이 있는 경우, 클로즈업은 슬롯 방향 표면 자체 가장자리까지 도달합니다 (toEdge). 세부 사항만 맞추면 창의 나머지는 헤드라인 아래로 미끄러지며, 헤드라인은 절반은 캔버스 위에, 절반은 어두운 창 위에 놓입니다.
  • 스퀘어에서 클로즈업은 표면의 전체 너비를 유지합니다, 그렇지 않으면 행 레이블이 프레임 양쪽 가장자리에서 잘립니다.
  • 떠나는 타이틀은 모핑(morphing)하는 모양 아래에 그려집니다, 그래서 창이 그 위로 자랍니다. 위에 그려지면, 사라지는 글자가 0.5초 동안 창 위에 인쇄됩니다.

두 번째 종횡비는 첫 번째의 크롭이 아닌 별도 레이아웃입니다: 페이지는 location.hash를 읽고, PAGE='release.html#square'는 해시를 render.mjs에 전달합니다. 해시는 룩도 가져오며, &로 연결됩니다: PAGE='release.html#square&look=night'.

5 — 키트: 제품의 모든 영상은 하나의 쇼처럼 보여야 함

제품의 첫 번째 영상(또는 사이트 프로모션 영상)은 키트를 생성합니다: 글꼴, 색상 토큰, 아이콘 벡터, 버전 카드, 창 크롬, 카메라 언어, 룩(프리셋 및 오버라이드: 하나의 FX.look 라인). 제품과 함께 커밋하고, 지침에 따라 저장합니다 (그렇지 않으면 위치 제안, 지금까지는 scripts/film/). 작업 폴더를 버리기 전에 커밋하여, 다음 릴리스가 템플릿이 아닌 키트에서 시작하도록 합니다: 하나의 스토리보드, 콘텐츠만 변경되며, 시리즈가 인식 가능해집니다. 버전 카드에서는 숫자만 변경됩니다.

키트가 유지하는 것은 엔진이 아닌 페이지입니다. 엔진은 스킬의 것이며 모든 영상에 대해 다시 복사됩니다. 페이지는 작업입니다: 제품의 표면을 벡터로, 모든 문자열은 태그에서 가져오고, 검토 라운드를 통과한 타이밍, 그리고 해당 라운드가 가르친 내용을 담은 README입니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬