addyosmani/git-workflow-and-versioning：Git 工作流与发布版本规范 Skill Skill 技能

技能简介

addyosmani/git-workflow-and-versioning 是 Google Chrome 团队工程总监 Addy Osmani 维护的 Agent Skill，专门解决"分支随意、commit 巨型、版本号乱发"的协作痛点。它面向 Claude / Codex / Claude Code，把分支策略、原子化提交、worktree 并行与版本号语义合并成一套可执行的发布流程。这一 Skill 在 Agent 协作场景里，既是新人 onboarding 手册，也是 AI 提 PR 时的硬约束。

核心能力

• 短生命周期分支 + 特性开关：推荐基于主干的开发模式，给出 feature flag 与分支命名规范。
• 原子化提交：规范 commit 粒度、message 格式、变更摘要（change summary）模板。
• worktree 并行：解释如何用 Git worktree 让 Agent 与人同时跑多条分支而不互相阻塞。
• 语义化版本：给出 SemVer 选择规则、自动判断 major/minor/patch 的决策树。
• 阶段化校验：要求提交前跑 lint / test / typecheck 的最小准入门槛，并把规则写入 commit hook 模板。
• 发布记录：自动生成 changelog 草稿、release note 与回滚指引。

安装配置

1. 运行 npx skillstore add addyosmani/git-workflow-and-versioning。
2. 确认 Agent 工具已加载 Skill 列表，本 Skill 支持 Claude / Codex / Claude Code 三种 CLI。
3. 在仓库根目录添加符合本地风格的 commit hook（husy / lefthook / shell script），并把 Skill 推荐的提交前检查脚本挂到 hook 上。
4. 若团队已有 GitHub Actions / GitLab CI，把 Skill 中的工作流片段加成 PR 检查步骤，让 Agent 提的 PR 自动接受同款校验。

使用步骤

1. 从主分支拉出短生命周期特性分支（命名遵循 feat/{scope}-{short}），开启对应 feature flag。
2. 让 Agent 按"原子提交 + 描述 + 验证"模板产出 commit；每条 commit 单独跑通 lint/test。
3. 在 PR 中调用 Skill 工具生成变更摘要、影响面、测试覆盖与回滚方案四节。
4. 合并前 review worktree 中是否还存在未清理的临时分支，清理后合入主干。
5. 发布前由 Skill 根据改动类型给出 SemVer bump 建议，CI 自动写入 tag 与 changelog。

适用场景

• 中小团队在引入 AI 编程助手后，需要统一"AI 提的 PR 怎么合"的规范。
• 开源项目维护者希望贡献者 PR 形态一致，减少维护者手工修正成本。
• 公司级 monorepo 中多个 Agent 并行开发，需要 worktree 与版本号互不打架。
• 多分支长生命周期（如 release / hotfix）共存的传统 Git-Flow 团队过渡期。
• 个人项目想加上 changelog、版本号、CI 发布三件套但不想从零配置。

适用人群

• 工程经理 / 平台团队推动"AI 提 PR 的工程治理"。
• 个人开发者希望一次性把 Git 工具链搭到位的"懒人方案"。
• AI Agent 工程师，把它打包进 Coding Agent 的 system prompt 提升 PR 通过率。

工作原理

Skill 在加载时把"分支策略 → 提交粒度 → 校验 → 版本 → 发布"五段决策树注入 Agent 上下文；当用户发起开发流程时，Agent 按当前仓库状态匹配分支模板与 commit 规范，并在 PR 阶段自动产出变更摘要、版本号建议与回滚说明。

官方链接

• Skill 详情页：https://skillstore.io/skills/addyosmani-git-workflow-and-versioning
• 仓库：https://github.com/addyosmani/agent-skills/tree/main/skills/git-workflow-and-versioning
• Manifest：https://skillstore.io/api/skills/addyosmani-git-workflow-and-versioning/manifest