Initial commit

This commit is contained in:
Zhongwei Li
2025-11-30 08:40:29 +08:00
commit 62834b5918
7 changed files with 675 additions and 0 deletions

View File

@@ -0,0 +1,14 @@
{
"name": "git",
"description": "Git tools",
"version": "1.0.1",
"author": {
"name": "Miles Chou"
},
"skills": [
"./skills"
],
"commands": [
"./commands"
]
}

3
README.md Normal file
View File

@@ -0,0 +1,3 @@
# git
Git tools

154
commands/commit-push-all.md Normal file
View File

@@ -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` 鎖定的錯誤,當指令提示詞正常啟動後,可以忽略這個錯誤
- 遇到其他任何錯誤時立即停止,回報錯誤訊息給使用者

174
commands/commit-push.md Normal file
View File

@@ -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` 鎖定的錯誤,當指令提示詞正常啟動後,可以忽略這個錯誤
- 遇到其他任何錯誤時立即停止,回報錯誤訊息給使用者

View File

@@ -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 提供所有可能的解決方案
- 解決後建議執行測試確保功能正常

57
plugin.lock.json Normal file
View File

@@ -0,0 +1,57 @@
{
"$schema": "internal://schemas/plugin.lock.v1.json",
"pluginId": "gh:MilesChou/claude-marketplace:plugins/git",
"normalized": {
"repo": null,
"ref": "refs/tags/v20251128.0",
"commit": "7acdcac8426c3b02201fc00a2cbf82640ae651a2",
"treeHash": "babf482fdaef16c294a2e9617197b2dc980759690cc61757a971b7bb232d9046",
"generatedAt": "2025-11-28T10:12:07.564580Z",
"toolVersion": "publish_plugins.py@0.2.0"
},
"origin": {
"remote": "git@github.com:zhongweili/42plugin-data.git",
"branch": "master",
"commit": "aa1497ed0949fd50e99e70d6324a29c5b34f9390",
"repoRoot": "/Users/zhongweili/projects/openmind/42plugin-data"
},
"manifest": {
"name": "git",
"description": "Git tools",
"version": "1.0.1"
},
"content": {
"files": [
{
"path": "README.md",
"sha256": "cec10156b5ac1311ff635ad1ec73ad87c2d769477133039cf608ffb4dabc038b"
},
{
"path": ".claude-plugin/plugin.json",
"sha256": "fa45c245f66627315f4fd7f497fe6e1a9a1f37fd7e2781d4538549602f4a0f78"
},
{
"path": "commands/commit-push-all.md",
"sha256": "7ef85651f898e94cb0bfd35002e34ada887c7b05f7bd782a6c77920a11c15005"
},
{
"path": "commands/resolve-conflict.md",
"sha256": "9cee29fe1f3717a4c5041caeaba0ad3225e7d7ae2e9de66dd8c9ddb7d6548cba"
},
{
"path": "commands/commit-push.md",
"sha256": "020c46e82a99db69e32ecb2ea3f5b19b4be762964d3f72941b1c75f509c9fca4"
},
{
"path": "skills/resolving-conflict/SKILL.md",
"sha256": "fae6c996570a0a912d6e1f66ed5a626e4c1042ba1ef94b91050c14683a91a747"
}
],
"dirSha256": "babf482fdaef16c294a2e9617197b2dc980759690cc61757a971b7bb232d9046"
},
"security": {
"scannedAt": null,
"scannerVersion": null,
"flags": []
}
}

View File

@@ -0,0 +1,229 @@
---
name: Resolving-Conflict
description: 協助解決 Git Rebase 或 Merge 過程中的衝突,提供系統化的衝突解決流程。
---
# 解決 Git 衝突
協助使用者系統化地解決 Git Rebase 或 Merge 過程中的衝突。
## 核心功能
- 偵測當前的衝突狀態rebase 或 merge
- 列出所有衝突的檔案
- 逐個檢視並解決衝突
- 完成 rebase 或 merge 流程
## 執行步驟
### 1. 偵測衝突狀態
檢查當前是否處於衝突狀態:
```bash
git status
```
確認是 rebase 還是 merge 衝突:
- Rebase: 會顯示 `rebase in progress`
- Merge: 會顯示 `You have unmerged paths`
### 2. 列出衝突檔案
使用以下指令列出所有衝突的檔案:
```bash
git diff --name-only --diff-filter=U
```
或從 git status 中擷取:
```bash
git status --short | grep "^UU\|^AA\|^DD\|^AU\|^UA\|^UD\|^DU"
```
### 3. 解決衝突
對於每個衝突的檔案:
1. **讀取檔案內容**
- 使用 Read tool 檢視衝突標記
- 識別衝突區塊(`<<<<<<<`, `=======`, `>>>>>>>`
2. **展示衝突資訊**
- **IMPORTANT**: 在詢問使用者前,必須先清楚展示衝突的詳細內容
- 明確標示雙方的修改內容
- 說明衝突發生的位置和原因
- 範例格式:
```
檔案src/example.ts
衝突位置:第 10 行
衝突內容比對:
<<<<<<< HEAD (當前分支)
const value = "version A"
=======
const value = "version B"
>>>>>>> 合併進來的分支
```
3. **使用 AskUserQuestion 提供解決選項**
- 列出所有可能的解決方案
- 對於簡單衝突,提供:
- 保留當前分支版本ours
- 採用合併進來的版本theirs
- 對於需要手動整合的情況,明確列出所有組合:
- 方案 A + 方案 B
- 方案 B + 方案 A
- 其他自訂組合
- 讓使用者基於完整資訊做出選擇
4. **執行解決**
- 使用 Edit tool 根據使用者選擇移除衝突標記
- 保留或整合正確的程式碼
5. **標記為已解決**
```bash
git add <檔案路徑>
```
### 4. 完成流程
所有衝突解決後:
**Rebase:**
```bash
git rebase --continue
```
如果遇到「You must edit all merge conflicts」錯誤可能是索引狀態不一致使用以下方式重置
```bash
git reset && git add <已解決的檔案> && git rebase --continue
```
**Merge:**
```bash
git commit
```
如果需要放棄:
- Rebase: `git rebase --abort`
- Merge: `git merge --abort`
## 使用場景
### 適用情境
- 執行 `git rebase` 時遇到衝突
- 執行 `git merge` 時遇到衝突
- 需要系統化地處理多個衝突檔案
- 不確定如何正確解決衝突
### 處理策略
**簡單衝突:**
- 完全採用一方的修改ours 或 theirs
- 直接使用對應策略:
```bash
git checkout --ours <檔案> # 保留當前分支的版本
git checkout --theirs <檔案> # 採用合併進來的版本
```
**複雜衝突:**
- 需要手動合併雙方的修改
- 仔細檢視衝突區塊的上下文
- 整合兩邊的邏輯變更
## 工作流程範例
```
[執行 rebase 時遇到衝突]
User: 我在 rebase 時遇到衝突了,幫我解決。
Agent: 偵測到 rebase 衝突,有 2 個檔案需要解決:
1. src/auth/login.ts
2. README.md
開始解決第一個衝突...
檔案src/auth/login.ts
衝突位置:第 15 行
衝突內容比對:
<<<<<<< HEAD (當前分支)
if (user.verified) {
return authenticateUser(user)
}
=======
if (user.isVerified && user.active) {
return authenticate(user)
}
>>>>>>> feature/new-auth
Agent: [使用 AskUserQuestion]
要如何解決這個衝突?
選項:
1. 保留當前版本user.verified
2. 採用新版本user.isVerified && user.active
3. 整合:保留 isVerified 和 active 檢查,使用 authenticateUser
4. 其他自訂方案
User: [選擇選項 3]
Agent: 已解決 login.ts 並標記為已解決。
繼續處理 README.md...
[展示衝突並詢問]
User: [選擇保留雙方的文件更新]
Agent: 所有衝突已解決,執行 git rebase --continue
Rebase 成功完成!
User: [確認結果並繼續開發]
```
## 注意事項
### 安全檢查
- **資訊透明化**:在詢問使用者前,務必先展示完整的衝突內容和上下文
- **明確選項**:提供所有可能的解決方案,包括手動整合的不同組合方式
- 解決衝突前先確認了解雙方的修改意圖
- 不確定時使用 AskUserQuestion 詢問使用者應該保留哪個版本
- 解決後建議執行測試確保功能正常
### 常見錯誤
**避免:**
- 未展示衝突詳細內容就直接詢問使用者如何解決
- 手動整合選項不夠明確(例如只提供「整合雙方」而不列出具體組合方式)
- 直接刪除所有衝突標記而不檢視內容
- 未理解程式碼脈絡就決定保留哪個版本
- 解決衝突後未執行測試
**推薦:**
- 先展示完整的衝突資訊,再使用 AskUserQuestion 提供明確選項
- 列出所有可能的解決方案,包括不同的整合順序
- 仔細閱讀衝突區塊的上下文
- 理解兩個版本的差異原因
- 可能的話整合雙方的優點
- 解決後執行相關測試
### 特殊情況
**二進位檔案衝突:**
```bash
# 只能選擇其中一個版本
git checkout --ours <二進位檔案>
# 或
git checkout --theirs <二進位檔案>
```
**檔案刪除衝突:**
- 一方修改,一方刪除
- 需要判斷是否應該保留或刪除該檔案
## 整合其他工具
解決衝突後建議:
- 使用 `reviewers:requesting-code-review` 檢視解決方案
- 執行專案的測試套件