| name | git-workflow |
| description | 执行明确的 Git 操作,例如查看状态、提交、建分支、push、stash 或创建 PR。只有在用户明确要求实际执行这些 Git 操作时才使用;不要用于单纯解释 Git 概念或讨论策略。 |
| user-invocable | true |
| disable-model-invocation | true |
| allowed-tools | Read, Grep, Glob, Bash(git:*, gh:*) |
| argument-hint | [status|commit|branch|push|pr|stash] [args] |
| compatibility | Requires a Git repository. Pull request creation works best when GitHub CLI (gh) is installed and authenticated. |
Git Workflow Skill
执行 Git 工作流时,优先保证仓库安全、改动边界清晰、命令可追溯。
总流程
- 先检查仓库状态,例如
git status --short --branch,必要时补充 git diff --stat、git diff --cached、git log --oneline。
- 根据第一个参数判断操作类型;如果用户表达明确,就直接执行对应流程。
- 对会改写历史、删除数据或影响远程分支的操作,先说明风险;只有在用户明确要求时才继续。
- 所有 Git 命令都使用非交互方式执行。
支持的操作
status
- 汇总当前分支、upstream、已暂存/未暂存/未跟踪文件,以及明显的下一步建议。
commit
- 只暂存与当前任务直接相关的文件;不要顺手带上无关改动。
- 如果用户没有提供 message,基于 diff 生成简洁的 Conventional Commit。
- 优先使用
git add <path>,避免无差别 git add .,除非用户明确要求全部提交。
- 提交前检查是否混入敏感文件或明显不该提交的产物。
Commit 模板
<type>(<scope>): <description>
[optional body]
[optional footer]
branch
create / new: 创建新分支。除非用户指定,否则遵循仓库已有命名风格。
switch / checkout: 切换分支前,先检查当前工作区是否干净。
list: 列出本地/远程分支,并在有帮助时指出当前分支。
delete / remove: 仅在删除条件安全且用户请求明确时执行。
push
- 先确认当前分支与 upstream 的关系。
- 首次 push 或没有 upstream 时,设置合适的 upstream。
--force 或 --force-with-lease 只有在用户明确要求时才允许。
pr
- 检查当前分支是否已 push,必要时先推送。
- 基于 diff 和提交历史生成简洁的 PR 标题与描述。
- 使用
gh pr create 前确认 gh 可用且已认证;否则清楚说明阻塞点。
stash
save: 有上下文时附带说明性消息。
list: 列出 stash,并说明最近一条的用途。
pop: 应用并删除最近 stash,若有冲突需明确报告。
drop: 仅在用户明确要求删除时执行。
安全边界
- 不要使用
git reset --hard、git checkout --、git clean -fd、git commit --amend、强推、历史改写等危险操作,除非用户明确要求。
- 不要回滚、覆盖或丢弃用户的无关改动。
- 遇到脏工作区、冲突、无 upstream、权限不足、缺少
gh 等阻塞时,要先解释现状再继续。
- 对“合并分支”“rebase”“cherry-pick”等这里没有明确定义的操作,如果用户明确提出,可以按 Git 最佳实践执行,但要先说明风险和计划。
汇报方式
- 简洁说明执行了哪些命令、当前仓库状态变成了什么样。
- 如果因为风险或条件不满足而没有执行,要明确说明原因和下一步建议。
使用示例
/git-workflow status - 查看当前仓库状态
/git-workflow commit - 分析相关改动并提交
/git-workflow commit "fix: resolve auth bug" - 使用指定消息提交
/git-workflow branch create feature/login - 创建新分支
/git-workflow push - 推送当前分支
/git-workflow pr - 为当前分支创建 PR
/git-workflow stash - 暂存当前变更