dbs-install-skill：多端 Skill 安装与同步

把任意包含

SKILL.md

的 Skill 源目录，或包含多个 Skill 子目录的集合目录，安装到本机已经存在的 Agent。

用户始终使用同一条命令。脚本自动选择公共入口或专属入口，用户无需判断宿主类型，也无需添加模式参数。

自动路由

公共入口

脚本始终把 Skill 软链写入：

通用 Agents：
```
~/.agents/skills/<skill-name>
```

以下客户端可以读取该公共入口，因此不再写入各自的专属目录：

Codex；
GitHub Copilot；
Gemini CLI；
Cursor；
Augment；
Roo Code；
OpenCode；
OpenHands。

同一个 Skill 不会同时出现在

~/.agents/skills

和上述客户端的专属目录中。这样可以避免 Codex 等客户端重复显示。

专属入口

以下客户端当前仍使用专属目录。只有对应主目录已经存在时，脚本才创建软链：

Claude Code：
```
~/.claude/skills/<skill-name>
```
；
WorkBuddy：
```
~/.workbuddy/skills/<skill-name>
```
；
Hermes Agent：
```
~/.hermes/skills/<skill-name>
```
；
Kiro：
```
~/.kiro/skills/<skill-name>
```
；
Qwen Code：
```
~/.qwen/skills/<skill-name>
```
；
Cline：
```
~/.cline/skills/<skill-name>
```
。

Grok 薄适配层

本机存在

~/.grok

时，脚本生成：

```
~/.grok/skills/<skill-name>/SKILL.md
```

该文件必须包含

user_invocable: true

，并指向真源

SKILL.md

。

自动清理

每次执行

link

时，脚本同时处理历史遗留项：

删除公共入口兼容客户端专属目录中指向同一真源的冗余软链；
删除旧版脚本曾写入、当前已停止维护的宿主软链；
删除同一宿主中指向同一真源、且规范名称已经存在的旧别名；
集合安装时删除指向集合内已失效源目录的断裂软链和 Grok 适配层；
保留真实目录、真实文件以及指向其他来源的软链，并报告冲突；
不删除源 Skill。

核心原则

一个公共入口。 支持通用 Agents 目录的客户端统一读取
```
~/.agents/skills
```
。
必要时补专属入口。 仅给当前仍依赖原生目录的客户端创建软链。
用户无需选择模式。 脚本不要求用户提供路由参数。
公共兼容客户端只保留一份。 Codex 等客户端不能同时存在公共入口和专属入口。
各宿主只使用软链。 Grok 是唯一使用薄适配层的宿主。
不创建不存在的 Agent 主目录。
```
~/.agents
```
是公共安装入口，可以由脚本创建；其他 Agent 主目录不存在时直接跳过。
不覆盖真实目录。 目标位置已有真实目录或文件时，保留并报告。
卸载只删派生产物。
```
unlink
```
只删除指向指定真源的软链，以及本工具生成的 Grok 适配层。
优先使用脚本。 使用本 Skill 自带的
```
scripts/install-skill.sh
```
，不要临场重写安装命令。

确定源 Skill

用户可能提供：

Skill 名称：
```
dbs-hook
```
；
相对路径：
```
skills/dbs-hook
```
；
绝对路径：
```
/Users/.../dbskill/skills/dbs-hook
```
；
外部 Skill：
```
/Users/.../external-skills/lark-doc
```
；
Skill 集合目录：
```
/Users/.../dbskill/skills
```
；
当前上下文刚创建或刚修改的 Skill。

按以下优先级判断：

用户给了绝对路径，直接使用；
用户给了相对路径，先按当前工作目录解析，再按 dbskill 仓库根目录解析；
用户只给 Skill 名称，先查当前工作目录，再查 dbskill 仓库
```
skills/<name>
```
；
用户只说“这个 Skill”，使用当前对话刚创建、改名或讨论的 Skill；
仍不确定时，查看当前工作目录和仓库
```
skills/
```
下最近修改的 Skill；

仍无法确定时，只问一句：

安装哪个 Skill？给我 Skill 名称或路径。

源目录必须满足以下任一条件：

目录本身包含
```
SKILL.md
```
；
目录的一级子目录中包含一个或多个
```
SKILL.md
```
。

执行安装

在 dbskill 仓库根目录运行：

bash

skills/dbs-install-skill/scripts/install-skill.sh link <skill-name-or-path>

示例：

bash

skills/dbs-install-skill/scripts/install-skill.sh link dbs-hook
skills/dbs-install-skill/scripts/install-skill.sh link skills/my-custom-skill
skills/dbs-install-skill/scripts/install-skill.sh link skills
skills/dbs-install-skill/scripts/install-skill.sh link "/absolute/path/to/skill"
skills/dbs-install-skill/scripts/install-skill.sh link "/Users/me/external-skills"

执行完成后，根据脚本输出回报公共入口、专属入口、Grok 适配层和冗余清理结果。

查看状态

用户问“装好了吗”“有没有重复”“查看安装状态”时运行：

bash

skills/dbs-install-skill/scripts/install-skill.sh status <skill-name-or-path>

状态正常时，脚本必须输出：

text

✓ 未发现冗余入口

公共兼容客户端的专属目录中仍有同源软链时，状态返回失败并报告：

text

✗ 发现冗余入口：<target> -> <source>

卸载 Skill

用户说“卸载 Skill”“取消安装”“unlink”时运行：

bash

skills/dbs-install-skill/scripts/install-skill.sh unlink <skill-name-or-path>

完成后告诉用户：源 Skill 没有被删除，只移除了公共入口、专属入口和 Grok 适配层等派生产物。

输出规范

安装完成后简短回报：

markdown

已安装 `<skill-name>`：

- 公共入口：`~/.agents/skills/<skill-name>`；
- 专属入口：仅写入本机已安装且仍需要专属目录的 Agent；
- Grok：`~/.grok/skills/<skill-name>/SKILL.md`（本机存在时）；
- 去重：已清理指向同一真源的历史冗余软链。

遇到真实目录或其他来源时：

markdown

已保留 `<target-path>`，因为它是一个真实目录、真实文件或指向其他来源。需要你手动确认后再处理。

自检

每次执行前后确认：

源目录存在；
源目录包含
```
SKILL.md
```
，或其一级子目录包含
```
SKILL.md
```
；
外部路径使用绝对路径，或能从当前工作目录解析；
```
~/.agents/skills/<name>
```
是公共规范入口；
Codex 等公共兼容客户端的专属目录中没有同源软链；
专属宿主目标位置若存在，必须是软链才允许更新；
Grok 目标位置若存在，必须是本工具生成的 Grok 适配层才允许更新；
真实目录、真实文件和其他来源软链没有被删除；
源目录没有被删除；
```
private/
```
与
```
.private/
```
没有被读取、复制、暂存或安装。

完成当前任务后直接结束。只有用户明确询问下一步，且当前环境已经安装

/dbs

时，简短提示：「下一步不确定时，可以输入

/dbs

。」

dbs-install-skill

NPX安装

标签

SKILL.md 内容

dbs-install-skill：多端 Skill 安装与同步

自动路由

公共入口

专属入口

Grok 薄适配层

自动清理

核心原则

确定源 Skill

执行安装

查看状态

卸载 Skill

输出规范

自检