universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-CN/skills/claude-code/git-workflow-guide/SKILL.md

@@ -0,0 +1,218 @@
+---
+source: /skills/claude-code/git-workflow-guide/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+name: git-workflow-guide
+description: |
+  指導 Git 分支策略、分支命名与合併操作。
+  使用时机：建立分支、合併、Pull Request、Git 工作流程問題。
+  关鍵字：branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程。
+---
+
+# Git 工作流程指南
+
+> **语言**: [English](../../../../../skills/claude-code/git-workflow-guide/SKILL.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本技能提供 Git 分支策略、分支命名慣例与合併操作的指導。
+
+## 快速參考
+
+### 工作流程策略选择
+
+| 部署頻率 | 建议策略 |
+|---------|---------|
+| 每日多次 | Trunk-Based Development |
+| 每周至雙周 | GitHub Flow |
+| 每月或更長 | GitFlow |
+
+### 分支命名慣例
+
+```
+<type>/<short-description>
+```
+
+| 类型 | 用途 | 範例 |
+|------|------|------|
+| `feature/` | 新功能 | `feature/oauth-login` |
+| `fix/` 或 `bugfix/` | 错误修復 | `fix/memory-leak` |
+| `hotfix/` | 緊急生产環境修復 | `hotfix/security-patch` |
+| `refactor/` | 程序码重構 | `refactor/extract-service` |
+| `docs/` | 僅文件变更 | `docs/api-reference` |
+| `test/` | 测试新增 | `test/integration-tests` |
+| `chore/` | 維護任务 | `chore/update-dependencies` |
+| `release/` | 發布准备 | `release/v1.2.0` |
+
+### 命名規則
+
+1. **使用小写**
+2. **使用連字号分隔单字**
+3. **描述性但簡潔**
+
+## 详细指南
+
+完整标准請參阅：
+- [Git 工作流程策略](./git-workflow.md)
+- [分支命名參考](./branch-naming.md)
+
+## 建立分支前检查清单
+
+建立新分支前：
+
+1. **检查未合併的分支**
+   ```bash
+   git branch --no-merged main
+   ```
+
+2. **同步最新程序码**
+   ```bash
+   git checkout main
+   git pull origin main
+   ```
+
+3. **验证测试通過**
+   ```bash
+   npm test  # 或您项目的测试指令
+   ```
+
+4. **使用正确命名建立分支**
+   ```bash
+   git checkout -b feature/description
+   ```
+
+## 合併策略快速指南
+
+| 策略 | 使用时机 |
+|------|---------|
+| **Merge Commit** (`--no-ff`) | 長期功能、GitFlow 發布 |
+| **Squash Merge** | 功能分支、乾淨历史 |
+| **Rebase + FF** | Trunk-Based、短期分支 |
+
+## 範例
+
+### 建立功能分支
+
+```bash
+# 良好範例
+git checkout -b feature/user-authentication
+git checkout -b fix/null-pointer-in-payment
+git checkout -b hotfix/critical-data-loss
+
+# 不良範例
+git checkout -b 123              # 缺乏描述性
+git checkout -b Fix-Bug          # 非小写
+git checkout -b myFeature        # 缺少类型前綴
+```
+
+### 合併工作流程 (GitHub Flow)
+
+```bash
+# 1. 從 main 建立分支
+git checkout main
+git pull origin main
+git checkout -b feature/user-profile
+
+# 2. 进行变更并提交
+git add .
+git commit -m "feat(profile): add avatar upload"
+git push -u origin feature/user-profile
+
+# 3. 透過 GitHub/GitLab UI 建立 PR 并合併
+
+# 4. 合併後刪除分支
+git checkout main
+git pull origin main
+git branch -d feature/user-profile
+```
+
+### 处理合併衝突
+
+```bash
+# 1. 使用 main 更新您的分支
+git checkout feature/my-feature
+git fetch origin
+git merge origin/main
+
+# 2. 在文件中解决衝突
+# <<<<<<< HEAD
+# 您的变更
+# =======
+# 传入的变更
+# >>>>>>> origin/main
+
+# 3. 暫存已解决的文件
+git add resolved-file.js
+
+# 4. 完成合併
+git commit -m "chore: resolve merge conflicts with main"
+
+# 5. 测试并推送
+npm test
+git push origin feature/my-feature
+```
+
+---
+
+## 組態偵测
+
+本技能支援项目特定的工作流程組態。
+
+### 偵测順序
+
+1. 检查 `CONTRIBUTING.md` 是否有「Git Workflow」或「Branching Strategy」章节
+2. 若找到，使用指定的策略（GitFlow / GitHub Flow / Trunk-Based）
+3. 若未找到，**预设使用 GitHub Flow** 以保持簡单
+
+### 首次设置
+
+若未找到組態：
+
+1. 詢問使用者：「本项目尚未设置 Git 工作流程策略。您偏好哪一种？（GitFlow / GitHub Flow / Trunk-Based）」
+2. 选择後，建议在 `CONTRIBUTING.md` 中记录：
+
+```markdown
+## Git 工作流程
+
+### 分支策略
+本项目使用 **[所選选项]**。
+
+### 分支命名
+格式：`<type>/<description>`
+範例：`feature/oauth-login`、`fix/memory-leak`
+
+### 合併策略
+- 功能分支：**[Squash / Merge commit / Rebase]**
+```
+
+---
+
+## 相关标准
+
+- [Git 工作流程](../../core/git-workflow.md)
+- [提交消息指南](../../core/commit-message-guide.md)
+- [簽入标准](../../core/checkin-standards.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2025-12-24 | 新增：标准章节（目的、相关标准、版本历史、授权） |
+
+---
+
+## 授权
+
+本技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
+
+**來源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/claude-code/git-workflow-guide/branch-naming.md

@@ -0,0 +1,220 @@
+---
+source: skills/claude-code/git-workflow-guide/branch-naming.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 分支命名參考
+
+> **语言**: [English](../../../../../skills/claude-code/git-workflow-guide/branch-naming.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本文件提供 Git 分支命名慣例和規則的參考指南。
+
+---
+
+## 标准格式
+
+```
+<type>/<short-description>
+```
+
+---
+
+## 分支类型
+
+### 功能分支
+
+| 类型 | 用途 | 範例 |
+|------|------|------|
+| `feature/` | 新功能 | `feature/oauth-login` |
+| `feat/` | 簡写形式 | `feat/user-dashboard` |
+
+### 修復分支
+
+| 类型 | 用途 | 範例 |
+|------|-------|---------|
+| `fix/` | 错误修復 | `fix/memory-leak` |
+| `bugfix/` | 替代形式 | `bugfix/login-error` |
+| `hotfix/` | 緊急正式環境修復 | `hotfix/security-patch` |
+
+### 其他类型
+
+| 类型 | 用途 | 範例 |
+|------|-------|---------|
+| `refactor/` | 程序码重構 | `refactor/extract-service` |
+| `docs/` | 僅文件更新 | `docs/api-reference` |
+| `test/` | 测试新增 | `test/integration-tests` |
+| `chore/` | 維護任务 | `chore/update-deps` |
+| `perf/` | 效能改善 | `perf/optimize-query` |
+| `style/` | 格式調整 | `style/code-format` |
+| `ci/` | CI/CD 变更 | `ci/add-coverage` |
+| `release/` | 發布准备 | `release/v1.2.0` |
+
+---
+
+## 命名規則
+
+### 应該做的事
+
+1. **使用小写**
+   ```bash
+   feature/user-auth    # ✅ 良好
+   Feature/User-Auth    # ❌ 不好
+   ```
+
+2. **使用連字号分隔空格**
+   ```bash
+   feature/oauth-login  # ✅ 良好
+   feature/oauth_login  # ❌ 不好（底线）
+   feature/oauthlogin   # ❌ 不好（無分隔符号）
+   ```
+
+3. **具描述性但簡潔**
+   ```bash
+   feature/add-user-authentication  # ✅ 良好
+   feature/auth                     # ⚠️ 太模糊
+   feature/add-new-user-authentication-with-oauth2-and-jwt  # ❌ 太長
+   ```
+
+4. **包含問題编号（选择性）**
+   ```bash
+   feature/123-oauth-login   # ✅ 良好
+   feature/GH-123-oauth      # ✅ 良好（GitHub issue）
+   feature/JIRA-456-payment  # ✅ 良好（Jira ticket）
+   ```
+
+### 不应該做的事
+
+1. **不要只使用問題编号**
+   ```bash
+   feature/123       # ❌ 不具描述性
+   fix/456           # ❌ 修復什麼？
+   ```
+
+2. **不要使用特殊字元**
+   ```bash
+   feature/oauth@login  # ❌ 不允許 @
+   feature/auth#123     # ❌ 不允許 #
+   ```
+
+3. **不要使用空格**
+   ```bash
+   feature/oauth login  # ❌ 不允許空格
+   ```
+
+---
+
+## 範例
+
+### 良好範例
+
+```bash
+# 功能分支
+feature/user-authentication
+feature/oauth2-google-login
+feature/123-add-payment-gateway
+feat/dashboard-analytics
+
+# 修復分支
+fix/null-pointer-payment
+fix/memory-leak-session-cache
+bugfix/login-redirect-loop
+hotfix/critical-data-loss
+
+# 其他分支
+refactor/database-connection-pool
+docs/update-installation-guide
+test/add-integration-tests
+chore/update-dependencies
+perf/optimize-database-queries
+release/v1.2.0
+```
+
+### 不良範例
+
+```bash
+# ❌ 不具描述性
+feature/123
+fix/bug
+update
+
+# ❌ 错误的大小写
+Feature/OAuth-Login
+FIX/Memory-Leak
+HOTFIX/security
+
+# ❌ 错误的分隔符号
+feature/oauth_login
+feature/oauth.login
+feature/oauth login
+
+# ❌ 無类型前綴
+oauth-login
+user-authentication
+memory-leak-fix
+
+# ❌ 太模糊
+feature/update
+fix/issue
+chore/stuff
+
+# ❌ 太長
+feature/add-new-user-authentication-system-with-oauth2-jwt-and-session-management
+```
+
+---
+
+## 快速验证
+
+推送前，检查您的分支名称：
+
+```bash
+# 检查目前分支名称
+git branch --show-current
+
+# 验证格式（应符合模式）
+# <type>/<description>
+# - type: feature, fix, bugfix, hotfix, refactor, docs, test, chore, perf, style, ci, release
+# - description: 小写、連字号分隔、具描述性
+```
+
+### 验证检查清单
+
+- [ ] 以有效的类型前綴開頭（`feature/`、`fix/` 等）
+- [ ] 全部小写
+- [ ] 使用連字号（非底线或空格）
+- [ ] 具描述性但簡潔（理想为 3-5 个单字）
+- [ ] 無特殊字元（@、#、$ 等）
+
+---
+
+## 相关标准
+
+- [Git 工作流程策略](./git-workflow.md)
+- [Git 工作流程](../../../../../core/git-workflow.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|---------|------|---------|
+| 1.0.0 | 2025-12-24 | 新增：标准章节（目的、相关标准、版本历史、授权条款） |
+
+---
+
+## 授权条款
+
+本文件採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)