# GitHub Flow 工作流
$ git switch -c feature/login main
$ # 开发...
$ git push -u origin feature/login
$ gh pr create --title "feat: add login"
$ # 审查通过后合并
$ gh pr merge --squash
$ # 删除远程分支
$ git push origin --delete feature/login

# Git Flow 示例
# 创建功能分支
$ git switch -c feature/payment develop
$ # 开发...
$ git switch develop
$ git merge --no-ff feature/payment

# 创建发布分支
$ git switch -c release/1.2.0 develop
$ # 测试和修复...
$ git switch main
$ git merge --no-ff release/1.2.0
$ git tag -a v1.2.0 -m "Release v1.2.0"
$ git switch develop
$ git merge --no-ff release/1.2.0

# 热修复
$ git switch -c hotfix/1.2.1 main
$ # 修复...
$ git switch main
$ git merge --no-ff hotfix/1.2.1
$ git tag -a v1.2.1 -m "Hotfix v1.2.1"
$ git switch develop
$ git merge --no-ff hotfix/1.2.1

# 格式
<type>(<scope>): <description>

[optional body]

[optional footer(s)]

# ✅ 好的提交信息
feat(auth): implement JWT token refresh

- Add automatic token refresh before API calls
- Implement retry logic for 401 responses
- Store refresh token in httpOnly cookie

Closes #123

# ❌ 不好的提交信息
fix
update code
WIP
asdfghjkl

# 安装
$ npm install --save-dev @commitlint/cli @commitlint/config-conventional

# commitlint.config.js
module.exports = {
    extends: ['@commitlint/config-conventional'],
    rules: {
        'type-enum': [2, 'always', [
            'feat', 'fix', 'docs', 'style', 'refactor',
            'perf', 'test', 'build', 'ci', 'chore', 'revert'
        ]],
        'subject-max-length': [2, 'always', 72],
        'body-max-line-length': [2, 'always', 100],
    }
};

# 只在变更的包上运行 CI
# 使用 Turborepo
$ turbo run test --filter=...[origin/main]

# 使用 Lerna
$ lerna run test --since origin/main

# 使用 pnpm
$ pnpm --filter=...[origin/main] test

# .github/CODEOWNERS 或 docs/CODEOWNERS

# 默认审查者
*                    @team-leads

# 前端代码
/apps/web/**         @frontend-team

# 后端代码
/apps/api/**         @backend-team

# 数据库迁移
/apps/api/migrations @dba-team

# CI/CD 配置
/.github/**          @devops-team
/.gitlab-ci.yml      @devops-team

# 文档
/docs/**             @tech-writers
*.md                 @tech-writers

## 审查清单

### 功能性
- [ ] 代码实现了需求描述的功能
- [ ] 边界条件已处理
- [ ] 错误处理完善

### 代码质量
- [ ] 代码可读性良好
- [ ] 命名清晰准确
- [ ] 无重复代码
- [ ] 遵循项目代码规范

### 安全性
- [ ] 无硬编码密钥/密码
- [ ] 输入已验证
- [ ] SQL 注入/XSS 防护

### 测试
- [ ] 有单元测试
- [ ] 测试覆盖关键逻辑
- [ ] 测试用例清晰

# 1. 创建仓库
$ mkdir project && cd project
$ git init -b main

# 2. 创建 .gitignore
$ curl -o .gitignore https://raw.githubusercontent.com/github/gitignore/main/Node.gitignore

# 3. 创建 README
$ echo "# Project Name" > README.md

# 4. 设置分支保护（在平台上操作）

# 5. 创建 CODEOWNERS
$ mkdir -p .github
$ cat > .github/CODEOWNERS << 'EOF'
* @team-leads
EOF

# 6. 配置 CI/CD
$ mkdir -p .github/workflows
# 创建 ci.yml...

# 7. 首次提交
$ git add -A
$ git commit -m "chore: initial project setup"

# 8. 添加远程并推送
$ git remote add origin git@github.com:org/project.git
$ git push -u origin main