mcpField
S
sync

sync

github.com/october-academy开发01.2k 次安装16 周前更新
代码仓库

关于 sync

sync 是用于将 Git 工作树与远程分支同步的技能,涵盖同步前检查、拉取或变基操作以及冲突处理。

主要功能

  1. 01同步前检查工作树状态
  2. 02从指定远程分支拉取
  3. 03支持合并或变基流程
  4. 04指导暂存或提交本地改动
  5. 05列出冲突并协助处理

适用场景

  1. 01从 origin main 更新分支
  2. 02将 Fork 与 upstream 同步
  3. 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

如果工作目录中有未提交的更改:

选项:

  1. 暂存:git stash → 同步 → git stash pop
  2. 先提交:建议使用 /cp
  3. 丢弃:仅当用户确认后,才使用 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

处理冲突

如果发生合并冲突:

  1. 列出冲突文件
  2. 主动提出协助解决
  3. 解决后: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