backup

建立、列出並管理 target 目錄的備份。

skillshare backup              # Backup all skill targets
skillshare backup claude       # Backup specific target
skillshare backup agents       # Backup all agent targets
skillshare backup --all        # Backup skills + agents
skillshare backup --list       # List all backups
skillshare backup --cleanup    # Remove old backups

何時使用

• 在進行有風險的變更前手動建立備份
• 列出現有備份以確認可回復的選項
• 清理舊備份以釋放磁碟空間

自動備份

以下操作前會自動建立備份：

• skillshare sync（skill targets 與 agent targets）
• skillshare sync agents（僅 agent targets）
• skillshare target remove

位置：~/.local/share/skillshare/backups/<timestamp>/（global），.skillshare/backups/（project mode，僅 agents）

每次自動備份後會自動套用保留策略，使用與 --cleanup 相同的規則。你不需要手動清理快照。

指令

建立備份

skillshare backup              # All targets
skillshare backup claude       # Specific target
skillshare backup --dry-run    # Preview

列出備份

skillshare backup --list

All backups (15.3 MB total)
  2026-01-20_15-30-00  claude, cursor     4.2 MB  ~/.local/share/.../2026-01-20_15-30-00
  2026-01-19_10-00-00  claude             2.1 MB  ~/.local/share/.../2026-01-19_10-00-00
  2026-01-18_09-00-00  claude, cursor     4.0 MB  ~/.local/share/.../2026-01-18_09-00-00

清理舊備份

skillshare backup --cleanup           # Remove old backups
skillshare backup --cleanup --dry-run # Preview cleanup

預設清理策略：

• 保留最新 10 份備份
• 移除超過 30 天的備份
• 總大小上限為 500 MB

最新的快照永遠會被保留，即使它單獨就超過大小上限——你永遠不會失去可回復的還原點。

這項策略會在每次 sync 後自動執行，所以 --cleanup 只在需要時手動觸發即可。

選項

Flag	Description
--all	Backup both skills and agents
--project, -p	Use project mode (.skillshare/backups/); agents only
--global, -g	Use global mode (default for skills)
--list, -l	List all backups
--cleanup, -c	Remove old backups
--target, -t <name>	Target specific backup (alternative to positional arg)
--dry-run, -n	Preview without making changes

backup 也接受一個位置參數（positional kind argument）：skillshare backup agents 會把備份範圍限定在 agent targets。

備份結構

~/.local/share/skillshare/backups/
├── 2026-01-20_15-30-00/
│   ├── claude/
│   │   ├── skill-a/
│   │   └── skill-b/
│   └── cursor/
│       ├── skill-a/
│       └── skill-b/
└── 2026-01-19_10-00-00/
    └── claude/
        └── ...

實際存在的 skill 目錄取決於 target 的模式——參見備份內容。

備份內容

備份只保護 sync 可能破壞的內容：存在於 target 中但不存在於 source 中的本機內容。

• target 中的一般檔案與目錄會被備份
• merge 模式 target 中的 per-skill symlinks 會被略過——它們指向你的 source，而 source 本身就是唯一的 source of truth，已經很安全。skillshare sync 會重新建立這些 symlinks

也就是說：

• 在 merge 模式下：只有本機（非 symlink）的 skills 會被備份。已同步的 skills 存在於 source 中
• 在 copy 模式下：所有受管理的 skill 目錄都會被備份（它們是真實檔案）
• 在 symlink 模式下：不會備份任何東西（整個目錄是單一 symlink）

如果 target 內只有 symlinks，就不會建立備份，backup 會回報沒有需要處理的內容——一個空的還原點沒有意義。

備份與磁碟空間

備份永遠不會複製你的 source，所以體積很小。有三個容易混淆的獨立機制：

Mechanism	Scope	What it controls
source 中的 .gitignore	僅 Git	Git 追蹤哪些內容。被忽略的檔案仍然存在於磁碟上
config.yaml 中的 ignore:	sync	sync 會把哪些檔案複製進 targets（主要用於 copy 模式）。參見 sync
Backup	Snapshot	僅限本機 target 內容——symlinks（因此也包括 source 中的產物）都會被排除

因為 symlink 的 skill 不會被追蹤展開，存在於 source skill 內的大型產物（model weights、.venv、瀏覽器 profile、媒體檔案）永遠不會被複製進快照，無論 .gitignore 或 ignore: 是否有提到它們。

保留策略會在每次 sync 後自動執行，使用下方的預設策略。若要手動檢查用量：

du -sh ~/.local/share/skillshare/backups   # Total size on disk
skillshare backup --list                   # Per-snapshot sizes
skillshare backup --cleanup --dry-run      # Preview what retention would remove

Copy 模式的 targets 是快照仍可能變大的唯一情況：那些是真實檔案，所以 skill 目錄下的任何內容都會被複製。請把執行期快取與大型產物放在 skill 目錄樹之外，或用 ignore: 排除它們，讓它們一開始就不會被送到 target。

Agent 備份

Agents 有自己的備份流程，與 skill 備份並行執行，有兩點值得留意：

條目命名。Agent 備份會存放在每個 timestamp 目錄底下的 <target>-agents/，與 skill 備份並列。例如，執行 skillshare backup --all 後的目錄結構如下：

~/.local/share/skillshare/backups/2026-01-20_15-30-00/
├── claude/          # Skills backup for claude
├── claude-agents/   # Agents backup for claude
└── cursor/

Project mode 與 skills 相反。在 project mode（-p）下，backup 會拒絕備份 skill targets，但會備份 agent targets。如果你忘了加上 agents 篩選，會看到以下錯誤：

backup is not supported in project mode (except for agents)

因此在 project mode 下，你必須明確指定 skillshare backup -p agents 或 skillshare backup -p --all。

skillshare backup agents                  # All agent targets (global)
skillshare backup agents claude           # Only claude's agents
skillshare backup agents -p               # Project agent targets
skillshare backup --all                   # Skills + agents in one shot

參見 Agents 了解 agent 資源模型，以及 restore 了解如何回復。

另請參閱

• restore — 從備份還原
• sync — 自動建立備份
• target remove — 自動建立備份