Git 和 GitHub 操作

提供 React Native/Expo 项目的 Git 版本控制和 GitHub 仓库管理的完整工作流。

快速参考

核心原则

原则	说明
禁止直接 push main	main 只能通过 PR 合并
先 rebase 后 PR	提交前必须 rebase 到最新远程分支
使用 rebase merge	PR 合并统一使用 `--rebase` 保持线性历史
提交前必须通过质量检查	参考 `code-quality` skill

⚠️ 提交前必须通过质量检查

每次提交/推送前必须运行并通过：

bash

pnpm tsc --noEmit           # 0 type errors
pnpm eslint .               # 0 errors, 0 warnings
pnpm prettier --check .     # 0 format issues
pnpm jest                   # All tests passed

详细检查清单见 .claude/skills/code-quality/SKILL.md

分支命名

前缀	用途	示例
`feature/`	新功能	`feature/user-auth`
`fix/`	Bug 修复	`fix/login-bug`
`hotfix/`	紧急修复	`hotfix/critical-bug`
`refactor/`	重构	`refactor/auth-module`

提交格式（Conventional Commits）

code

<type>(<scope>): <subject>

类型: feat | fix | docs | style | refactor | perf | test | build | ci | chore

常用命令速查

bash

# 分支
git checkout -b feature/xxx          # 创建分支
git branch -d feature/xxx            # 删除分支

# Rebase
git fetch origin develop && git rebase origin/develop

# 推送
git push -u origin feature/xxx       # 首次推送
git push --force-with-lease          # rebase 后推送

# PR
gh pr create --base develop          # 创建 PR
gh pr merge <n> --rebase --delete-branch  # 合并 PR

子代理执行（强烈推荐）

Git 操作应通过子代理执行：

typescript

Task({
  subagent_type: 'general-purpose',
  description: '提交当前分支变更',
  prompt: `执行 Git 提交，遵循 .claude/skills/git-github/SKILL.md`,
});

原因：Git 操作需读取 diff/status/log（消耗大量 token），子代理可隔离处理。

工作流程

Feature 分支流程

bash

# 1. 从 develop 创建分支
git checkout develop && git pull
git checkout -b feature/xxx

# 2. 开发完成后同步 develop
git fetch origin develop
git rebase origin/develop

# 3. ⚠️ 质量检查（必须全部通过！）
pnpm tsc --noEmit           # 必须 0 errors
pnpm eslint .               # 必须 0 issues
pnpm prettier --check .     # 必须 0 issues
pnpm jest                   # 必须全部通过

# 4. 提交（质量检查通过后）
git add . && git commit -m "feat: xxx"

# 5. ⚠️ 推送前再次 rebase 远程（确保最新）
git fetch origin develop
git rebase origin/develop
git push --force-with-lease origin feature/xxx

# 6. 创建 PR
gh pr create --base develop --title "feat: xxx"

# 7. 合并（使用 rebase merge）
gh pr merge <n> --rebase --delete-branch

发布流程（Develop → Main）

bash

# 1. 确保 develop 最新
git checkout develop && git pull

# 2. 质量检查
pnpm tsc --noEmit && pnpm eslint . && pnpm jest

# 3. 创建发布 PR
gh pr create --base main --head develop --title "release: v1.x.x"

# 4. 合并到 main
gh pr merge <n> --rebase

# 5. 打 tag
git checkout main && git pull
git tag -a v1.x.x -m "Release v1.x.x"
git push origin v1.x.x

Hotfix 流程

bash

# 1. 从 main 创建
git checkout main && git pull
git checkout -b hotfix/xxx

# 2. 修复后创建 PR 到 main
gh pr create --base main

# 3. 合并后同步到 develop
git checkout develop && git merge main && git push

PR 规范

标题格式

code

<type>(<scope>): <description>

内容模板

markdown

## Summary

- 变更点 1
- 变更点 2

## Test plan

- [ ] 验证项 1
- [ ] 验证项 2

🤖 Generated with [Claude Code](https://claude.com/claude-code)

冲突解决

文件类型	策略
`package.json`	保留较新版本，重新 `pnpm install`
`pnpm-lock.yaml`	选择一方后重新 `pnpm install`
`app.json/app.config.ts`	优先保留 main 结构
代码文件	根据业务逻辑手动合并
`ios/` / `android/`	谨慎处理，可能需要 `npx expo prebuild --clean`

.gitignore 规范

React Native/Expo 项目应忽略：

gitignore

# Dependencies
node_modules/
.pnpm-store/

# Expo
.expo/
dist/
web-build/

# Native (如果使用 CNG 不提交)
# android/
# ios/

# Environment
.env
.env.*
!.env.example

# IDE
.vscode/
.idea/

# OS
.DS_Store
Thumbs.db

# Build
*.jks
*.p8
*.p12
*.key
*.mobileprovision
*.orig.*

# Metro
.metro-health-check*

# Testing
coverage/

安全提醒

禁止	替代方案
直接 push main	通过 PR 合并
合并未通过检测的代码	先 `pnpm tsc --noEmit && pnpm eslint . && pnpm jest`
`--force` 推送 main	使用 `--force-with-lease`（仅 feature 分支）
提交 `.env` 等敏感信息	使用 `.gitignore` 排除
提交 API Keys/Secrets	使用环境变量

附录

A. 完整提交示例

bash

git commit -m "$(cat <<'EOF'
feat(auth): 添加 JWT token 刷新机制

- 添加 token 过期检测
- 实现自动刷新逻辑

Closes #123

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
EOF
)"

B. GitHub CLI 命令

bash

# 认证
gh auth status

# 仓库
gh repo create <name> --private --source=. --push

# PR
gh pr list
gh pr view <n>
gh pr merge <n> --rebase --delete-branch  # 统一使用 rebase merge

C. 分支流向图

code

feature/xxx ─┐
fix/xxx ─────┼──► develop ──► main (发布)
refactor/xxx ┘        ▲
                      │
hotfix/xxx ───────────┴──► main

D. Expo 特殊注意

•如果使用 CNG（Continuous Native Generation），android/ 和 ios/ 目录可以不提交
•如果提交原生目录，确保 .gitignore 正确配置
•原生配置改动优先通过 Config Plugin 管理，保持可复现性