git-rebase
指导交互式变基、提交压缩和冲突解决。当用户说“压缩提交”、“变基到主”、“交互式变基”、“清理提交”、“修复提交历史记录”或询问变基时使用。
📖 中文导读:指导交互式变基、提交压缩和冲突解决。当用户说“压缩提交”、“变基到主”、“交互式变基”、“清理提交”、“修复提交历史记录”或询问变基时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: git-rebase description: Guide interactive rebasing, commit squashing, and conflict resolution. Use when the user says "squash commits", "rebase onto main", "interactive rebase", "clean up commits", "fix commit history", or asks about rebasing. allowed-tools: Bash, Read
Git Rebase
Guide through interactive rebasing, squashing commits, and resolving conflicts.
Instructions
- Check current branch state:
git statusandgit log --oneline - Identify rebase target (main, specific commit, etc.)
- Guide through the rebase process step by step
- Help resolve conflicts if they occur
- Verify final state
Common operations
Squash last N commits
# Squash last 3 commits into one
git rebase -i HEAD~3
# In editor, change 'pick' to 'squash' (or 's') for commits to squash
# Keep 'pick' for the first commit
Rebase onto main
git fetch origin
git rebase origin/main
Rebase interactive options
pick = use commit
reword = use commit, but edit message
edit = use commit, but stop for amending
squash = meld into previous commit
fixup = like squash, but discard message
drop = remove commit
Conflict resolution
# See conflicting files
git status
# After fixing conflicts in files
git add <file>
git rebase --continue
# To abort and return to original state
git rebase --abort
# To skip a problematic commit
git rebase --skip
Safety checks
# Before rebasing, create backup branch
git branch backup-branch
# Check if branch has been pushed
git log origin/<branch>..<branch>
# If commits are pushed, warn about force push
Rules
- MUST check if commits have been pushed before rebasing
- MUST warn about force push requirements after rebasing pushed commits
- MUST suggest creating a backup branch for complex rebases
- Never use
-iflag (interactive mode not supported) - Never force push to main/master
- Never rebase public/shared branches without explicit approval
- Always show
git log --onelinebefore and after
Non-interactive alternatives
Since interactive mode (-i) requires manual editor input, use these instead:
# Squash all commits on branch into one
git reset --soft origin/main && git commit -m "message"
# Fixup a specific commit (auto-squash)
git commit --fixup=<commit>
git rebase --autosquash origin/main
# Reword last commit
git commit --amend -m "new message"