whats-new

whats-new 技能是一個自動化的版本說明生成工具，旨在縮小技術性 git 歷史記錄與面向用戶的 App Store 更新之間的差距。透過識別主存儲庫分支中最近的兩次版本更新提交，代理程序可以隔離自上個版本發布以來的變更。它能有效地解析提交訊息，並在必要時檢查差異，以區分瑣碎的內部重構、基礎架構修改以及具體的用戶功能或錯誤修復。

此工具專為希望保持高品質、親切的版本說明且無需手動追蹤文件的軟體開發者和發布經理設計。它會自動將開發成果分類為「新功能」、「改進」和「錯誤修復」，確保剔除技術術語，轉而使用簡潔且適合目標受眾的語言。該工具生成的格式專門針對 App Store 標準規範，提供可直接使用的版本摘要。

• 透過 git 日誌模式匹配自動識別先前的歸檔點。

• 過濾掉 CI/構建配置、開發工具和不可見重構等雜訊。

• 將變更分組為結構化類別，以提高可讀性。

• 針對 App Store 發布提交欄位格式化輸出。

• 支援透過命令列參數覆蓋版本號。

• 專為使用描述性提交訊息的標準 git-flow 工作流程而設計。

• 在存儲庫遵循一致的「Bump version」提交慣例時表現最佳。

• 旨在產生 3 到 8 個簡潔、非技術性的項目符號，以達到最佳的用戶互動效果。

• 限制：需要 shell 環境存取權限以執行 git 指令，並假設 grep 和 log 工具符合標準 POSIX 規範。

• 用戶在發布到 App Store Connect 控制台之前，應審核生成的說明內容與語氣。