git-rebase

mhalder 的头像作者 mhalder

指导交互式变基、提交压缩和冲突解决。当用户说“压缩提交”、“变基到主”、“交互式变基”、“清理提交”、“修复提交历史记录”或询问变基时使用。

📖 中文导读:指导交互式变基、提交压缩和冲突解决。当用户说“压缩提交”、“变基到主”、“交互式变基”、“清理提交”、“修复提交历史记录”或询问变基时使用。 以下正文为该技能的原始 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

  1. Check current branch state: git status and git log --oneline
  2. Identify rebase target (main, specific commit, etc.)
  3. Guide through the rebase process step by step
  4. Help resolve conflicts if they occur
  5. 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 -i flag (interactive mode not supported)
  • Never force push to main/master
  • Never rebase public/shared branches without explicit approval
  • Always show git log --oneline before 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"