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. 01origin mainからブランチを更新
  2. 02フォークをupstreamと同期
  3. 03developブランチを最新化

インストール

コマンドをコピーしてターミナルで実行します。

$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

よくあるシナリオ

フォークのワークフロー
# 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

エラーへの対処

エラー解決策
"Uncommitted changes"先にスタッシュするか、コミットします
"Merge conflict"コンフリクトの解決を手伝います
"Remote not found"git remote -v を確認します

コメント