跑一致的 Git 工作流

在没有标准化流程的团队里，commit message 写法五花八门、push 前不做 lint/typecheck、PR 标题与改动不对齐——这些问题在小团队阶段尚可忍受，一旦成员超过 3 人或引入 AI 编码助手就会显著放大。doyajin174-git-workflow 是一个面向 Claude、Codex、Claude Code 的 Git 全流程技能，从分支创建、commit 格式、verification checklist 到 push 前自检一条龙覆盖。

技能简介

该技能由 GitHub 用户 Doyajin174 维护，遵循 MIT 协议，已通过官方完整审计（qualityScore 78，bronze tier），核心目标是把 Git 全流程"沉淀为可复用的提示词模板"，让 AI 编码助手也能像熟练的工程师一样按部就班地完成提交。

核心能力

• 约定式 commit 标题：根据 Conventional Commits 规范生成 feat/fix/refactor/docs/test/chore 类型前缀，并给出常见类型示例。
• 统一分支命名：推荐 feat/-、fix/-、refactor/ 等命名模式，避免 fix-bug-final-v2 这类野生命名。
• 多维 verification 清单：自动列出 tests、lint、type check、build 四类典型验证步骤，并提供 npm test、pnpm lint、tsc --noEmit 等可直接执行的命令。
• 完整生命周期模板：覆盖 stage → commit → verification → push 四个阶段，让 AI 助手按顺序执行，不遗漏关键步骤。
• 可复用 readiness 清单：每次 commit / push 前自动检查 "是否跑过 test / 是否更新 CHANGELOG / 是否同步文档 / 是否需要回滚预案"，输出可勾选 checklist。
• 风险提示与拒绝越权：明确提示 push / force push / amend pushed commit 等操作会修改远端仓库，必须经用户二次确认。
• 跨项目适配：虽然示例命令偏向 Node.js / TypeScript，但模板对 Python（pytest / ruff / mypy）、Go（go test / golangci-lint）等项目同样适用，只需替换命令。

安装配置

• 一行安装：执行 npx skillstore add doyajin174/git-workflow，Skillstore 会自动拉取到 .public/skills/git-workflow。
• 手动安装：克隆 https://github.com/Doyajin174/myskills，把 .public/skills/git-workflow 复制到本地任意 Claude / Codex / Claude Code 项目的 .claude/skills/ 下。
• 权限需求：声明 external_commands 风险因子，模型会按需调用 git 子命令，请确保 Agent 已授予相应权限。
• 零额外依赖：不需要数据库、不需要服务端、不需要 API Key，纯文档型 Skill。

使用步骤

1. 加载技能：在 Claude / Codex / Claude Code 对话窗口说"使用 git-workflow 技能"，模型即进入标准化模式。
2. 提交前提示：告诉模型"为这次改动生成 conventional commit 信息"，它会先执行 git status / git diff 再输出建议。
3. 分支规划：若要开启新功能，让模型"为这个 issue 选一个分支名"，会得到 feat/- 形式的结果。
4. verification 检查：在准备 push 之前提示"列出本任务应该跑的 verification 命令"，按输出逐项执行。
5. 发布前自检：在 AI 助手宣布任务完成前，让模型"用 git-workflow 技能审计 readiness checklist"。

适用场景

• 新成员入职第一天：把这份仓库在 PR 流程里一同给出，新人 commit 即符合团队规范。
• AI 编码助手兜底校验：当 Claude Code 独立完成开发任务时，确保 push 前所有 verification 已执行。
• 开源项目标准化贡献流程：让外部贡献者按统一模板提交 PR，降低 review 成本。
• 跨语言项目统一提交风格：无论是前端、后端还是数据项目，commit 类型与 verification 步骤都可对齐。

适用人群

• 在 Claude Code / Codex 中协作的研发团队
• 需要为 AI 编程助手建立"完工标准"的技术负责人
• 维护开源项目、期待外部贡献者遵循规范的 maintainer
• 任何想摆脱"commit message 全靠自觉"困境的工程师

工作原理

技能本身是一份结构化的 prompt 模板，不内置任何运行时。它通过提示词把 Git 最佳实践（分支命名 / commit 规范 / verification 步骤 / 风险规避）显式灌输给模型，让模型在收到任务时先执行状态收集命令，再按模板输出结果。所有写操作（commit / push）均要求用户最终确认，技能不会自动 force-push 或 amend 已推送 commit。

官方链接

• Skill 详情页：https://skillstore.io/skills/doyajin174-git-workflow
• Manifest 接口：https://skillstore.io/api/skills/doyajin174-git-workflow/manifest
• 源码仓库：https://github.com/Doyajin174/myskills/tree/main/.public/skills/git-workflow