Taiwan Holiday MCP Server

# Commit Message 改善範例 ## 基於您專案的實際 Commit 改善對照 ### 原始 Commit vs 改善後 #### 1. 文件更新類型 **原始：** ``` docs: 完成 Task 3.1 文件更新與專案狀態確認 - 更新 plan.md/verification/dev-notes.md/spec.md，標記所有子項目完成，記錄重大技術決定，升級到 v2.0 生產就緒版 ``` **改善後：** ``` docs: 完成 Task 3.1 專案狀態確認 更新專案核心文件： - plan.md: 標記所有子項目完成狀態 - verification/dev-notes.md: 記錄重大技術決定 - spec.md: 升級到 v2.0 生產就緒版本 相關任務: Task 3.1 ``` #### 2. 功能開發類型 **原始：** ``` feat: 完成 Task 1.3 - 早期 Cursor 整合驗證點 - 實作 MCP 伺服器框架、ping 工具、NPX 支援和完整測試驗證 ``` **改善後：** ``` feat(core): 完成 MCP 伺服器框架實作 實作核心功能： - MCP 伺服器基礎框架 - ping 工具與健康檢查 - NPX 支援與部署配置 - 完整測試驗證套件 相關任務: Task 1.3 - Cursor 整合驗證點 ``` #### 3. 測試完成類型 **原始：** ``` ✅ 完成 Task 2.3 中期 Cursor 驗證點 ``` **改善後：** ``` test: 完成 Task 2.3 中期驗證 通過 Cursor 整合測試驗證點 確認 MCP 伺服器與 Cursor 的相容性 驗證核心功能運作正常 相關任務: Task 2.3 ``` #### 4. 新增功能類型 **原始：** ``` feat: 新增 prompt-optimizer cursor rule ``` **改善後：** ``` feat(config): 新增 prompt-optimizer 規則 新增 Cursor 規則配置： - prompt-optimizer.mdc 規則檔案 - 支援 prompt 最佳化功能 - 整合 interactive-feedback-mcp 呼叫 相關功能: Cursor 規則系統 ``` #### 5. 重構類型 **原始：** ``` feat: 完成測試驗證模組化重構 - 分離驗證內容到獨立檔案，主文件精簡77%，提升可維護性 ``` **改善後：** ``` refactor(test): 模組化測試驗證架構 重構改善： - 分離驗證內容到獨立檔案 - 主文件程式碼精簡 77% - 提升測試可維護性和可讀性 效能提升: 程式碼可維護性大幅改善 ``` ## 您的專案特殊考量 ### 1. Task 導向開發 由於您的專案採用 Task 導向開發，建議在詳細描述中明確標註相關任務： ```bash feat(core): 新增假期查詢功能 實作台灣假期資料查詢邏輯 支援國定假日和傳統節日 新增日期範圍查詢功能 相關任務: Task 2.1 ``` ### 2. 中英文技術術語 保持技術術語的一致性： ```bash # ✅ 推薦 feat(api): 新增 MCP 工具註冊功能 fix(core): 修復 TypeScript 型別定義問題 docs: 更新 API 端點使用說明 # ❌ 避免 feat(api): 新增 model context protocol 工具註冊功能 fix(core): 修復 typescript 型別定義問題 ``` ### 3. 版本里程碑 對於重要的版本發布，使用特殊格式： ```bash chore: 發布 v2.0.0 生產就緒版本 主要更新： - 完成所有核心功能開發 - 通過完整測試驗證 - 準備生產環境部署 - 更新相關文件 里程碑: 生產就緒版本 ``` ## 實際應用建議 ### 1. 立即開始 從下一個 commit 開始使用新格式，不需要修改歷史記錄。 ### 2. 漸進改善 - 第一週：專注於使用正確的類型前綴 - 第二週：改善描述的清晰度 - 第三週：加入詳細描述和任務關聯 ### 3. 團隊協作 如果有其他協作者，分享這個指南並在 code review 時互相提醒。 ## 快速檢查清單 提交前檢查： - [ ] 使用正確的類型前綴（feat, fix, docs, etc.） - [ ] 簡短描述在 50 字元內 - [ ] 使用繁體中文和現在式動詞 - [ ] 如有相關 Task，在詳細描述中註明 - [ ] 避免使用模糊詞彙 - [ ] 技術術語保持一致性