Git Workflow 是一套用于版本控制工作的约定集合,帮助开发者在使用 Git 时保持一致的提交风格、分支命名和冲突处理方式。它同时整合了 commit-commands 插件与 gh CLI,用于简化提交、推送、创建 PR 和分支清理等操作。
用途 该技能适用于以下场景:创建分支、编写提交信息、解决合并冲突、清理已删除的远程分支、发起或编辑 PR、关联 issue、添加标签与请求审查者。它强调在提交、PR 创建和分支清理时优先使用插件或 CLI,而不是直接使用原始 git 命令。
主要能力
- 提交信息规范:采用 Conventional Commits 格式,结构为 <type>(<scope>): <subject>,可选 body 与 footer。类型包括 feat、fix、docs、style、refactor、test、chore。示例:feat(auth): add OAuth2 support for GitHub login。
- 分支命名规范:格式为 <type>/<ticket>-<description>,例如 feature/PROJ-123-user-authentication、fix/PROJ-456-null-pointer-crash、hotfix/PROJ-789-security-patch。
- 非交互式 Git:所有 git 命令必须非交互执行,使用 --no-pager 或 GIT_PAGER=cat,提交使用 -m,合并使用 --no-edit,rebase 使用 --no-edit。
- 常用操作:压缩提交(git reset --soft HEAD~N && git commit -m)、cherry-pick、撤销提交、bisect 定位问题、带描述的 stash。
- 合并冲突解决:通过 git status 识别冲突文件,查找 <<<<<<<、=======、>>>>>>> 标记,保留正确代码并移除标记,然后 git add 并继续 rebase 或 merge。解决时需调查双方改动,因为冲突代码可能代表他人正在进行的工作。
- 提交前检查:推送前运行 lint、单元测试、类型检查,例如 npm run lint && npm test && npx tsc --noEmit && git push。
- Worktree:用于隔离功能开发,支持创建、列出和移除 worktree,也可使用 commit-commands:clean_gone 清理。
- 智能体集成:fullstack-agent 在开始规格驱动工作前创建功能分支;coding-agent 和 devops-agent 使用符合任务范围的 conventional commit 提交;所有智能体使用非交互式输出;review-agent 可用 git diff 识别审查变更集;审查通过后使用 commit-commands:commit-push-pr 或 superpowers:finishing-a-development-branch 处理合并或 PR。
使用方式 插件与工具的使用时机:commit-commands:commit 用于创建 conventional commit,处理暂存、消息格式化和提交前检查;commit-commands:commit-push-pr 用于一次完成提交、推送和打开 PR;commit-commands:clean_gone 用于清理远程已删除的本地分支(标记为 [gone]),包括 worktree;gh CLI 用于 GitHub 操作,如创建/编辑 PR、关联 issue、添加标签、请求审查者、发表评论(gh pr create、gh pr edit、gh issue create)。
适用场景 适用于需要统一 Git 工作流的团队或个人项目,尤其是使用 Claude Code 智能体协作、需要规范提交与分支管理、频繁创建 PR 和清理分支的开发流程。
限制 资料未提供该技能的具体安装方式、依赖版本、平台限制、收费信息或效果保证。部分命令示例依赖 npm、npx 等工具,需在相应环境中使用。