Initial commit

2025-11-30 08:40:29 +08:00
commit 62834b5918
7 changed files with 675 additions and 0 deletions
--- a/commands/commit-push-all.md
+++ b/commands/commit-push-all.md
@@ -0,0 +1,154 @@
+---
+description: Commit and Push All
+allowed-tools: Bash(git add:*),Bash(git branch:*),Bash(git diff:*),Bash(git log:*),Bash(git push:*),Bash(git status:*),Bash(git symbolic-ref:*)
+model: claude-haiku-4-5
+---
+
+無條件將所有變更提交並推送到遠端儲存庫，不考慮提交原子性。
+
+## 工作目錄資訊
+
+將所有檔案加入暫存區：
+
+```
+# 執行 git add .
+!`git add .`
+```
+
+檔案變更與暫存狀態的清單：
+
+```
+!`git status --short`
+```
+
+檔案變更的詳細內容：
+
+```
+!`git diff --cached`
+```
+
+最近五筆提交訊息：
+
+```
+!`git log --oneline -5`
+```
+
+分支資訊：
+
+- **遠端主要分支**： !`git symbolic-ref refs/remotes/origin/HEAD`
+- **當前分支**： !`git branch --show-current`
+
+所有分支清單：
+
+```
+# 本地分支
+!`git branch`
+
+# 遠端分支
+!`git branch -r`
+```
+
+## 流程
+
+### 步驟 1：確認目標分支
+
+分析「工作目錄資訊」中收集到的變更狀態，總結所有變更內容。
+
+使用 AskUserQuestion 工具詢問目標推送分支：
+
+**問題**：要推送到哪個分支？
+- 選項：`[當前分支: main]` / `[branch1]` / `[branch2]`
+
+分支選項建議：
+- **當前分支** - 在目前的分支上提交並推送
+- **其他可能的分支** - 根據修改內容推測相關的分支名稱
+
+若使用者手動輸入的分支名稱不存在，則建立新分支。
+
+**注意事項**：
+- 除非必要，否則不要提供「切換到新的分支」的選項
+- **IMPORTANT**：若使用者沒有回答或回答空白選項，則必須重新確認
+
+### 步驟 2：產生提交訊息
+
+根據記憶中的提交訊息格式偏好產生提交訊息，若無特別指示則使用以下格式：
+
+#### 基本格式
+
+```
+<簡短描述所有變更>
+
+- <type>: <變更描述>
+- <type>: <變更描述>
+- <type>: <變更描述>
+```
+
+- **標題**：簡單描述這次提交的整體內容（不使用 Conventional Commits 前綴）
+- **內容**：使用 Conventional Commits 類型標示各項變更
+
+#### Conventional Commits 類型
+
+- `feat`: 新功能
+- `fix`: 修復問題
+- `docs`: 文件更新
+- `style`: 程式碼格式調整
+- `refactor`: 重構
+- `test`: 測試
+- `chore`: 建置或輔助工具
+
+#### 範例
+
+**範例 1：混合類型變更**
+```
+更新認證系統與文件
+
+- feat: 新增 OAuth 登入功能
+- fix: 修正驗證碼過期問題
+- docs: 更新 API 文件
+- test: 補充單元測試
+```
+
+**範例 2：單一類型多項變更**
+```
+完善登入驗證功能
+
+- feat: 實作 email 驗證邏輯
+- feat: 加入驗證碼過期檢查
+- test: 更新相關單元測試
+```
+
+**範例 3：簡單變更**
+```
+修正登入頁面錯誤訊息顯示
+
+- fix: 修正驗證失敗時的錯誤訊息
+```
+
+### 步驟 3：執行提交與推送
+
+#### 3-1. 提交
+
+所有檔案已在「工作目錄資訊」階段加入暫存區，使用步驟 2 產生的提交訊息執行 commit：
+
+```bash
+git commit -m <提交訊息>
+```
+
+#### 3-2. 推送
+
+推送到使用者選擇的分支：
+
+```bash
+git push -u origin <分支名稱>
+```
+
+## 注意事項
+
+### 提交特性
+- **全部提交**：此指令會無條件提交工作目錄中的所有變更
+- **不考慮原子性**：即使包含多種類型的修改，也會合併成單一提交
+- 提交訊息應盡可能清楚描述所有變更內容
+
+### 錯誤處理
+- 執行指令偶爾會出現 `.git/index.lock` 鎖定的錯誤，當指令提示詞正常啟動後，可以忽略這個錯誤
+- 遇到其他任何錯誤時立即停止，回報錯誤訊息給使用者
--- a/commands/commit-push.md
+++ b/commands/commit-push.md
@@ -0,0 +1,174 @@
+---
+description: Commit and Push
+allowed-tools: Bash(git add:*),Bash(git branch:*),Bash(git diff:*),Bash(git log:*),Bash(git reset:*),Bash(git push:*),Bash(git status:*),Bash(git symbolic-ref:*)
+model: claude-haiku-4-5
+---
+
+協助產生符合專案規範的提交訊息，並推送到遠端儲存庫。
+
+## 工作目錄資訊
+
+將所有檔案重新設定成追蹤清單：
+
+```
+!`git add -N .`
+```
+
+檔案變更與暫存狀態的清單：
+
+```
+!`git status --short`
+```
+
+檔案變更的詳細內容：
+
+```
+!`git diff`
+```
+
+最近五筆提交訊息：
+
+```
+!`git log --oneline -5`
+```
+
+分支資訊：
+
+- **遠端主要分支**： !`git symbolic-ref refs/remotes/origin/HEAD`
+- **當前分支**： !`git branch --show-current`
+
+所有分支清單：
+
+```
+# 本地分支
+!`git branch`
+
+# 遠端分支
+!`git branch -r`
+```
+
+## 流程
+
+### 步驟 1：分析工作目錄資訊
+
+分析「工作目錄資訊」中收集到的變更狀態，使用一次 AskUserQuestion 工具同時確認：
+1. 要提交的檔案範圍（是否符合提交原子性）
+2. 目標推送分支
+
+#### 1-1. 檔案變更狀態
+
+分析工作目錄的變更，判斷是否符合提交原子性：
+
+**符合原子性**：所有變更都屬於同一個邏輯修改
+- 不使用 AskUserQuestion 詢問檔案範圍
+- 只詢問目標推送分支
+- 直接提交所有變更
+
+**違反原子性**：包含多個不相關的修改
+- 依 Conventional Commits 類型分類檔案：
+    - `feat:` 新功能
+    - `fix:` 修復問題
+    - `docs:` 文件更新
+    - `style:` 程式碼格式調整
+    - `refactor:` 重構
+    - `test:` 測試
+    - `chore:` 建置或輔助工具
+
+- 輸出分類後的預計 commit message 和前三個重要檔案：
+  ```
+  1. feat: [commit message]
+     - [檔案路徑]
+     - [檔案路徑]
+     - [檔案路徑]
+  2. docs: [commit message]
+     - [檔案路徑]
+  ```
+
+- 在 AskUserQuestion 中提供複選選項，讓使用者選擇要提交哪些分類
+
+#### 1-2. 分支狀態
+
+在 AskUserQuestion 中提供分支選項：
+- **當前分支** - 在目前的分支上提交並推送
+- **其他可能的分支** - 根據修改內容推測相關的分支名稱
+
+若使用者手動輸入的分支名稱不存在，則建立新分支。
+
+**注意：除非必要，否則不要提供「切換到新的分支」的選項**
+
+#### 1-3. AskUserQuestion 範例
+
+同時詢問檔案範圍和目標分支，例如：
+
+**問題 1**：要提交哪些變更？
+- 選項：`[feat: 新增登入功能]` / `[docs: 更新 README]`
+
+**問題 2**：要推送到哪個分支？
+- 選項：`[當前分支: main]` / `[branch1]` / `[branch2]`
+
+**IMPORTANT**：在使用 AskUserQuestion 工具時，若使用者沒有回答或回答空白選項，則必須重新確認
+
+### 步驟 2：產生提交訊息
+
+根據記憶中的提交訊息格式偏好產生提交訊息，若無特別指示則使用 **Conventional Commits** 規範：
+
+#### 基本格式
+
+```
+<type>(<scope>): <subject>
+
+<body>
+```
+
+- `type`: 提交類型（feat, fix, docs, style, refactor, test, chore）
+- `scope`: 影響範圍（選填）
+- `subject`: 簡短描述（50 字以內）
+- `body`: 詳細說明（選填，使用 bullet points）
+
+範例
+
+```
+feat(auth): 新增登入驗證功能
+
+- 實作 email 驗證邏輯
+- 加入驗證碼過期檢查
+- 更新相關單元測試
+```
+
+### 步驟 3：執行提交與推送
+
+#### 3-1. 加入檔案
+
+先重置暫存區：
+
+```bash
+git reset .
+```
+
+然後根據步驟 1 使用者選擇的檔案範圍，使用 `git add` 加入檔案。
+
+#### 3-2. 提交
+
+使用步驟 2 產生的提交訊息執行 commit：
+
+```bash
+git commit -m <提交訊息>
+```
+
+#### 3-3. 推送
+
+推送到使用者選擇的分支：
+
+```bash
+git push -u origin <分支名稱>
+```
+
+## 注意事項
+
+### 提交原則
+- 每個提交應保持原子性，只包含相關的變更
+- 提交訊息應清楚描述變更內容和原因
+
+### 錯誤處理
+- 執行指令偶爾會出現 `.git/index.lock` 鎖定的錯誤，當指令提示詞正常啟動後，可以忽略這個錯誤
+- 遇到其他任何錯誤時立即停止，回報錯誤訊息給使用者
--- a/commands/resolve-conflict.md
+++ b/commands/resolve-conflict.md
@@ -0,0 +1,44 @@
+---
+description: 解決 Git 衝突
+allowed-tools: Bash(git status:*),Bash(git diff:*),Bash(git log:*),Skill(git:resolving-conflict)
+model: claude-sonnet-4-5
+---
+
+協助解決當前的 Git Rebase 或 Merge 衝突。
+
+## 工作流程
+
+### 1. 檢查衝突狀態
+
+先檢查當前是否處於衝突狀態：
+
+```
+!`git status`
+```
+
+### 2. 判斷處理方式
+
+根據 git status 的結果：
+
+**有衝突：**
+- 如果偵測到衝突（rebase in progress 或 You have unmerged paths），使用 Skill tool 調用 `git:resolving-conflict`
+- 該 skill 會系統化地引導解決所有衝突
+
+**無衝突：**
+- 提示使用者目前沒有衝突需要解決
+- 說明此指令適用於 `git rebase` 或 `git merge` 過程中遇到衝突的情況
+
+## 使用場景
+
+此指令適用於以下情況：
+
+- 執行 `git rebase` 時遇到衝突
+- 執行 `git merge` 時遇到衝突
+- 需要系統化地處理多個衝突檔案
+- 不確定如何正確解決衝突時
+
+## 注意事項
+
+- 解決衝突前會先展示完整的衝突內容
+- 使用 AskUserQuestion 提供所有可能的解決方案
+- 解決後建議執行測試確保功能正常