git

Documentation

# Git Tools

協助自動化 Git 提交與推送流程的工具集，提供符合 [Conventional Commits 規範](https://www.conventionalcommits.org/)的提交訊息產生功能。

## 指令清單

### `/git:commit-push`

自動提交與推送指令，會分析變更內容並考慮提交原子性。

**功能特點：**

- 自動分析工作目錄變更狀態
- 判斷變更是否符合提交原子性
- 若包含多個不相關修改，可分類選擇要提交的檔案
- 產生符合 Conventional Commits 規範的提交訊息
- 支援選擇目標推送分支

**適用場景：**

- 需要精確控制每次提交內容
- 工作目錄包含多個邏輯獨立的修改
- 需要維持提交歷史的清晰度和原子性

### `/git:commit-push-all`

快速提交與推送指令，將所有變更一次性提交。

**功能特點：**

- 無條件提交工作目錄中的所有變更
- 不考慮提交原子性
- 產生綜合所有變更的提交訊息
- 支援選擇目標推送分支

**適用場景：**

- 快速提交所有進行中的工作
- 所有變更都屬於同一個邏輯範疇
- 臨時保存工作進度

## 使用建議

| 情境            | 建議指令                   | 說明                   |
|---------------|------------------------|----------------------|
| 工作目錄有多個不相關的修改 | `/git:commit-push`     | 可以選擇性地提交部分變更，保持提交原子性 |
| 需要分批提交以維持清晰歷史 | `/git:commit-push`     | 可以將變更分類，逐次提交         |
| 所有修改都屬於同一個功能  | `/git:commit-push-all` | 快速提交所有變更，節省操作步驟      |
| 臨時保存工作進度      | `/git:commit-push-all` | 快速提交所有進行中的工作         |

## 注意事項

- 兩個指令都會在提交前展示變更內容供確認
- 若分支不存在，會自動建立新分支
- 遇到錯誤時會立即停止並回報
- 建議在提交前先確認變更內容是否正確

## 版本記錄

請參閱 [CHANGELOG.md](./CHANGELOG.md) 查看詳細的版本變更記錄。
Commands

Documentation
