| name | git-ops |
| description | Use when Sam asks Codex to create, rename, compare, commit, push, merge, promote, or clean up Git branches. Covers Sam's feature branch naming convention, safe Git pre-checks, JetBrains DontCommit handling, commit-message defaults, push and release promotion verification, branch rename upstream cleanup, branch sync comparison, and submodule/gitlink handling. |
Git Ops
Scope
Use this skill for Git operation tasks. Keep project-specific runtime, build, API, environment, and release-policy details in the repo's AGENTS.md; keep reusable Git behavior here.
Do not expand scope silently. If Sam only asks to inspect, report findings. If Sam asks to commit/push/merge, carry that operation through verification unless blocked.
Safety Rules
Before any Git write operation:
git status --short --branch
Rules:
- Treat existing uncommitted changes as user work unless proven otherwise.
- Do not run destructive commands such as
git reset --hard, git checkout -- <file>, git clean -fd, git push --delete, or force-push without explicit written confirmation.
- Use
git clean -fdn before any real clean operation and report what would be removed.
- Prefer
rg, git diff, git status, git branch -vv, git log, and git show-ref for inspection before acting.
- For remote cleanup wording, say
stale local remote-tracking refs or 本地 origin/* 缓存; git fetch --prune origin does not delete remote branches.
Feature Branch Naming
When Sam says "功能分支" or asks to create a feature branch, use:
feature/<YYYYMMDD>/<需求编码>_<功能简介>
Example:
feature/20260521/MR2026052182911_xiaomei
Rules:
- The first path segment is always
feature.
- The second segment is the date as
YYYYMMDD.
- Sam usually provides the date. If the date is missing, ask before creating the branch.
- If Sam provides
MMDD only, normalize it to YYYYMMDD using the clearly applicable year from the task context. If the year is ambiguous, ask.
- The third segment is
<需求编码>_<功能简介>.
- Do not invent a requirement code. If missing, ask.
- Keep
功能简介 short and branch-safe. Prefer lowercase ASCII slugs such as hyde, xiaomei, rrl_auth.
Given:
需求编码: MR2026051590006
date: 0528
功能简介: hyde
Create:
feature/20260528/MR2026051590006_hyde
Create Branch
Before creating a branch:
- Run
git status --short --branch.
- Check whether the base branch and target branch exist.
- If the worktree has unrelated changes, ask whether to use a separate worktree, stash, or keep the current state.
- Refresh the remote base when network access is available.
Preferred feature-from-master flow:
git fetch origin master
git switch --no-track -c feature/YYYYMMDD/MRxxxx_short_desc origin/master
git status --short --branch
Use --no-track so a new feature branch does not accidentally track origin/master.
If Sam explicitly says to use local master, create from local master:
git switch --no-track -c feature/YYYYMMDD/MRxxxx_short_desc master
JetBrains DontCommit
Before git add / git commit, inspect .idea/workspace.xml if it exists:
rg -n "ChangeListManager|DontCommit|DoNotCommit" .idea/workspace.xml
Rules:
- Files in
DontCommit / DoNotCommit changelists must not be committed.
- If such files are already staged, unstage only those files.
- Override only if Sam explicitly asks to include them.
- If the main worktree has DontCommit or unrelated local files, prefer a temporary
git worktree for release promotion.
Commit And Push
When Sam says "提交推送吧" after implementation, treat commit and push as part of the task.
Before commit:
git status --short --branch
git diff --check
Rules:
- Stage only intended files.
- Keep unrelated user changes unstaged.
- Default
git commit messages to Chinese. Code identifiers, module names, commands, paths, and proper nouns may stay in English.
- If independent topics are mixed and Sam says "拆两个", split commits by topic.
- After push, verify branch state with
git status --short --branch and, when useful, git branch -vv --list <branch>.
Release Promotion
When Sam explicitly asks to merge/push into release/sit, release/uat, or a dated release branch, perform the full requested merge and push path unless blocked.
Default flow:
git fetch origin <target-branch>
git switch <target-branch>
git merge --ff-only <feature-branch>
git push origin <target-branch>
If --ff-only fails:
- Inspect divergence first.
- Explain why fast-forward is impossible.
- Use
git merge --no-ff -m "<中文合并信息>" <feature-branch> only when that matches the requested promotion.
For multi-branch promotion:
- Keep the sequence explicit.
- Verify each local and remote branch tip.
- Use temporary
git worktree when the main workspace has unrelated local changes.
Rename Branch
For branch rename requests, change the visible branch identifier exactly. Do not add code edits or content merges.
Reliable flow:
git branch -m <old> <new>
git branch --unset-upstream <new>
git push -u origin <new>
git branch -vv --list <new>
git ls-remote --heads origin <new> <old>
Rules:
- After
git branch -m, always check for stale upstream metadata.
- Do not delete the old remote branch unless Sam explicitly asks.
- If deleting a remote branch is requested, verify the old and new refs point to the expected content first.
Compare Branches
Do not judge sync from commit message shape alone. Compare content and ancestry:
git rev-list --left-right --count <left>...<right>
git rev-parse <ref>^{tree}
git diff --name-status <left>..<right>
git log --oneline --ancestry-path <left>..<right>
Notes:
release/sit may carry extra merge history while still being content-identical to release/uat or a feature branch.- Tree hash plus
git diff --name-status is the most direct content-sync check.
Submodules
When a repo contains submodules or gitlinks:
- A
160000 entry is a parent-repo pointer, not normal file content.
- If submodule source changed, commit and push inside the submodule first, then commit the parent pointer.
- Branch switching can leave an untracked submodule working tree on disk. Inspect it as submodule state; do not delete it as noise without confirmation.
Finish
Always report the final Git state:
- current branch
- start point or target branch used
- commit hash / merge hash when created
- push result when pushed
- verification commands run
- whether
git status --short --branch is clean
- skipped files, especially
DontCommit / DoNotCommit
