av/remotion-bits

Remotion Bits 릴리스

이 스킬은 이 저장소에서 새 remotion-bits 릴리스를 준비하고 게시할 때 사용합니다.

이 스킬의 기능

이 스킬은 전체 릴리스 워크플로우를 수행합니다:

1. ./package.json에서 버전을 범프합니다. 사용자가 명시적으로 마이너, 메이저 또는 특정 버전을 요청하지 않는 한 기본적으로 패치 범프를 수행합니다.
2. 새 버전에 대한 간결한 릴리스 노트로 CHANGELOG.md를 업데이트합니다.
3. npm run registry:build를 실행합니다.
4. chore: vX.Y.Z로 릴리스 변경 사항을 커밋합니다.
5. 릴리스 커밋을 master에 푸시합니다.
6. git 히스토리와 병합된 PR에서 이전 릴리스 이후의 주요 변경 사항을 조사합니다.
7. 내부 브라우저가 아닌 시스템 수준 브라우저 열기를 사용하여 미리 채워진 GitHub 릴리스 양식을 엽니다.
8. GitHub 릴리스가 게시된 후 ./scripts/deploy-docs.sh로 문서를 배포합니다.
9. npm publish로 패키지를 npm에 게시합니다.

전제 조건

• 저장소 루트에서 작업합니다.
• 문서 개발 서버를 시작하지 마십시오.
• 릴리스 게시를 위해 유효한 GitHub, Cloudflare 및 npm 자격 증명이 이미 환경에 구성되어 있다고 가정합니다.
• 작업 트리에 관련 없는 사용자 변경 사항이 포함된 경우, 이를 되돌리지 마십시오. 변경 사항을 우회하거나 릴리스 파일에 영향을 미치는 경우 중단하고 사용자에게 문의하십시오.

릴리스 워크플로우

1. 대상 버전 결정

• ./package.json에서 현재 버전을 읽습니다.
• 사용자가 특정 버전을 제공한 경우 해당 버전을 사용합니다.
• 사용자가 범프 유형을 제공한 경우 이를 적용합니다.
• 그렇지 않으면 패치를 범프합니다.
• git 태그와 릴리스 제목은 vX.Y.Z여야 합니다.

2. 릴리스 노트 준비

• 마지막 릴리스 태그 이후의 커밋을 검토합니다.
• 변경 사항 요약에 도움이 되는 경우 병합된 PR을 검토합니다.
• 새 버전 섹션을 맨 위에 삽입하여 CHANGELOG.md를 업데이트합니다.
• 항목을 간결하고 사용자 지향적으로 유지합니다.
• 다음 형식을 사용합니다:

### vX.Y.Z

- 기능: 새 기능에 대한 간략한 설명
- 수정: 버그 수정에 대한 간략한 설명
- 개선: 개선 사항에 대한 간략한 설명
- 문서: 문서 변경에 대한 간략한 설명

3. 버전 범프 및 레지스트리 빌드

• ./package.json을 새 버전으로 업데이트합니다.
• 다음을 실행합니다:

npm run registry:build

• 빌드가 실패하면 중단하고 계속 진행하기 전에 근본적인 문제를 해결합니다.

4. 릴리스 커밋 및 푸시

• 릴리스 차이점을 검토합니다.
• 준비된 릴리스를 다음과 같이 커밋합니다:

git commit -am "chore: vX.Y.Z"

• 커밋을 master에 푸시합니다.
• 저장소가 원격보다 뒤쳐져 있거나 푸시가 실패하면 계속 진행하기 전에 해당 상태를 해결합니다.

5. GitHub 릴리스 초안 작성

• 변경 로그 요약과 최근 커밋에서 릴리스 노트를 구성합니다.
• xdg-open 또는 다른 시스템 수준 열기 명령(내부 브라우저 절대 사용 금지)으로 다음 URL을 엽니다:

https://github.com/everlier/remotion-bits/releases/new?tag=vX.Y.Z&target=master&title=vX.Y.Z&body=...

• 양식을 다음으로 미리 채웁니다:

  • tag: vX.Y.Z
  • target: master
  • title: vX.Y.Z
  • prerelease: false

• 릴리스 본문은 다음 구조를 따라야 합니다:

## 변경 사항

- 주목할 만한 새 기능당 한 문장.
- 주목할 만한 버그 수정당 한 문장.
- 주목할 만한 개선 사항당 한 문장.

**전체 변경 로그**: https://github.com/everlier/remotion-bits/compare/vX.Y.(Z-1)...vX.Y.Z

• 브라우저 확인이 필요한 경우 사용자가 GitHub 릴리스를 게시할 때까지 일시 중지합니다.

6. 문서 배포

• GitHub 릴리스가 게시된 후 다음을 실행합니다:

./scripts/deploy-docs.sh

7. npm에 게시

• npm 인증이 가능한지 확인합니다.
• 저장소 루트에서 게시합니다:

npm publish

결정 규칙

• 사용자가 달리 명시하지 않는 한 패치 릴리스를 기본값으로 합니다.
• 릴리스 노트가 불명확한 경우 사용자에게 묻기 전에 커밋 히스토리에서 유도합니다.
• 명령이 릴리스 아티팩트를 변경하는 경우 생성된 변경 사항을 릴리스 커밋에 유지합니다.
• 게시에 수동 브라우저 단계가 필요한 경우 해당 경계에서 중단하고 사용자에게 정확히 무엇이 기다리고 있는지 알린 후 확인을 받고 계속 진행합니다.
• GitHub, Cloudflare 또는 npm에 대한 자격 증명이 누락된 경우 중단하고 맹목적으로 재시도하는 대신 누락된 전제 조건을 보고합니다.

완료 확인 목록

• package.json에 대상 버전이 있습니다.
• CHANGELOG.md에 해당 버전에 대한 새 최상위 섹션이 있습니다.
• npm run registry:build가 성공적으로 완료되었습니다.
• chore: vX.Y.Z 릴리스 커밋이 존재하고 master에 푸시되었습니다.
• GitHub 릴리스 양식이 올바른 미리 채워진 값으로 열렸습니다.
• 문서 배포가 완료되었습니다.
• npm publish가 성공적으로 완료되었습니다.