App Store チェンジログ

概要

git 履歴から最後のタグ以降のすべての変更を収集し、ユーザー向けのわかりやすい App Store リリースノートに翻訳します。

ワークフロー

1) 変更を収集する

• リポジトリのルートから scripts/collect_release_changes.sh を実行して、コミットと変更されたファイルを収集します。
• 必要に応じて、特定のタグまたはリファレンスを渡します: scripts/collect_release_changes.sh v1.2.3 HEAD
• タグが存在しない場合、スクリプトは完全な履歴にフォールバックします。

2) ユーザー影響による分類

• コミットとファイルをスキャンしてユーザーに見える変更を特定します。
• 変更をテーマ別 (新機能、改善、修正) にグループ化し、重複を排除します。
• 内部専用の作業 (ビルドスクリプト、リファクタリング、依存関係の更新、CI) は削除します。

3) App Store ノートを作成する

• ユーザー向けの各変更に対して、簡潔で利点を中心とした箇条書きを記述します。
• 明確な動詞と平易な言葉を使用し、内部用語は避けます。
• ユーザーが別の長さを指定しない限り、5～10 個の箇条書きを優先します。

4) 検証する

• すべての箇条書きが指定範囲内の実際の変更にマップされていることを確認します。
• 重複と過度に技術的な表現をチェックします。
• 変更が曖昧または内部専用の可能性がある場合は、明確化を求めます。

コミットから箇条書きへの例

生のコミットメッセージが App Store の箇条書きにどのように翻訳されるかを以下に示します:

生のコミットメッセージ	App Store 箇条書き
fix(auth): resolve token refresh race condition on iOS 17	• iOS 17 でユーザーが予期せずログアウトしてしまうログイン問題を修正しました。
feat(search): add voice input to search bar	• 新しい音声入力オプションでハンズフリーでライブラリを検索できます。
perf(timeline): lazy-load images to reduce scroll jank	• タイムラインのスクロールがより滑らかで高速になりました。

削除される ユーザー影響がない内部専用コミット:

• chore: upgrade fastlane to 2.219
• refactor(network): extract URLSession wrapper into module
• ci: add nightly build job

出力例

What's New in Version 3.4

• Search your library hands-free with the new voice input option.
• Scrolling through your timeline is now smoother and faster.
• Fixed a login issue that could leave some users unexpectedly signed out.
• Added dark-mode support to the settings screen.
• Improved load times when opening large photo albums.

出力形式

• タイトル (オプション): "What's New" または製品名 + バージョン。
• 箇条書きのみ。1 つの箇条書きにつき 1 文。
• ユーザーが指定した場合、ストアフロントの制限に従います。

リソース

• scripts/collect_release_changes.sh: 最後のタグ以降のコミットと変更されたファイルを収集します。
• references/release-notes-guidelines.md: App Store ノートの言語、フィルタリング、QA ルール。