撰寫版本發布說明
- 找出範圍:執行
git describe --tags --abbrev=0取得上一個標籤。如果沒有標籤,則使用完整歷史記錄。 - 列出主題:執行
git log <上一個標籤>..HEAD --no-merges --pretty=format:%s。 - 使用 MCP 工具
group_commits(伺服器team-kit)處理這些主題。該工具會傳回按類型分組的 Markdown,並將重大變更擺在最前面。如果工具無法使用,請手動使用相同的標題進行分組。 - 為讀者而非提交者改寫:每個項目使用一句平實的句子,先說明使用者可見的影響,不要有票務雜訊。合併重複項目。保留「重大變更」底下的所有內容,並說明使用者必須做什麼。
- 輸出:
## <版本號> (<YYYY-MM-DD>)
<2-3 句摘要段落>
<分組章節>
絕對不要虛構任何不在提交列表中的變更。如果某個提交內容不清楚,請在敘述之前檢視其差異(git show <SHA> --stat)。如果你無法自行推斷版本號,請向使用者詢問。