push

Commit 並將 source 推送到 git remote。

如果你只想建立本機檢查點而不推送，請改用 commit。

skillshare push                  # Auto-generated message
skillshare push -m "Add pdf"     # Custom message
skillshare push --pull           # Merge remote changes, push, then sync
skillshare push --dry-run        # Preview

何時使用

• 透過 git 把 skill 變更分享到你的其他機器
• 把 skills 備份到 remote repository
• 編輯 skills 後，一次完成 commit 與 push

如果只想先建立本機檢查點而尚未要分享，請使用 skillshare commit。

執行流程

選項

Flag	Description
-m, --message <msg>	Commit message (default: "Update skills")
--pull	Merge remote changes before pushing, then sync targets (see Push and Pull Together)
--dry-run, -n	Preview without making changes

Git Root 範圍

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

在 git_root: root 下，如果任何尚未推送的 commit 新增或修改了 config.yaml 或 config.yaml/ 下的檔案，即使後續 commit 已將其刪除，push 仍會拒絕推送。此檢查也適用於 --pull 與 --dry-run，並在 staging 或 pull 之前執行；dry-run 不會修改任何內容。錯誤會列出相關 commit hash。只有 push 推送目標 remote（upstream 所在的 remote，首次推送前為 origin）的任何 ref 都不包含的 commit 才視為尚未推送，因此該 remote 已有的 history 不會被拒絕。無論 push.default 或 remote.pushDefault 如何設定，push 都只會把目前分支推送到該 remote。

重試前，請從列出的 commit 中移除檔案：執行錯誤訊息中顯示的 git rebase -i <commit>（從最舊的相關 commit 之前開始），將相關 commit 標記為編輯，並在每次編輯時執行 git rm -r --cached -- config.yaml、git commit --amend 與 git rebase --continue。Skillshare 不會自動改寫 history。僅停止追蹤已發布的 config.yaml 的 commit 仍可推送；在尚未推送的新增 commit 後增加刪除 commit，不會清除 history 中的舊內容。

先決條件

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

# Set up during init (recommended):
skillshare init --remote [email protected]:you/my-skills.git

# Or add remote to existing setup:
skillshare init --remote [email protected]:you/my-skills.git

Init 會自動建立初始 commit，所以設定完成後 push 可以立即使用。

首次 Push 的 Upstream 對應

在第一次 push（尚未設定 upstream tracking）時，skillshare push 會自動設定 upstream：

• 如果 remote 已經有預設分支（例如 main 或 trunk），本機變更會被推送到該 remote 預設分支。
• 如果 remote 是空的，則推送到你目前的本機分支。

這可以避免意外建立錯誤的 remote 分支（例如本機是 master 但 remote 使用 main）。

範例

# Quick push with auto message
skillshare push

# Custom commit message
skillshare push -m "Add commit-commands skill"

# Preview what would be pushed
skillshare push --dry-run

衝突處理

如果 remote 有較新的 commits：

$ skillshare push
✗ Push failed
  Remote may have newer changes

Next
  skillshare pull  get them first
  skillshare push  then push again

解決方法：

skillshare pull    # Merge remote changes with yours
skillshare push    # Push your changes

pull 會把 remote 的 commits 和你尚未 push 的 commits 合併，所以第二次 push 就會成功。如果兩邊改了同一個檔案，請參閱兩台機器都有 Commit 時。

同時 Push 與 Pull

skillshare push --pull 用一個指令完成整趟來回：

1. Commit 你的本機變更（如果有的話）
2. 合併 remote 的新 commits，方式和 pull 相同
3. Push 合併結果
4. 和 pull 一樣，依照 git root 範圍涵蓋的內容 sync targets

如果合併時發生衝突，就不會 push 任何東西，也不會 sync targets。你的變更仍以 commit 的形式保留在本機；解決衝突後，再執行一次 skillshare push --pull。如果 push 成功但 sync targets 失敗，remote 已經更新了，請執行畫面上印出的 skillshare sync ... --global 指令重試（依 git_root 對應的資源，每項一行）。

在 git_root: root 下，如果合併帶進了 remote 追蹤的 config.yaml，push --pull 會保留這台機器的副本，並在同一次 push 中把 config.yaml 從 remote 移除。

--pull 絕不會 rebase，也絕不會 force-push。

工作流程

分享 skills 的典型工作流程：

# 1. Make changes to skills
# 2. Push to remote
skillshare push -m "Update my-skill"

# On another machine:
skillshare pull    # Gets changes and syncs

另請參閱

• commit — 在不推送的情況下本機 commit
• pull — 從 remote 拉取
• sync — 同步到本機 targets
• Cross-Machine Sync — 完整設定說明