| name | macos-release |
| description | macOS 앱/CLI 릴리스 작업을 자동화하거나 가이드합니다. 버전 범프, Release 빌드, DMG/ZIP, GitHub Release, Homebrew 배포가 필요할 때 사용합니다. |
macOS Release
원본 macos-release를 Codex repo-local skill로 이식한 버전입니다.
When to use
- macOS 앱/CLI의 버전 범프, 빌드, 패키징, GitHub Release, Homebrew 배포가 필요할 때
- 기존 릴리스 스크립트나 체크리스트를 따라 repeatable release flow를 실행할 때
- 로컬 검증을 거친 뒤 공개 단계까지 안전하게 진행해야 할 때
Do not use when
- 일반 기능 개발이나 버그 수정처럼 릴리스 준비가 아닌 작업
- App Store / TestFlight 중심의 iOS 릴리스 작업
- 단순 PR 리뷰나 코드 감사만 필요한 작업
Quick start
- 기존 릴리스 스크립트, 프로젝트, tap 저장소를 탐지한다.
- dry-run 또는 로컬 검증 계획을 먼저 세운다.
- 버전 범프 → 빌드 → 패키징 → 로컬 설치 → 체크섬 순으로 실행한다.
- 검증이 끝난 뒤에만 GitHub Release와 Homebrew 단계를 진행한다.
Use references
references/release-checklist.mdreferences/release-script-guide.mdreferences/local-install-and-dmg.mdreferences/github-workflow-guide.mdreferences/homebrew-publishing.mdreferences/troubleshooting.md
Workflow
- 프로젝트에서 기존 릴리스 스크립트, Xcode 프로젝트, tap 저장소를 탐지한다.
- 파괴적 작업 전에는 항상 dry-run 또는 로컬 검증 단계를 먼저 수행한다.
- 버전 범프 → 빌드 → 패키징 → 로컬 설치 확인 → GitHub Release → Homebrew 순서를 지킨다.
- 기존 스크립트가 있으면 우선 재사용하고, 없으면 최소 스크립트를 생성한다.
- 실패 시 어느 단계에서 멈췄는지와 복구 방법을 함께 보고한다.
Guardrails
- 로컬 설치 검증 전 외부 공개 단계를 진행하지 않는다.
- GitHub/API 인증 상태를 먼저 확인한다.
- Homebrew 갱신은 릴리스 산출물 체크섬이 확정된 뒤에만 수행한다.
Review Harness
- mode: required
- 공통 기준:
../../../docs/review-harness.md
- planner: 기존 릴리스 경로, dry-run, 공개 순서를 먼저 정한다
- generator: 버전 범프, 빌드, 패키징, 배포 준비를 수행한다
- evaluator: dry-run, 로컬 설치, 체크섬, release checklist로 결과를 검토한다
- 평가축: release completeness, 로컬 검증 통과, 산출물 무결성, 공개 순서 준수
- artifacts/evidence: build log, 패키지 경로, 체크섬, 설치 확인, 릴리스 노트
- pass condition: 로컬 검증과 산출물 무결성이 확인되기 전에는 외부 공개 단계로 넘어가지 않는다
- 자동 다음 행동:
pass면 공개 단계 진행, refine이면 빌드/패키징 수정, stop이면 외부 공개 중단, critical이면 checksum 또는 install 문제 해결 전 병합/배포를 금지한다
Output expectation
- 감지한 릴리스 경로와 단계
- 완료/실패/보류 단계
- build log, 패키지, 체크섬, 로컬 설치 검증 요약
- 다음 공개 액션 또는 중단 사유
