1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | git-workflow-and-versioning | GitHub API / SKILL.md |
| 作者/维护者 | Addy Osmani（addyosmani/agent-skills 仓库所有者），外部协作者 Federico Bartoli（Madisoft）、HMAKT99 等 |
GitHub API（commits） |
| 来源链接 | https://github.com/addyosmani/agent-skills/tree/main/skills/git-workflow-and-versioning | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 所属仓库 80,779★ / 8,713 forks（该数字属整个 agent-skills 合集，不代表本技能个体热度，仅供了解所属仓库规模） | GitHub API |
| 最新版本 | 无独立版本号；所属仓库整体最新发布版 0.6.5（2026-07-26），该子技能自身最近一次内容提交为 2026-06-27 | GitHub API（releases / commits） |
| 安装方式 | Claude Code / Codex 原生插件市场一条命令安装，或 npx skills add 单独安装本技能（见第 10 章） |
仓库 README |
2. 功能介绍与亮点
git-workflow-and-versioning 是一份把资深工程师的 Git 使用习惯固化成 agent 可执行清单的技能，覆盖从单次提交到正式发版的完整链条。
核心能力：
- 主干开发（trunk-based development）：
main始终可部署，短生命周期特性分支 1–3 天内合并，用特性开关替代长期分支 - 原子提交纪律：每个提交只做一件事，格式化改动与行为改动分开提交，配套
feat/fix/refactor/test/docs/chore类型前缀规范 - 提交信息写“为什么”而非“是什么”，附正反例对照
- 变更规模建议：单次提交/PR 目标约 100 行，超过 1000 行必须拆分
- Git worktree 并行工作流：为多个 agent 同时在不同特性分支工作提供具体命令模板
- 变更摘要模板：每次改动后输出“改了什么/特意没碰什么/潜在顾虑”三段式摘要，方便审查
- 提交前卫生检查清单：查看 staged diff、扫描密钥关键词、跑测试/lint/类型检查
- 语义化版本与变更日志：MAJOR/MINOR/PATCH 判定原则（引用 Hyrum’s Law 提醒“看似兼容的改动也可能破坏消费者”）、版本号与 tag 一致性、面向消费者而非搬运 commit log 的 changelog 写法
- 附常见借口对照表（“squash 掉就行”“commit message 不重要”等）与“红旗清单”帮助自查
亮点：纯 Markdown 无脚本执行；覆盖面比同仓库其他子技能更完整（同时管日常提交纪律与正式发版），且是仓库内少数把“版本号是对消费者的承诺”这一原则系统化写出来的技能；该子目录已有两名可核实身份的外部协作者参与内容改进，其中一次提交（增补语义化版本、tag、变更日志章节）已被合并入主分支。
3. 适用场景
固定分类：工程效率与代码质量
- 使用 Claude Code / Codex 等 agent 编码，希望 agent 遵循原子提交、清晰提交信息等纪律而非随手一个大提交的初中级开发者
- 需要在多条特性分支上并行使用多个 agent、想用 git worktree 避免互相干扰的开发者
- 需要给内部工具或已发布包做正式发版（打 tag、判断 breaking change、写 changelog），但团队没有既定规范的小团队
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库自带
.claude-plugin目录，可通过插件市场安装，也可用npx skills add直接放入.claude/skills/ - Codex：原生支持——仓库自带
.codex-plugin目录，npx skills add官方支持列表明确列出 Codex - OpenClaw：原生支持——技能安装 CLI（
vercel-labs/skills）官方支持列表明确列出 OpenClaw，对应路径skills/（项目级）/~/.openclaw/skills/（全局） - Hermes Agent：原生支持——同一份 CLI 官方支持列表明确列出 Hermes Agent，对应路径
.hermes/skills/（项目级）/~/.hermes/skills/（全局）
（基于已抓取的官方安装文档判断，未为兼容性单独发起搜索）
5. 推荐理由
Git 纪律是初中级开发者在 agent 高速产出代码时最容易松懈的环节——改动越攒越大、提交信息随手一写、发版时版本号和实际改动对不上。git-workflow-and-versioning 把主干开发、原子提交、变更摘要这些日常纪律，和语义化版本、tag、变更日志这些发版纪律放进同一份技能里，让 agent 从写下第一行代码到最终打 tag 发版全程有章可循，是目前收录的工程效率类技能里覆盖链条最完整的一个。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 所属仓库整体 80,779★ 属于整个 agent-skills 合集，不代表本技能个体热度；该子目录自身有 2 名可核实身份的外部协作者参与——Federico Bartoli（Madisoft 公司，190 followers）改进技能描述表述，HMAKT99（自述“FAANG 产品经理”）提交的语义化版本/变更日志章节已被合并入主分支（PR #334），是双重独立外部贡献者且含实际合并记录的协作证据 |
| 可用性 | 9 | SKILL.md 约 14KB，含具体命令示例、决策图、正反例对照表，结构清晰完整；子目录最近一次内容提交距今约一个月、仓库整体上周仍有提交，维护活跃；MIT 许可，无付费依赖；支持插件市场一键装，也支持 CLI 单独装 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
① 执行 shell 命令——技能本身不含可执行脚本，仅以示例形式展示 git/npm test/git bisect 等命令供 agent 在正常开发流程中参考，权限范围明确、可审计
② 联网外发数据——技能内容为本地版本控制指导，不涉及技能自身向外部服务器发送数据
③ API key/凭据——不涉及，技能本身不要求任何密钥
④ 未发现可疑指令——抓取 SKILL.md 全文，内容均为透明的 Git 工作流方法论，无混淆代码或隐蔽外发
⑤ 作者信誉——Addy Osmani 为公开可查的 Web 工程背景个人，该子目录有可核实身份的外部协作者共同参与，非匿名单人项目
⑥ License——MIT，明确
⑦ 维护时间——子目录最近一次提交 2026-06-27，仓库整体最近一次发版 2026-07-26，近期活跃
综合评分：8.33（三项均值，四舍五入至两位小数）
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 git-workflow-and-versioning 的差异 |
|---|---|---|
| git-cleanup（Trail of Bits 官方出品） | 双重确认安全清理 agent 多轮任务后堆积的本地分支与 worktree | 定位是“扫尾”——只解决清理这一个动作；git-workflow-and-versioning 定位是“全程纪律”，覆盖从提交到发版的完整工作方式，不涉及清理 |
| github-pr-workflow（Nous Research Hermes Agent 出品） | 覆盖分支创建到合并的 PR 全生命周期，含 CI 监控与失败自动修复循环 | 定位是“自动执行”——技能自带脚本让 agent 实际跑通 PR 流程；git-workflow-and-versioning 是纯方法论指导，不自动执行任何操作，靠 agent 遵循原则自行操作 |
| code-review-and-quality（同仓库另一子技能） | 五维度代码评审，在代码合并前挑质量问题 | 定位是“审内容”——关注代码本身写得好不好；git-workflow-and-versioning 定位是“管流程”——关注改动如何组织、提交、发布，两者可在同一次开发中前后配合 |
git-workflow-and-versioning 的差异化在于把“平时怎么提交”和“发版时怎么定版本号”这两件常被分开处理的事放进同一份技能：既不像 git-cleanup 只管善后，也不像 github-pr-workflow 自动执行 PR 全流程，而是给 agent 一套贯穿开发全程、需要 agent 主动遵循的纪律清单，尤其是语义化版本与变更日志这部分，在同类工程效率技能中较少见。
8. 用户评价
该技能所属的 agent-skills 项目本身有独立第三方评测文章，其中明确点出仓库内“四个特别值得关注”的技能，但 git-workflow-and-versioning 不在被重点展开评价之列，因此该子技能目前尚无第三方平台的具名评价文章。不过该子目录本身有实际的外部协作证据：Federico Bartoli（Madisoft 公司）与 HMAKT99（自述“FAANG 产品经理”）两名可核实身份的外部贡献者先后提交改进，其中 HMAKT99 增补语义化版本与变更日志章节的提交已合并入主分支，是直接的实际使用与协作证据。
9. 其他补充
仓库同时提供 .agents、.gemini、.opencode 等多种生态适配目录，并通过第三方 CLI 工具 vercel-labs/skills 支持“70+ 智能体”的统一安装；git-workflow-and-versioning 是仓库 24 个工程技能之一，与同仓库的 deprecation-and-migration（引用于本技能的破坏性变更迁移指引）、shipping-and-launch（引用于本技能的发布环节）存在明确的分工衔接关系。
10. 安装使用方式
- Claude Code 插件市场：
/plugin marketplace add addyosmani/agent-skills，再执行/plugin install agent-skills@addy-agent-skills - Codex：仓库自带
.codex-plugin，可通过 Codex 原生插件机制安装 - 通用 CLI（含 OpenClaw / Hermes Agent）：
npx skills add addyosmani/agent-skills --skill git-workflow-and-versioning（仅安装该子技能，CLI 会按所选 agent 自动放入对应目录，如 OpenClaw 的skills/、Hermes Agent 的.hermes/skills/） - 本地开发：
git clone https://github.com/addyosmani/agent-skills.git，再用claude --plugin-dir /path/to/agent-skills加载
安装后无需重启，agent 在进行提交、分支管理或发版相关操作时会自动触发该技能；若只想要该技能而不装整套 24 个工程技能，建议用 CLI 的 --skill 参数单独安装。
11. 注意事项
- 该技能是纯方法论指导，不会自动执行提交、打 tag 或发版操作，仍需 agent 结合项目自身工具链落地
- 技能内命令示例以 Node.js/npm 生态为主（如
npm test），其他语言栈需要 agent 自行替换等价命令 - 仓库以整套工程技能包（24 个子技能）为主体发布，若通过插件市场整体安装会连带装入其余 23 个非本技能相关的子技能
- 语义化版本、tag、changelog 相关建议面向“有外部消费者”的项目（发布包、内部服务被其他团队依赖等）；纯个人脚本或未对外发布的项目可只采用其中的提交纪律部分