asc-whats-new-writer

asc-whats-new-writer 技能總覽

asc-whats-new-writer 是一個專為 App Store Connect 工作流程設計的發行說明撰寫技能。它可以把 git log、零散重點，或自由文字整理成在地化的「有什麼新功能」文案，並支援 ./metadata 裡的標準中繼資料，以及可選的促銷文字更新。如果你需要 asc-whats-new-writer 技能來服務 SEO 內容團隊、App 行銷人員，或想要不用從白紙開始就能產出精緻發行說明的發版管理者，這正是為這個情境打造的。

最適合的使用情境

當你已經知道這次釋出了什麼，但需要把技術性或零散的輸入，翻成面向使用者的語言時，最適合用 asc-whats-new-writer。它特別適合經常發版、維護多語系，或希望各版本之間都維持一致 App Store 語氣的團隊。

它的不同之處

這個技能不只是一般的發行說明提示詞。它有發行說明規則、多語系意識，還有一套會預期真實 App 中繼資料的工作流程。這讓 asc-whats-new-writer 比一次性的提示詞更適合用來做決策，尤其是在你需要能在 App Store 上順暢閱讀、且可跨版本重用的文案時。

什麼情況下很適合用

如果你的來源素材很雜，但輸出必須精簡、以效益為主，而且能直接上架，就選 asc-whats-new-writer。它很適合能提供 git 歷史、重點條列或變更摘要，並希望技能把它們整理成更好的商店文案的團隊。

如何使用 asc-whats-new-writer 技能

安裝 asc-whats-new-writer

請依照專案文件中顯示的 repo 路徑，把 asc-whats-new-writer 技能安裝到你的 skills 目錄。實作上，安裝路徑應指向 rudrankriyam/app-store-connect-cli-skills 與 skills/asc-whats-new-writer 資料夾。安裝完成後，先確認你能開啟 SKILL.md 和參考規範檔，再開始要求輸出。

先準備對的輸入

asc-whats-new-writer 最適合你提供三種輸入之一：git log 範圍、簡短條列，或白話的變更摘要。好的提示詞會明確寫出 App 名稱、版本號、語系、受眾，以及要包含或排除的具體變更。像「幫我寫發行說明」這種模糊提示，會讓技能被迫猜太多。

建議的閱讀順序

先讀 SKILL.md，再讀 references/release_notes_guidelines.md。這樣你會先掌握語氣規則、170 字元的開頭 hook 指引，以及段落結構，再開始下提示詞。如果你的 repo 有 metadata 拉取流程，請先查看最新版本資料夾與語系檔，讓技能能對應正確的發版資料來撰寫。

實際可行的使用流程

一個好的 asc-whats-new-writer 使用流程是：先蒐集變更、再去除雜訊、接著轉成使用者效益，最後起草在地化文案。提示詞範例可以這樣寫：「請使用 ./metadata 裡的最新中繼資料，只摘要這些 commits 中面向使用者的變更，撰寫一份 en-US 的 What’s New 草稿，並讓第一句 hook 在 App Store 上保持足夠吸睛。」這類指令能給技能足夠的結構，表現通常會更好。

asc-whats-new-writer 技能 FAQ

asc-whats-new-writer 只適合 App Store 發行說明嗎？

主要是。asc-whats-new-writer 技能的核心是 App Store Connect 的「有什麼新功能」文案，以及附近的促銷文字，不是一般部落格內容或長篇產品行銷。如果你要的是網站 SEO 頁面，這就不是對的工具。

使用前一定要先有 metadata 嗎？

不一定，但 metadata 會提升準確度。如果 ./metadata 底下有標準檔案，技能就能把輸出對齊到最新版本與語系。即使沒有，它仍可根據條列或自由文字運作，但你需要自己補更多背景資訊。

這跟一般提示詞有什麼不同？

一般提示詞可能只能一次性產出還不錯的發行說明。asc-whats-new-writer 提供的是可重複的流程：要收集什麼輸入、要刪掉哪些雜訊、要遵守什麼語氣、以及要先檢查哪些檔案。當你需要跨版本維持一致輸出時，這點特別重要。

asc-whats-new-writer 適合新手嗎？

適合，只要你說得出這次改了什麼。新手最好先從條列重點開始，而不是直接丟原始 git logs，因為條列更容易整理成面向使用者的效益。這個技能仍然需要你清楚知道 App、版本，以及預定語系。

如何優化 asc-whats-new-writer 技能

提供更好的來源素材給技能

品質提升最大的一步，就是讓輸入更乾淨。不要只寫「修正錯誤並提升效能」，而要提供更具體、使用者看得見的變更，例如「在弱網路下減少登入失敗」、「新增匯出 CSV」、「改善已儲存項目的搜尋結果」。這能幫助 asc-whats-new-writer 產出更具體、也更可信的文案。

一開始就先說清楚限制

如果有字數上限、在地化需求、禁用語句，或一定要提到的功能，請直接寫進提示詞。當 asc-whats-new-writer 知道該優先做強而短的 hook、三段式 New/Improved/Fixed 結構，或更嚴格的 App Store 語氣時，表現通常會更好。

先檢查 hook

對發行說明來說，第一句最重要。當你反覆調整 asc-whats-new-writer 的輸出時，先測試開頭句，再去修飾其他部分。如果 hook 沒有清楚告訴使用者這次更新為什麼重要，就請它改寫成更以效益為主的版本，並只保留一個主要成果。

透過排除項目持續優化

常見的失敗模式，是把內部變更寫得太多。請明確告訴技能哪些不要寫：重構、依賴套件升級、CI 更新，或不是面向使用者的文案。如果第一版太寬泛，就用一份簡短的排除清單縮小提示詞範圍，再重新執行 asc-whats-new-writer，通常能得到更精準的最終版本。