app-store-changelog

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	• ログイン時に一部のユーザーが予期せずサインアウトされる問題を修正しました。
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文にします。
• ユーザーから指定がある場合は、ストアフロントの文字数制限を守ります。

リソース

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