tegnike develop => main マージ&リリーススキル
aituber-kitで develop => main PRをマージし、新しいマイナーバージョンのタグとGitHub Releaseを発行する。
基本方針
- 次のマイナーバージョンは、最新リリースタグ
vX.Y.ZからvX.(Y+1).0とする。 - アプリの表示バージョンはPRマージ前に
develop側へコミットしてpushする。 - 表示バージョンの正本は
src/constants/appVersion.jsonとし、設定フッターと起動ロゴはこの値を共有する。 - タグは軽量タグで作成する。
- GitHub Release本文は
develop => mainPR本文を転記するが、CodeRabbit自動生成ブロックとCodeRabbit由来の文言は含めない。 - main checkoutに未追跡のネストrepo等がある場合、checkoutせず
git branch -f main origin/mainで参照だけ更新する。 - 最終報告では、更新内容を関連するテーマごとにまとめ、詳細は入れ子のリストで簡潔に提示する。
- Discord共有用の文面はコードブロックに入れ、リリースURLはMarkdownリンクにせず裸URLで末尾に置く。
- 次の形式にする。
## vX.Y.0
- XXXを改善
- XXXに対応
- XXXを修正
- XXXを追加
https://github.com/tegnike/aituber-kit/releases/tag/vX.Y.0
手順
- 対象PRと最新バージョンを確認する。
gh pr view <pr-number> --json number,url,title,state,baseRefName,headRefName,mergeStateStatus,body,statusCheckRollup
gh release list --limit 10
git ls-remote origin 'refs/tags/v*'
- 次のマイナーバージョンを決める。
例: 最新が v2.46.0 なら次は v2.47.0。
タグが既にある場合は止める。明示指示なしに既存タグを上書きしない。
git ls-remote --exit-code origin refs/tags/vX.Y.0
- アプリの表示バージョンを更新する。
対象ファイル:
src/constants/appVersion.json
この1ファイルだけの version を更新する。フッターや起動スクリプトへバージョン番号を直接記述しない。
確認例:
node -e "const { version } = require('./src/constants/appVersion.json'); process.exit(version === 'X.Y.0' ? 0 : 1)"
node scripts/print-startup-logo.js | rg -F "AITuberKit vX.Y.0"
rg -n "appVersion" src/components/settings/shell/Footer.tsx scripts/print-startup-logo.js
変更後、差分を確認してコミット・pushする。
test "$(git branch --show-current)" = "develop"
test "$(gh pr view <pr-number> --json headRefName --jq .headRefName)" = "develop"
git diff -- src/constants/appVersion.json
git diff --check
git add src/constants/appVersion.json
git diff --cached --check
test "$(git diff --cached --name-only)" = "src/constants/appVersion.json"
git commit --only src/constants/appVersion.json -m "Bump app version to X.Y.0"
git push origin develop
- PRチェックとレビュー状態を確認する。
gh pr checks <pr-number> --watch=false
gh pr view <pr-number> --json mergeStateStatus,statusCheckRollup,latestReviews
CodeRabbitはフラットなレビュー本文だけで判断しない。GraphQL reviewThreads で isResolved == false かつ isOutdated == false の現行スレッドが0件であることを確認する。
- PRをマージする。
すべての必須チェックが通り、mergeStateStatus が CLEAN で、現行review threadが0件ならマージする。
gh pr merge <pr-number> --merge
gh pr view <pr-number> --json state,mergedAt,mergeCommit,url
- ローカルmainを最新にする。
git fetch origin main develop --prune
git branch -f main origin/main
git rev-parse main origin/main
main が別worktreeでcheckout中の場合は、そのworktreeを確認してfast-forwardする。未追跡・未コミット変更を巻き込まない。
- タグを作成してpushする。
マージcommitとアプリ表示バージョンを確認してから軽量タグを付ける。
git fetch origin main --prune
test "$(git rev-parse main)" = "$(git rev-parse origin/main)"
main_sha="$(git rev-parse origin/main)"
git show "${main_sha}:src/constants/appVersion.json" | node -e "const fs = require('fs'); const { version } = JSON.parse(fs.readFileSync(0, 'utf8')); process.exit(version === 'X.Y.0' ? 0 : 1)"
git tag vX.Y.0 "$main_sha"
git push origin vX.Y.0
- Release本文を作る。
PR本文を取得し、CodeRabbit自動生成ブロック以降を削除する。
削除マーカー:
<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
Release本文にはCodeRabbitコメント本文、CodeRabbit自動サマリー、CodeRabbitの指摘 のようなボット由来表現を入れない。必要なら具体的な修正内容だけに言い換える。
- GitHub Releaseを作成する。
gh release create vX.Y.0 --title vX.Y.0 --notes-file /tmp/aituber-vX.Y.0-release-notes.md --target <main-sha>
- 最終確認を行う。
gh release view vX.Y.0 --json tagName,name,url,targetCommitish,isDraft,isPrerelease,body
git ls-remote origin refs/heads/main refs/tags/vX.Y.0
git rev-parse main origin/main vX.Y.0
origin/main、ローカル main、vX.Y.0 が同じSHAを指していることを確認する。