develop-main-release

name	develop-main-release
description	aituber-kitでdevelop=>mainのPRをマージし、新しいマイナーバージョンをリリースする。アプリ表示バージョン更新、PRチェックとCodeRabbit reviewThreads確認、PRマージ、ローカルmain最新化、軽量タグ作成・push、CodeRabbit文を除外したGitHub Release発行時に使用。
user-invocable	true

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 => main PR本文を転記するが、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

手順

1. 対象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*'

2. 次のマイナーバージョンを決める。

例: 最新が v2.46.0 なら次は v2.47.0。

タグが既にある場合は止める。明示指示なしに既存タグを上書きしない。

git ls-remote --exit-code origin refs/tags/vX.Y.0

3. アプリの表示バージョンを更新する。

対象ファイル:

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

4. 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件であることを確認する。

5. PRをマージする。

すべての必須チェックが通り、mergeStateStatus が CLEAN で、現行review threadが0件ならマージする。

gh pr merge <pr-number> --merge
gh pr view <pr-number> --json state,mergedAt,mergeCommit,url

6. ローカル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する。未追跡・未コミット変更を巻き込まない。

7. タグを作成して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

8. Release本文を作る。

PR本文を取得し、CodeRabbit自動生成ブロック以降を削除する。

削除マーカー:

<!-- This is an auto-generated comment: release notes by coderabbit.ai -->

Release本文にはCodeRabbitコメント本文、CodeRabbit自動サマリー、CodeRabbitの指摘 のようなボット由来表現を入れない。必要なら具体的な修正内容だけに言い換える。

9. 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>

10. 最終確認を行う。

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を指していることを確認する。