该技能用于设计 Git 工作流,覆盖分支策略、主干开发、堆叠式变更、约定式提交、CI/CD 流水线与仓库卫生,也涉及 Git 内部机制。GitHub CLI 的使用由单独的 github-cli 技能处理,本技能聚焦工作流模式与 CI/CD 配置。
主要能力与建议实践:分支采用主干开发加短生命周期特性分支,命名如 feat/add-user-auth、fix/login-redirect、chore/update-deps、docs/api-reference、refactor/auth-module,分支存活不超过 48 小时并自动清理陈旧或已合并分支。提交使用约定式提交和祈使语气,类型包括 feat、fix、docs、style、refactor、perf、test、build、ci、chore、revert,feat 触发次版本、fix 与 perf 触发补丁版本,在类型或范围后加 ! 表示破坏性变更(主版本)。历史保持线性,通过 rebase 和 squash 整理;PR 要求小批量或堆叠式,禁止巨型 PR。主分支始终可部署,破坏主分支按紧急事件处理。合并前需通过 lint、类型检查、测试、安全扫描与审查批准,低风险 PR 在流水线成功后可自动合并。版本管理使用 Semantic Release 或 Changesets,不手工操作。密钥使用 OIDC Connect,不在流水线中硬编码令牌;提交用 SSH 或 GPG 签名。CI/CD 建议模块化的 GitHub Actions 和可复用工作流。
故障处理包括:长时间分支合并冲突应频繁 rebase 到 main,超 48 小时则拆分新分支;主分支损坏先 revert 再前向修复;恢复提交用 git reflog 及 git cat-file、git fsck;CI 失败检查可复用工作流版本与 OIDC 权限;堆叠 PR 冲突需从基底重新堆叠,Graphite 可用 gt restack;误提交大文件用 git filter-repo 而非 git filter-branch。
常见错误包括长期保留特性分支、直接提交 main、使用杂乱合并提交、硬编码令牌、单文件巨型 CI、不规范提交信息、用 git filter-branch 重写历史、未签名提交等。委托方面:仓库分支卫生审计用 Explore 代理,CI/CD 搭建用 Task 代理,新项目分支策略设计用 Plan 代理。资料还列出分支策略、主干开发、堆叠变更、约定式提交、GitHub Actions、Git 内部、自动化脚本、问题模板、高级操作等参考文件。具体命令、收费与平台限制等资料未提供。