link — 软链接已有技能到平台

将规范目录中已存在的 skill 软链接到指定平台目录。与 add 不同，link 不会从远程源下载或安装任何 skill，仅操作本地已有的 skill。

xskill link [OPTIONS] --skill <SKILL> --agent <AGENT>

选项：

  • -s, --skill <SKILL> — 技能名称（使用 '*' 表示所有技能）
  • -a, --agent <AGENT> — 目标平台（使用 '*' 表示所有平台）
  • -g, --global — 操作全局 ~/.agents/skills/ 目录
  • -A, --all — --skill '*' --agent '*' 的简写

链接行为

标志行为
-s s1 -a codebuddy将 .agents/skills/s1 软链接到 .codebuddy/skills/s1（自动创建平台目录）
-s s1 -a codebuddy -g将 ~/.agents/skills/s1 软链接到 ~/.codebuddy/skills/s1
-s s1 -a '*'将 s1 链接到各已存在平台目录
-s '*' -a claude将所有已有 skill 链接到 claude 平台
-s '*' -a '*'将所有已有 skill 链接到各已存在平台目录
-A等同于 -s '*' -a '*'

关键规则

  • link 不需要 -f 参数（不涉及远程源）。
  • 不更新锁文件：skill 已由 add 命令安装并写入锁文件，link 仅创建 symlink。
  • 规范目录中的 skill 必须已存在（包含 SKILL.md），否则报错。
  • -s '*' 时扫描规范目录中所有包含 SKILL.md 的子目录。
  • 软链接使用相对路径，规则与 add 命令一致。
  • symlink 创建失败时回退为文件复制。

agents_compat 兼容

agents_compat: true 的平台会被跳过（直接读取规范目录）。单平台指定时输出 Skipped: <name> (agents_compat)（暗灰色）；-a '*' 时静默跳过并汇总输出。

示例

# 将单个 skill 链接到特定平台
xskill link -s vue -a claude

# 将所有已有 skill 链接到某个平台
xskill link -s '*' -a claude

# 将 skill 链接到所有平台
xskill link -s vue -a '*'

# 链接所有 skill 到所有平台
xskill link -A

# 全局模式
xskill link -s vue -a claude -g