Communitygithub.com

whats-new-clip

릴리스마다 실제 제품 화면에서 짧은 What's New 클립을 제작합니다: 단어 우선, 실제 빌드에서 촬영, 사람이 보기 전에 검토.

whats-new-clip란 무엇인가요?

What's New 클립은 소프트웨어 릴리스의 변경사항을 스크롤 한 번에 전달하는 짧은 비디오 클립을 자동화하는 AI 에이전트 스킬입니다. 매 릴리스마다 동일한 질문과 버전을 표시하는 시작 카드, 각 변경사항을 실제 릴리스 빌드에서 촬영한 장면 하나와 캡션, 그리고 다운로드 위치를 알리는 종료 카드로 구성됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자 리포지토리의 `docs/agents/whats-new-clip.md` 파일에 프로젝트 정보가 저장됩니다. `scripts/clip.py` 도구를 통해 초기화, 촬영, 렌더링, 검사를 수행하며, 모든 과정은 단어 승인, 촬영, 렌더링, 검토, 인계 단계로 이루어집니다. 핵심 원칙은 '단어 우선(Words First)'으로, 승인자의 실제 표현을 그대로 사용하고 촬영 전에 모든 캡션을 먼저 합의합니다. 또한 사람이 결과물을 보기 전에 렌더링 스틸 이미지를 추출하여 REVIEW.md 기준으로 철저히 검증합니다. 스펙은 리포지토리에 보관되어 다음 릴리스가 빈 편집 세션 대신 이전 스펙에서 시작할 수 있도록 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GhostRoboticsLab/skills/tree/HEAD/skills/product/whats-new-clip

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

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

문서

What's New 클립

What's New 클립은 사람들이 스크롤하여 지나치는 시간 안에 릴리스가 무엇을 변경했는지 전달합니다: 매 릴리스마다 같은 질문을 하고 버전을 표시하는 시작 카드, 실제 릴리스 빌드에서 촬영된 각 변경사항당 한 장면과 캡션, 그리고 다운로드 위치를 알리는 종료 카드로 구성됩니다. 단어가 먼저 오며 승인자가 직접 작성합니다. 시드가 설정되고 반복 가능한 상태에서 촬영하며, 하나의 명령으로 렌더링하고, 사람이 보기 전에 렌더링 결과의 스틸 이미지를 검토합니다. 스펙은 리포지토리에 보관되므로 다음 릴리스는 빈 편집 세션 대신 이전 릴리스부터 시작할 수 있습니다.

프로젝트 정보는 사용자 리포지토리의 docs/agents/whats-new-clip.md에 저장됩니다: 릴리스 노트 위치, 릴리스 빌드 방법 및 시드 설정 방법, 이 화면 캡처 방법, 외관, 형식, 클립 보관 위치, 승인자. 해당 파일이 없으면 먼저 SETUP.md를 따르십시오.

도구는 scripts/clip.py입니다. uv run <이 스킬 폴더>/scripts/clip.py <명령어>로 실행하며, 모든 명령어에서 --help를 사용하면 플래그를 확인할 수 있습니다. ffmpeg와 ffprobe가 PATH에 있어야 하며, uv가 Pillow를 가져옵니다. uv가 없으면 리포지토리 외부에 가상 환경을 만드십시오(python3 -m venv <디렉토리> && <디렉토리>/bin/pip install pillow) 그리고 <디렉토리>/bin/python으로 도구를 실행하십시오. 스펙 형식과 check가 적용하는 모든 규칙은 SPEC.md에 있습니다.

1. 사람들이 주목할 것을 찾기

프로젝트 파일에 명시된 위치에서 릴리스 노트를 읽습니다. 사람이 보고, 듣거나 느낄 각 변경사항을 나열하고, 각각을 노트의 해당 줄과 연결합니다. 아무도 눈치채지 못하는 수정 사항과 내부 작업은 제외합니다.

목록에 사용자가 주목할 만한 것이 없다면, 승인자에게 이 릴리스에 클립을 만들지 물어보고, 승인자가 그렇다고 말하지 않으면 중단합니다.

완료 조건: 목록의 각 항목이 릴리스 노트의 한 줄을 가리키거나, 승인자가 이 릴리스에 클립이 없다고 말한 경우.

2. 단어 합의

변경사항당 하나의 캡션을 제안하고, 가장 강력한 것부터 순서대로 표시합니다. 한 장면당 하나의 변경사항입니다. 캡션은 평범한 단어로 표현된 사용자의 이점이며, 장면이 재생되는 동안 두 번 읽을 수 있을 정도로 짧습니다(약 6단어). 승인자가 이미 변경사항에 대한 단어를 제공한 경우(노트, 메시지, 인앱 What's New에서), 그대로 사용하십시오: 철자, 문법, 대소문자까지 그대로.

승인자에게 한 번에 전체 목록과 각 줄에 대한 추천을 제시하여, 한 단어로 답할 수 있도록 하십시오. 단어가 합의되기 전에는 촬영하지 마십시오: 캡션이 바뀌면 종종 다른 샷이 필요합니다.

승인자가 제품에도 표시되는 캡션(인앱 What's New 시트, 스토어 릴리스 노트)을 수정할 경우, 해당 텍스트도 변경되는지 물어보아 릴리스가 하나의 목소리로 말하도록 하십시오.

완료 조건: 승인자가 모든 캡션에 동의했고, 각 캡션을 합의된 대로 정확히 보유한 경우.

3. 스펙 작성

설치 과정에서 이미 이 버전의 스펙을 작성했다면 해당 파일을 채웁니다. 그렇지 않으면 마지막 릴리스의 스펙에서 시작하여 외관, 시작 문구, 종료 카드가 이어지도록 합니다:

clip.py init <버전> --out <스펙 폴더> --from <스펙 폴더>/<마지막 버전>.json

첫 번째 클립의 경우 --from 대신 --product "<이름>"을 사용합니다. 각 장면의 caption(2단계에서 그대로), words_by(단어를 제공한 사람), 캡션을 읽을 수 있을 만큼 충분히 긴 계획된 in 및 out을 채웁니다. 볼 것이 없는 변경사항은 캡션이 허용하는 가장 짧은 장면을 얻습니다. 그런 다음 clip.py check <스펙> --words를 실행합니다.

완료 조건: check --words가 check: ok를 출력한 경우.

4. 각 장면 촬영

FILMING.md의 규칙에 따라 각 장면을 촬영하며, 프로젝트 파일의 빌드, 시드 및 캡처 명령을 사용합니다. 이 릴리스에 포함된 것만 표시하십시오: 비활성화된 스위치 뒤에 있는 것, 다음 릴리스의 것은 표시하지 않습니다.

제품 자체 UI를 통한 실제 입력으로 변경사항에 도달할 수 없다면 중단하고 사용자에게 알리십시오: 그건 버그이며, 이를 우회하여 촬영한 클립은 사용자가 할 수 없는 것을 약속하는 것입니다.

프로젝트 캡처가 전혀 촬영할 수 없는 변경사항(카메라 뷰, 두 번째 기기)은 보관된 필름에서 보여줍니다: FILMING.md의 "캡처가 촬영할 수 없는 것"을 참조하십시오.

필름은 이 릴리스의 클립 폴더(리포지토리 외부)에 넣습니다. 각 단계가 실행될 때 기록된 시간을 기준으로 각 장면의 source, in 및 out을 설정하고, 마커를 신뢰하기 전에 확인하십시오:

clip.py peek <필름> --from <초> --to <초> --out <새로운 스크래치 폴더> --sheet <스크래치 폴더>/peek.png

이 명령은 render가 읽을 방식으로 필름의 두 초 사이를 보여줍니다. 자체 탐색으로 스틸을 가져오지 마십시오: 화면 녹화는 그림이 변경된 곳에서만 프레임을 보유하므로, 탐색은 다음 변경 지점으로 이동하며 이는 몇 초 후일 수 있습니다.

그런 다음 clip.py check <스펙> --media <필름 폴더>를 실행합니다.

완료 조건: check가 --media가 필름 폴더를 가리키는 상태에서 check: ok를 출력한 경우.

5. 렌더링

clip.py render <스펙> --media <필름 폴더> --out <클립 폴더>/<제품, kebab-case>-<버전>-9x16.mp4

프로젝트 파일에 명시된 각 추가 형식을 --size로 렌더링합니다(예: --size 1920x1080). render가 특정 크기에서 화면이 너무 작아 읽기 어렵다고 알릴 때(넓은 프레임 안의 전화기 화면), 해당 형식은 자체 스펙이 필요합니다: SPEC.md의 "다른 형식"을 참조하십시오. 사운드는 선택 사항이며 메시지를 전달하지 않습니다: 대부분의 사람들은 음소거 상태로 시청하므로, 캡션만으로 이야기를 전달해야 합니다.

완료 조건: render가 프로젝트 파일에 명시된 모든 형식에 대해 Wrote ...를 출력한 경우.

6. 검토자 패스

스틸 이미지를 새 폴더로 추출합니다: clip.py stills <클립> --spec <스펙> --every 1 --safe --out <스크래치 폴더> --sheet <스크래치 폴더>/sheet.png. 각 카드와 장면의 중간에서 하나, 매 초 하나씩 스틸을 작성하고, 피드가 덮는 가장자리가 색조로 표시된 시트를 만듭니다. 각 형식에 대해 REVIEW.md 기준으로 모든 스틸을 확인합니다.

하네스가 하위 에이전트를 시작할 수 있다면, 이 패스를 REVIEW.md, 스펙, 스틸 및 시트만 보유한 새 컨텍스트로 시작된 하위 에이전트에 위임하십시오: 화면에 있는 것을 보며, 의도한 촬영 내용은 보지 않습니다.

REVIEW.md의 표에 따라 각 발견 사항을 수정한 후, 다시 렌더링하고 스틸을 추출합니다. 인계 시 잘못된 그림을 설명하지 마십시오.

완료 조건: 모든 스틸이 REVIEW.md의 모든 항목을 통과하고, 대기 중인 수정 사항이 없는 경우.

7. 인계

REVIEW.md의 "인계"에 나열된 내용을 프로젝트 파일에 지정된 방식으로 승인자에게 보내고, OK 또는 수정 사항을 요청합니다. 승인자가 OK라고 말할 때까지 클립은 게시되지 않으며 릴리스에 첨부되지 않습니다. 게시는 프로젝트 파일에 명시된 사람이 수행합니다.

Not OK인 경우, 수정 사항을 2단계(단어) 또는 4단계(사진)로 되돌려 가져가고, 변경된 장면만 다시 촬영합니다. 이유 없는 Not OK: 동일한 샷을 다시 자르기 전에 한 번 무엇이 마음에 들지 않았는지 물어보십시오.

완료 조건: 승인자가 OK라고 말했거나, 수정 사항이 2단계 또는 4단계로 돌아간 경우.

8. 다음 릴리스를 위해 보관

스펙은 릴리스의 다른 변경사항과 함께 리포지토리에 보관합니다. 필름은 승인된 클립 옆에 클립 폴더에 보관합니다. 이 클립이 가르쳐준 각 교훈을 프로젝트 파일의 교훈 아래 한 줄로 추가합니다.

완료 조건: 스펙이 리포지토리에 있고, 필름이 승인된 클립 옆에 있으며, 모든 새로운 교훈이 docs/agents/whats-new-clip.md에 한 줄로 추가된 경우.

Individual skills in this repo

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

관련 스킬