官方技能 · 產品

從已合併變更撰寫版本更新說明

v1.0.0 · 2026 年 11 月 4 日更新

根據已合併的 PR 或工單，撰寫先講好處、分成新功能／改進／修正的版本更新說明，另附內部變更紀錄。

加入我團隊的 Pod

可在 Claude、ChatGPT 和程式設計代理中使用。使用 Team 和 Business 方案時，我們改進官方技能後，你 Pod 裡的這個技能會自動更新。

適用情境

版本已上線，手上有 PR、工單或 commit 清單
需要「最新功能」頁面、產品內更新紀錄或每月產品更新

你要提供的內容

已合併的變更或工單清單
版本名稱或日期
客戶是誰（選用）

你會得到的內容

分成新功能、改進、修正的客戶版更新說明，以及附工單編號和客服注意事項的內部變更紀錄。

運作方式

刪掉客戶看不到的東西 重構、套件版本升級、測試變更、CI、內部工具和日誌記錄，只放進內部版本。沒有可見影響的變更，就不是版本更新說明的內容。
分成新功能、改進、修正 新功能＝使用者以前做不到的事。改進＝以前就能做，現在更快、更清楚或範圍更廣。修正＝以前壞掉、現在正常了。工單內容不清楚時，不要用猜的，把它放進內部清單並標上「[待確認：對使用者來說改了什麼？]」。
每一行改寫成先講好處 先寫使用者現在能做什麼，再寫怎麼做。寫「在發票頁面把發票匯出成 CSV」，而不是「新增 CSV 匯出 endpoint」。用產品畫面和按鈕上的名稱，不用程式內部的名稱。
修正項目要寫得讓使用者認得出那個錯誤 描述他們看到的症狀：「位於亞洲時區的使用者，日期不會再差一天。」不怪罪、也不過度道歉。從來沒影響到客戶的錯誤修正就省略。
依影響程度排序 每一類裡最常用或最多人要求的變更放最前面。對使用者來說是同一個變更的多張工單，合併成一行。
控制長度 每個變更一行，50 字以內（這個技能的預設值；一般建議是一到兩句）。只有在某個變更是這次版本的重點時，才加一句開場。新功能需要設定時，附上說明文章連結。
寫內部版本 使用 Keep a Changelog 的分類：Added、Changed、Deprecated、Removed、Fixed、Security，最新的版本放最前面並附日期。加上工單編號、一個放不可見工作的「內部」分類，以及客服需要知道的事（行為改變、已知問題、移轉步驟）。

分享給你的團隊

把它加入 AI Skill Pod，團隊每個人（外包人員也包括在內）都能從自己的 AI 使用同一個版本。看看和團隊分享 AI 技能的最佳做法