跳至主要內容

pull

從 git remote 拉取並同步到所有 targets。

skillshare pull              # Pull and sync
skillshare pull --dry-run    # Preview
skillshare pull --force      # Replace local with remote on first pull

何時使用​

  • 從已推送變更的另一台機器同步 skills
  • 取得其他人推送更新後的最新 skills
  • 在 init --remote 之後於新機器上開始工作

執行流程​

選項​

FlagDescription
--dry-run, -nPreview without making changes
--force, -fOn first pull conflict, replace local skills with remote

Git Root 範圍​

pull 會操作 git_root 設定欄位所選定的目錄（預設為 skills source）。範圍對照表參見 commit — Git Root Scope。如果 git_root 已變更，但 git repo 仍存在於另一個 scope 的目錄下，pull 會印出「Git root mismatch」錯誤，並附上確切的 git init / mv 修正指令。參見 init 之後變更 scope。

拉取完成後，pull 會同步該 scope 所涵蓋的內容：skills 執行 sync，agents 執行 sync agents，root 兩者都執行，extras 執行 sync extras。

先決條件​

你的 source 目錄必須是一個帶有 remote 的 git repository：

# Check if ready:
skillshare status
# Shows: Git: initialized with remote

本機變更警告​

如果你有尚未 commit 的變更，pull 會失敗：

$ skillshare pull
Local changes detected
  Run: skillshare push
  Or:  cd ~/.config/skillshare/skills && git stash

解決方法：

# Option 1: Commit locally first, without pushing
skillshare commit -m "Local changes"
skillshare pull

# Option 2: Push your changes first
skillshare push
skillshare pull

# Option 3: Stash your changes
cd ~/.config/skillshare/skills
git stash
skillshare pull
git stash pop

首次 Pull 且已有現存 Skills​

在第一次 pull（尚未設定 upstream）時，如果本機與 remote 都已經有 skill 目錄， pull 會嘗試進行 merge 以合併雙方內容。如果 merge 成功，本機與 remote 的 skills 都會被保留。

如果發生 merge 衝突，pull 會失敗並回傳非零的 exit code：

$ skillshare pull
Pull failed
  Resolve manually: cd ~/.config/skillshare/skills && git merge --allow-unrelated-histories <remote branch>
  Or force-pull: skillshare pull --force  (replaces local with remote)

解決方式：

# Resolve conflicts manually, then push
cd ~/.config/skillshare/skills
git add . && git commit
skillshare push

# Or discard local and take remote
skillshare pull --force

範例​

# Standard pull (most common)
skillshare pull

# Preview what would happen
skillshare pull --dry-run

# Replace local with remote on first-pull conflict
skillshare pull --force

工作流程​

在次要機器上的典型工作流程：

# Start of day: get latest skills
skillshare pull

# ... work with AI tools ...

# End of day: share any new skills
skillshare collect claude    # If you created new skills
skillshare push -m "Add new skill"

另請參閱​