用途:在规划分支策略、编写提交、审查差异、解决冲突、准备拉取请求或发布版本时使用,帮助团队保持版本控制可读、可审查、可恢复。
主要能力:提供有序的工作流、检查清单与决策规则,涵盖主干友好协作、提交卫生、冲突恢复和与 CI 关联的发布纪律。核心工作规则包括保持主分支或发布分支可部署、偏好小分支与小审查单元、优先主干式集成或短生命周期分支、先自查差异再请他人审查、破坏性命令前先考虑恢复方案、把提交历史当作共享运维文档、将构建失败视为影响团队的停线事件。
使用方式:先阅读 SKILL.md,再按需加载 references/ 目录中的深入文件,避免默认加载全部引用。协作流程分六步:开始前确认分支与上游状态、检查工作区改动、分离无关工作;以可审查的切片进行变更,每个提交回答改了什么、为何现在改、带来什么风险;有意图地暂存相关文件并重读暂存差异;编写说明意图与范围的提交信息;尽早变基或合并基分支,基于语义理解解决冲突并在集成后重跑测试;PR 说明影响、风险与验证,审查者关注缺陷、回归、迁移风险与缺失测试,发布包含回滚意识与部署后验证。
决策启发:需要干净线性历史且分支私有或团队允许改写时用 rebase;需要保留集成历史或分支广泛共享时用 merge;坏变更已共享时优先 revert 而非 reset。冲突解决检查清单包括识别哪一侧改变了行为及原因、重建预期终态、重跑冲突区域测试、复查生成文件与锁文件及模式与配置文件、确认没有逻辑被静默丢弃。
适用场景:需要可复用判断、领域约束或成熟工作流的 Git 协作与发布任务。
限制:与 git-collaboration-workflow 无关的任务,或更适合更具体配套技能的任务,不应使用;只需简单答案且本技能约束与引用无实质帮助时也不适用。需要先收集项目上下文、约束与具体问题,并确认期望交付物。输出应面向执行、简洁,并与仓库基线工程标准一致;除非技能明确要求更强标准,否则保留现有项目约定。反模式包括把示例当作可直接复制的真理、默认加载全部引用文件、长期分支隐藏分歧、混合重构加功能加格式化的提交、在共享分支上未经团队知晓强制推送、未先检查 reflog 友好选项就做破坏性恢复、缺少迁移或回滚或验证说明就发布、把 Git 工作流与发布工程和 CI 健康割裂。引用文件包括 references/review-and-release.md、references/trunk-based-delivery.md 以及 ../world-class-engineering/references/source-patterns.md。