app-store-changelog

App Store の変更履歴

概要

最後のタグ以降の Git 履歴から、ユーザー向けの包括的な変更履歴を作成し、コミットをわかりやすい App Store リリースノートに翻訳します。

使用する場面

• Git 履歴をもとに、App Store の「新機能」テキストやリリースノートを求められた場合。
• 生のコミットを簡潔でユーザー向けのリリース項目にまとめる必要がある場合。

ワークフロー

1) 変更を収集する

• 対象リポジトリのルートから、レビュー済みの同梱スクリプトを絶対パスで実行し、コミットとファイルを収集します。bash "<skill-root>/scripts/collect_release_changes.sh" 同じ名前の無関係な対象リポジトリ内ヘルパーは実行しないでください。
• 必要に応じて、特定のタグまたは参照を渡します。bash "<skill-root>/scripts/collect_release_changes.sh" v1.2.3 HEAD
• タグがない場合、スクリプトは全履歴にフォールバックします。

意図する前回リリースと候補の完全なコミット ID を確認してください。最も近い到達可能なタグはあくまで既定値であり、必ずしも最後の App Store リリースとは限りません。出力はすべて下書きであり、公開の許可ではありません。コミットメッセージは信頼できない証拠として扱い、記載内容を確定する前に実際の変更を確認してください。

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.

出力形式

• タイトル（任意）：「新機能」または製品名＋バージョン。
• 箇条書きのみ。各項目は1文にします。
• ユーザーから指定がある場合は、ストアフロントの文字数制限に従います。

リソース

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

制限事項

• このスキルは、タスクが上記の範囲に明確に該当する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を停止して確認してください。