该技能是 Git 与 GitHub 工作流指南,目标是帮助完成版本控制、团队协作以及通过 gh CLI 集成 GitHub。
用途:规范提交、分支管理、拉取请求、代码审查、Issue 与发布等日常协作操作。
主要能力:提供 git 基础命令(状态查看、暂存、提交、推送、拉取、分支创建切换删除、历史查看、撤销、stash、远程管理);进阶操作(rebase、merge、cherry-pick、tag、bisect、blame);GitHub CLI 操作(认证、PR 创建/查看/审查/合并、Issue 管理、仓库管理、workflow 运行、API 访问与 jq 处理)。附带完整工作流示例:功能开发、热修复、分支同步、PR 审查、合并清理与发布管理。
使用方式:通过 /git:commit [context] 和 /git:worktree <branch> 等快捷命令调用;提交时要求由 git-commit-message-writer 代理生成提交信息,采用 Commitizen 约定格式 <type>(<scope>): <subject>,主题行不超过 50 字符,禁止包含 AI 署名。GitHub 操作统一使用 gh CLI,例如 gh pr create、gh pr merge --squash、gh issue create。
适用场景:个人或团队在 GitHub 上进行日常开发、PR 协作、发布与仓库维护。
限制:明确禁止使用交互式 git rebase -i,因为该环境不支持交互输入;避免对 main/master 强制推送;除非用户明确要求或由 pre-commit 钩子添加编辑,否则不要使用 --amend;不要跳过钩子;破坏性命令需先确认。资料未提供安装命令、收费或平台兼容性信息。