sync について
syncは、Gitの作業ツリーをリモートブランチと同期するスキルです。事前確認、プルまたはリベース、コンフリクトへの対応を案内します。
主な機能
- 01同期前に作業ツリーの状態を確認
- 02指定したリモートブランチからプル
- 03マージまたはリベースの手順に対応
- 04ローカル変更の退避やコミットを案内
- 05コンフリクトの一覧表示と解決支援
活用シーン
- 01origin mainからブランチを更新
- 02フォークをupstreamと同期
- 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
作業ディレクトリに未コミットの変更がある場合:
選択肢:
- スタッシュ:
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
よくあるシナリオ
フォークのワークフロー
# 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 を確認します |
コメント
Markdown 対応