restore — 从锁文件恢复技能

读取当前目录下的 .xskill-lock.json，安装所有已记录的技能。适用于新环境搭建或克隆项目后快速恢复技能。恢复时按 source_url 分组，同一仓库仅克隆一次，避免重复 git 操作。

xskill restore [OPTIONS]

选项：

  • -g, --global — 安装到全局 ~/.agents/skills/ 目录（默认：项目级 .agents/skills/）
  • -a, --agent <AGENT> — 目标平台（使用 '*' 表示所有平台）
  • -D, --dry-run — 预览模式：列出将要恢复的技能，不执行安装

安装目标

标志目标
（无）项目级 .agents/skills/
-g全局 ~/.agents/skills/
-a <platform>平台特定目录（如 .claude/skills/）
-a '*'所有已配置平台

示例

# 恢复所有技能到项目
xskill restore

# 恢复到全局目录
xskill restore --global

# 恢复到特定平台
xskill restore --agent claude

# 预览将要恢复的内容
xskill restore --dry-run

输出格式：

Restoring: vue
  Source: https://github.com/antfu/skills.git
  Target: .agents/skills/vue
  Name: Vue
  Description: Vue.js 技能包

Restore complete: 3 succeeded, 0 failed

Dry-run 输出（按技能名称分组，避免重复）：

Skills to restore:

NAME   SOURCE                                      TARGET
vue    https://github.com/antfu/skills.git         .claude/skills/vue
                                                    .codex/skills/vue
react  https://github.com/antfu/skills.git         .claude/skills/react
                                                    .codex/skills/react

颜色规则：多目标（-a '*' 或多个平台）时表头蓝色、续行 TARGET 黑灰色。单目标（-a <name>）时无颜色。