跳至主要內容

遷移

從其他 Skill 管理方式遷移到 skillshare。

從手動管理遷移​

如果你一直是在各個 AI CLI 之間手動複製 Skills：

步驟 1：初始化 skillshare​

skillshare init

步驟 2：收集既有的 Skills​

# 從各個 AI CLI 收集
skillshare collect claude
skillshare collect cursor
skillshare collect codex

# 或一次從所有 CLI 收集
skillshare collect --all

步驟 3：處理重複項目​

如果同一個 Skill 存在於多個地方，collect 會提出警告。請選擇要保留哪一個。

步驟 4：Sync​

skillshare sync

現在所有 Targets 都會透過 symlink 連結到你單一的 Source。

從其他安裝工具遷移​

如果你曾使用 npx install-skill 或類似工具：

步驟 1：初始化 skillshare​

skillshare init

步驟 2：備份既有的 Skills​

skillshare backup

步驟 3：收集或重新安裝​

選項 A：收集既有的（保留目前版本）

skillshare collect --all

選項 B：從 Source 重新安裝（取得最新版本）

# 檢查 metadata
cat ~/.config/skillshare/skills/.metadata.json

# 重新安裝
skillshare install anthropics/skills/skills/pdf

步驟 4：Sync​

skillshare sync

從 Git Submodules 遷移​

如果你一直使用 git submodules：

步驟 1：匯出 submodule 內容​

# 在你既有的 Skills repo 中
git submodule foreach 'cp -r $toplevel/$sm_path ~/temp-skills/$name'

步驟 2：初始化 skillshare​

skillshare init

步驟 3：匯入 Skills​

# 複製到 Source
cp -r ~/temp-skills/* ~/.config/skillshare/skills/

# 或以 tracked repo 的方式安裝
skillshare install github.com/org/skill-repo --track

步驟 4：Sync​

skillshare sync

從已 Commit 的 Project Skills 遷移​

如果你的 repo 已經在 .claude/skills/、.cursor/skills/ 或類似目錄中 commit 了 Skills：

步驟 1：初始化 Project mode​

cd my-project
skillshare init -p

步驟 2：將 Skills 搬到 .skillshare/skills/​

# 將既有的 Skills 複製到 skillshare Source
cp -r .claude/skills/my-skill .skillshare/skills/
cp -r .claude/skills/api-guide .skillshare/skills/

# 移除原始檔案（sync 會重新建立為 symlink）
rm -rf .claude/skills/my-skill .claude/skills/api-guide

步驟 3：Sync​

skillshare sync

現在 .claude/skills/my-skill 是指向 .skillshare/skills/my-skill 的 symlink — 而所有其他 Targets（Cursor、Windsurf 等）也會自動取得相同的 Skills。

步驟 4：Commit 這次遷移​

git add .skillshare/ .claude/skills/ .cursor/skills/
git commit -m "Migrate project skills to skillshare"
多工具的好處

遷移前：Skills 只能在一個 AI CLI 中使用。遷移後：相同的 Skills 會自動出現在每一個已設定的 Target 中。

從團隊專屬方案遷移​

如果你的團隊有自訂的 Skill 分享方式：

步驟 1：確認目前的做法​

  • Skills 儲存在哪裡？
  • 如何分享？
  • 如何更新？

步驟 2：選擇你的遷移路徑​

選項 A：Global mode — Skills 在每台機器上的所有專案間都可使用。

# 建立團隊 Skills repo
cp -r /current/team/skills ~/new-team-skills
cd ~/new-team-skills && git init && git add . && git commit -m "Migrate to skillshare"
git push origin main

# 團隊成員以全域方式安裝
skillshare install github.com/org/team-skills --track && skillshare sync

選項 B：Project mode — Skills 限定在特定 repo 範圍內，透過 git 分享。

cd my-project
skillshare init -p

# 將團隊 Skills 搬進專案 Source
cp -r /current/team/skills/* .skillshare/skills/

# Sync 並 commit
skillshare sync
git add .skillshare/
git commit -m "Add team skills via skillshare"

新加入的團隊成員只需執行：

git clone github.com/org/my-project
cd my-project
skillshare install -p && skillshare sync

選項 C：兩者並用 — 全組織的標準採用 Global，各專案特有的 Skills 則使用 Project。

# 組織標準（Global）
skillshare install github.com/org/standards --track && skillshare sync

# 專案特定的 Skills（Project mode）
cd my-project
skillshare init -p
skillshare install github.com/org/project-skills -p && skillshare sync
該選哪一種？
  • Global：程式碼規範、安全稽核 — 每個專案都需要的東西
  • Project：API 慣例、領域規則、部署指南 — 特定於單一 repo 的東西
  • 兩者並用：大多數團隊隨著規模成長，最終都會走到這一步

從 Global 遷移到 Project​

如果你在 Global mode 中有屬於特定專案的 Skills：

步驟 1：初始化 Project mode​

cd my-project
skillshare init -p

步驟 2：從 Global Source 複製 Skills​

# 複製特定的 Skills
cp -r ~/.config/skillshare/skills/api-guide .skillshare/skills/
cp -r ~/.config/skillshare/skills/deploy-rules .skillshare/skills/

步驟 3：從 Global 中移除（可選）​

skillshare uninstall api-guide
skillshare uninstall deploy-rules
skillshare sync   # 清理 Global symlink

步驟 4：Sync 並 commit​

skillshare sync   # 自動偵測為 Project mode
git add .skillshare/
git commit -m "Move project-specific skills to project mode"

完成後，這些 Skills 會被限定在這個 repo 範圍內，並透過 git 與團隊分享 — 不再佔用你的 Global 設定空間。

保留歷史紀錄​

如果你想保留 git 歷史紀錄：

個人 Skills​

# 將既有的 repo clone 到 skillshare 的位置
git clone your-existing-repo ~/.config/skillshare/skills

# 以既有的 Source 初始化 skillshare
skillshare init --source ~/.config/skillshare/skills

團隊 repos​

# 使用 --track 保留 .git
skillshare install github.com/team/skills --track

回復（Rollback）​

如果遷移出了問題：

從備份還原​

skillshare restore claude
skillshare restore cursor

重新開始​

rm ~/.config/skillshare/config.yaml
skillshare init

檢查清單​

遷移之前：

  • 列出目前所有 Skill 的位置
  • 找出重複項目
  • 記下任何自訂設定
  • 建立備份

遷移之後：

  • 確認所有 Skills 都出現在 skillshare list 中
  • 在每個 AI CLI 中測試 Skills
  • 設定 git remote（若有需要）
  • 向團隊分享新的 Workflow

另請參閱​