Cursor rule

1---
2description: Qclaw 開源貢獻的 Git 工作流程、Commit 格式與分支命名
3alwaysApply: true
4---
5 
6# Git 工作流程
7 
8## Remote 設定
9 
10| Remote | 指向 | 用途 |
11|--------|------|------|
12| `origin` | `JasonYang318/Qclaw`（fork） | 推送改動 |
13| `upstream` | `qiuzhi2046/Qclaw`（原始） | 同步最新版 |
14 
15## 同步上游
16 
17```powershell
18git fetch upstream
19git checkout main
20git merge upstream/main
21git push origin main
22```
23 
24## 分支命名
25 
26- 新功能：`feat/<功能名>`
27- 修 bug：`fix/<問題描述>`
28- 文件：`docs/<主題>`
29 
30## Commit 訊息格式
31 
32```
33<type>: <簡述>
34```
35 
36| 前綴 | 用途 |
37|------|------|
38| `feat` | 新功能 |
39| `fix` | 修 bug |
40| `docs` | 文件變更 |
41| `refactor` | 重構 |
42| `test` | 測試 |
43| `chore` | 工具 / 設定 |
44 
45## PR 流程
46 
471. 先開 GitHub Issue，等維護者確認方向
482. 在自己的 fork 分支開發
493. 跑完三個驗證指令後再 commit
504. 推送到 `origin`，開 PR 指向 `qiuzhi2046/Qclaw`
51