ai-git-tools 2.0.72 → 2.0.73

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.0.72",
+  "version": "2.0.73",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",

package/src/pr-modules/ai/code-analyzer.js

@@ -143,13 +143,25 @@ ${skillsSummary}
 > type 必須是以下之一：feat / fix / refactor / style / docs / test / chore / perf
 > **重要**：如果有新增任何功能、新增檔案、新增 API、新增組件，優先使用 **feat**
 
-## 📝 變更摘要
-[簡述這個 PR 的主要目的和影響範圍，2-3 句話]
+## � 摘要
+[1-2 句話說明這個 PR 做了什麼、解決了什麼問題]
 
-## 🎯 主要變更
-- [變更項目 1]
-- [變更項目 2]
-- [變更項目 3]
+---
+
+## ✏️ 做了什麼 (What)
+- [具體變更項目 1]
+- [具體變更項目 2]
+- [具體變更項目 3]
+
+## ❓ 為什麼 (Why)
+- [說明這個改動的背景或原因]
+- [使用者痛點或產品需求]
+
+## ⚙️ 怎麼做到的 (How)
+- [技術實作重點說明 1]
+- [技術實作重點說明 2]
+
+---
 
 ## 🔀 變更類型
 - [ ] ✨ 新功能 (feat)
@@ -173,53 +185,51 @@ ${skillsSummary}
 > 
 > **特別注意**: 如果 diff 中有「新增檔案」或「新增功能」，**務必勾選** ✨ 新功能 (feat)
 
-## 🧪 測試方法
-1. [具體的測試步驟 1]
-2. [具體的測試步驟 2]
-3. [具體的測試步驟 3]
-
-## 💥 Breaking Changes
-[如果有破壞性變更請詳細說明，沒有則填寫「無」]
-
-## 📌 注意事項
-[需要特別注意的事項]
-
-## 📸 截圖
-[如果是 UI 變更，提醒需要截圖]
+## 🎯 影響範圍
+- 影響模組：[列出受影響的頁面 / 模組 / API]
+- 無影響其他模組（或說明有影響的範圍）
 
 ---
 
-## ✅ 已套用規則總結
+## 🧪 測試項目
+- [ ] [測試項目 1]
+- [ ] [測試項目 2]
+- [ ] [測試項目 3]
 
-> 請根據上方提供的專案規範（React Best Practices 和 Frontend Guidelines），分析本次程式碼變更
+## 📸 截圖（UI 變更必填）
+[放截圖，非 UI 變更可填 N/A]
 
-### React Best Practices 規則
+---
 
-**✅ 已正確套用的規則**：
-[列出本次變更中有正確使用的規則]
+## ⚠️ 風險與注意事項
+**Risk Level**: \`LOW\` / \`MEDIUM\` / \`HIGH\`
 
-**❌ 需要改善的項目**：
-[列出本次變更中違反的規則]
+[說明潛在風險、破壞性變更（breaking changes）、需要特別小心的地方；沒有則填「無」]
 
-### Frontend Guidelines
+## 👀 Reviewer 重點
+- [請 reviewer 特別關注的邏輯或設計決策 1]
+- [請 reviewer 特別關注的邏輯或設計決策 2]
 
-[根據程式碼實際內容檢查相關項目]
+## 🔗 相關 Issue
+- Closes #[issue 編號]（沒有則填「無」）
 
 ---
 
 **規則**：
 1. PR 標題格式：type: 簡短描述（不超過 50 字）
 2. type 必須符合 Conventional Commits
-3. 變更摘要用 2-3 句話概括整體影響
-4. 全部使用繁體中文（台灣正體）
-5. 不要在開頭加引導語句
-6. 直接開始輸出 # [type]: [標題]
+3. 摘要用 1-2 句話說明目的，不要流水帳
+4. Why 說明背景原因，How 說明技術手段，兩者不可混淆
+5. 全部使用繁體中文（台灣正體）
+6. 不要在開頭加引導語句，直接輸出 # [type]: [標題]
 7. **變更類型判斷必須準確**：
    - 檢查 diff 中是否有 "new file mode" 或大量 "+++" 行（表示新增檔案）
    - 檢查 commit 訊息是否包含「新增」、「add」、「feat」等關鍵字
-   - 檢查主要變更列表，如果提到「新增 xxx」就必須勾選 ✨ 新功能 (feat)
    - 新增配置檔、新增組件、新增 API、新增功能都算 feat
    - 一個 PR 可以同時是多種類型（如：feat + refactor + chore）
+8. **Risk Level 判斷**：HIGH = 影響付款/登入/資料寫入核心流程；MEDIUM = 影響現有功能但有降級保護；LOW = 新增功能或純重構
+9. **Reviewer 重點**：列出最值得仔細看的 1-3 個地方（核心演算法、架構決策、潛在邊界條件）
+10. **相關 Issue**：若 commit 訊息含 #issue 編號或 closes/fixes/resolves，自動帶入；否則填「無」
 
 ---