chinese-git-workflow

国内 Git 平台配置参考——Gitee、Coding.net、极狐 GitLab、CNB 的 SSH/HTTPS/凭据/CI 接入差异与镜像同步配置。仅在用户显式 /chinese-git-workflow 时调用，不要根据上下文自动触发。

By jnmetacode · 945 installs

npx skills add jnmetacode/superpowers-zh --skill chinese-git-workflow

Source repository · Upstream listing

国内 Git 工作流规范 概述 国内团队用 Git 经常踩的坑：GitHub 访问不稳定、CI/CD 方案照搬国外水土不服、commit message 中英混杂没有规范。本技能提供一套 完整适配国内平台和团队习惯的 Git 工作流 。 核心原则： 工作流服务于团队效率，不是为了流程而流程。选适合团队规模的，别硬套大厂方案。 国内 Git 平台适配 平台对比 特性 Gitee Coding.net 极狐 GitLab CNB GitHub 国内访问 快 快 快 快 不稳定 免费私有仓库 有 有 有 有 有 CI/CD Gitee Go Coding CI 内置 GitLab CI 内置（.cnb.yml） GitHub Actions 代码审查 PR MR MR MR PR 制品库 有限 完整 完整 完整 Packages 适合场景 开源/小团队 中大型团队 企业私有化 云原生 / Docker 流水线 国际项目 Gitee 特有配置 Coding.net 特有配置 极狐 GitLab 特有配置 CNB（Cloud Native Build）特有配置 工作流选择 方案一：主干开发（Trunk Based Development） 适合： 小团队（2 8 人）、迭代速度快、有完善的自动化测试。 规则： 主干（main）始终保持可发布状态 功能分支生命周期不超过 2 天 每天至少合并一次到主干 用 Feature Flag 控制未完成功能的可见性 方案二：Git Flow（经典分支模型） 适合： 中大团队、版本发布节奏固定（如双周迭代）、需要维护多个版本。 分支说明： main — 生产环境代码，只接受 release 和 hotfix 的合并 develop — 开发主线，功能分支从这里拉出，合回这里 release/ — 发布分支，从 develop 拉出，只修 bug 不加功能 feat/ — 功能分支 hotfix/ — 紧急修复，从 main 拉出，同时合回 main 和 develop 方案三：国内团队常用简化流程 适合： 大多数国内中小团队的实际情况。 规则： main 分支受保护，只能通过 PR/MR 合并 dev 分支对应测试环境，自动部署 功能分支从 dev 拉出，合回 dev dev 测试通过后，合并到 main 进行发布 分支命名规范 国内团队常用命名 命名规则 1. 全部小写，用 连接单词（不用下划线或驼峰） 2. 前缀明确分支类型： feat/ 、 fix/ 、 hotfix/ 、 release/ 3. 关联任务管理平台的编号（如有）： feat/TAPD 12345 description 4. 长度适中，能看出分支目的即可 中文 Commit Message 规范 约定式提交（Conventional Commits）中文版 类型清单 类型 说明 emoji（可选） feat 新增功能 ✨ fix 修复 Bug 🐛 docs 文档更新 📝 style 代码格式（不影响逻辑） 💄 refactor 重构（不是新功能也不是修 Bug） ♻️ perf 性能优化 ⚡ test 测试相关 ✅ build 构建系统或外部依赖 📦 ci CI/CD 配置 👷 chore 其他杂项 🔧 revert 回滚 ⏪ 好的 commit message 不好的 commit message CI/CD 平台适配 Gitee Go Coding CI 极狐 GitLab CI CNB（Cloud Native Build） 特点： 每个流水线独立指定 Docker 镜像，天然云原生 支持 push / pull request 触发 同一事件可并行多条流水线 stages 也支持 name: xxx + script: 的展开形式，复杂场景见官方文档 GitHub Actions 国内替代方案对照 GitHub Actions 功能 Gitee Go Coding CI 极狐 GitLab CI CNB 触发条件 triggers Jenkinsfile triggers only/rules push / pull request 缓存依赖 cache step stash/unstash cache 见官方文档 制品存储 artifacts 制品库 artifacts 见官方文档 环境变量 env environment variables env 密钥管理 环境变量配置 凭据管理 CI/CD Variables Access Token 手动触发 手动运行 手动触发 when: manual 页面手动运行 PR/MR 描述模板 中文模板 在仓库中创建 PR/MR 模板文件： Gitee： .gitee/PULL REQUEST TEMPLATE.md Coding / GitLab： .gitlab/merge request templates/default.md 常用 Git 配置 国内环境优化 .gitignore 国内项目常见配置 检查清单 在推送代码前，确认： [ ] 分支命名符合团队规范 [ ] commit message 格式正确，类型和范围准确 [ ] 关联了对应的需求/Bug 编号 [ ] PR/MR 描述填写完整 [ ] CI 流水线通过 [ ] 已请求相关同事 Review