リリースフロー（TinyCorn Studio 標準）
ユーザーが「release」「phát hành vX.Y.Z」「đẩy bản mới lên git」「build file cài + release」などと言った場合に適用します。 フロー全体を実行し、異常を検出しない限り各ステップを再確認しません。
前提条件
- リポジトリに
CHANGELOG.md（Keep a Changelog 形式）があり、リリース予定のバージョンに対応する## [<version>] - <date>セクションが存在すること。 - インストーラをビルドするスクリプト（通常
make-app.sh、VERSION変数を使用）が存在すること。 ghがログイン済みでrepo権限があること。- ワーキングツリーがクリーンであること（すべての機能がコミット済み）。
手順
1. バージョン更新（単一の情報源）
sed -i '' -E 's/^(VERSION=).*/\1"0.5.0"/' make-app.sh
2. インストーラのビルド
./make-app.sh
ls -lh dist/
3. CHANGELOG.md の更新
Keep a Changelog に従い、新しいエントリを先頭に追加します：
## [0.5.0] - 2026-10-18
### Added
- ...
### Fixed
- ...
4. コミット
git add -A
git commit -m "Release v0.5.0"
5. main ブランチへのマージ（feature ブランチの場合）
git checkout main && git merge --ff-only <feature-branch>
6. アノテーション付きタグの作成とプッシュ
git tag -a v0.5.0 -m "v0.5.0"
git push origin main --tags
7. インストーラファイルを含む GitHub Release の作成
リリースノートをベトナム語で作成（要約 + 「新機能」 + 「インストール」）、一時ファイルに保存し、次のコマンドを実行します：
gh release create v0.5.0 dist/<App>-0.5.0.dmg \
--title "v0.5.0 — <要約>" \
--notes-file /tmp/release_notes_v0.5.0.md
8. 確認
gh release view v0.5.0
確認内容：タグが正しいコミットを指しているか、アセットがアップロードされているか、ノートが正しく表示されているか。
自動スクリプト
このリポジトリには、make-app.sh を使用する macOS ツール向けの手順 1→7 を実行する scripts/release.sh が含まれています：
./scripts/release.sh 0.5.0
ルール
- インストーラファイル（DMG、ZIP）はリポジトリにコミットしない — GitHub Releases にのみ添付します。
dist/は.gitignoreに含める必要があります。 - CHANGELOG と README は同じリリース内で更新する必要があります。
- タグは常にアノテーション付きタグで、形式は
vX.Y.Z（SemVer）です。 - リリースノートはベトナム語で記述し、アプリが署名されていない場合の開き方の手順（右クリック → 開く）を含めます。
- プッシュが 403 エラーになった場合：
gh auth statusを確認し、gh auth setup-gitを実行し、トークンが組織に対する権限を持っているか確認します。