关于 sync
sync 是用于将 Git 工作树与远程分支同步的技能,涵盖同步前检查、拉取或变基操作以及冲突处理。
主要功能
- 01同步前检查工作树状态
- 02从指定远程分支拉取
- 03支持合并或变基流程
- 04指导暂存或提交本地改动
- 05列出冲突并协助处理
适用场景
- 01从 origin main 更新分支
- 02将 Fork 与 upstream 同步
- 03更新 develop 分支
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ october-academy/ agent-plugins --skill sync安装后在 Claude Code 中输入/sync确认已加载。
详细介绍
同步技能
与远程仓库快速进行 git 同步。
用法
命令
/sync # Pull from origin main
/sync develop # Pull from origin develop
/sync upstream # Pull from upstream main (forks)
韩语触发词
- “동기화”
- “원격에서 가져와”
- “풀 받아”
工作流
1. 同步前检查
git status
如果工作目录中有未提交的更改:
选项:
- 暂存:
git stash→ 同步 →git stash pop - 先提交:建议使用
/cp - 丢弃:仅当用户确认后,才使用
git checkout .
2. 获取并拉取
默认(origin main):
git pull origin main
使用变基(历史记录更整洁):
git pull --rebase origin main
3. 报告结果
同步成功后:
Synced with origin/main
- 3 commits pulled
- Files changed: 5
- No conflicts
处理冲突
如果发生合并冲突:
- 列出冲突文件
- 主动提出协助解决
- 解决后:
git add <files>→git commit
常见场景
Fork 工作流
# Add upstream if not exists
git remote add upstream <original-repo-url>
# Sync with upstream
git fetch upstream
git merge upstream/main
分叉的分支
如果本地分支和远程分支已分叉:
# Option 1: Merge (default)
git pull origin main
# Option 2: Rebase (cleaner)
git pull --rebase origin main
# Option 3: Reset (destructive, ask user)
git fetch origin
git reset --hard origin/main
错误处理
| 错误 | 解决方案 |
|---|---|
| “未提交的更改” | 暂存或先提交 |
| “合并冲突” | 协助解决冲突 |
| “未找到远程仓库” | 检查 git remote -v |
评论
支持 Markdown