用途:Skill Linker 用于把本地 skill/rule 来源目录中的条目,通过软链接安装到不同编辑器或工具的目标目录,方便在多项目、多 skill 体系之间切换。
安装:运行 bash scripts/install.sh --root <path>。脚本会自动安装 fzf、写入 SKILL_LINK_ROOT、安装快捷命令 skill-link,并写入当前 shell 的 rc 文件;bash 下会检测 .bashrc 是否被登录配置加载,未加载时自动补 source。SKILL_LINK_ROOT 必须包含 skills/ 与 rules/ 目录。
交互模式:直接运行 skill-link,输入关键词搜索,Tab 多选,←/→ 切换目标 Path,Enter 链接或取消链接。
非交互模式:skill-link --list --target cursor 列出候选项与状态;skill-link --target cursor agents-chat-bridge chinese-language.mdc 直接对指定条目执行操作。
Agent 流程:先根据当前编辑器判断目标 Path,Cursor 用 cursor,Claude Code 用 claude-code,Codex 用 codex;无法判断时才用 AskQuestion 让用户选择。随后运行 skill-link --list --target <path> 获取候选项和状态,用 AskQuestion 展示候选项并设置 allow_multiple: true,再对选中项运行 skill-link --target <path> <name...>。
切换行为:当前已链接到同一来源则取消链接;当前未安装则创建软链;目标已存在且不是同一软链则报错并停止。
环境变量与目标:SKILL_LINK_ROOT 为本地 skill/rule 来源根目录;目标 Path 固定为 ~/.cursor、~/.claude、~/.codex。
限制:资料未提供平台兼容范围、权限要求、卸载方式及更多错误处理细节。