| name | dbs-bridge |
| description | 将单个 Skill 或 Skill 集合桥接到 Claude Code、Codex、WorkBuddy、Grok 和通用 Agents。用户要求跨 Agent 安装、同步、查看或取消 Skill 链接时使用。 |
dbs-bridge：多端 skill 桥接
把任意包含 SKILL.md 的 skill 源目录，或包含多个 skill 子目录的集合目录，用软链同时挂到：
~/.claude/skills/<skill-name>~/.codex/skills/<skill-name>~/.workbuddy/skills/<skill-name>
同时为 Grok 生成薄 bridge：
~/.grok/skills/<skill-name>/SKILL.md
这样 Claude Code、Codex、WorkBuddy、Grok 等 Agent 都能通过同一个源目录调用该 skill。源目录改动后，各端自动同步。源目录可以在 dbskill 仓库内，也可以在外部项目、~/.claude/skills / ~/.codex/skills / ~/.workbuddy/skills / ~/.grok/skills 以外的本地目录、iCloud 目录或其他工作区。
~/.agents/skills 是通用 Agents 目录，但当前 Codex 也会读取它。如果同一个 skill 同时出现在 ~/.codex/skills 和 ~/.agents/skills，Codex 的 skill 列表会重复显示。默认桥接不写 ~/.agents/skills；用户明确要求豆包 Mac App、Trae Solo 或通用 Agents 时，才加 --with-agents。
核心原则
- Claude / Codex / WorkBuddy 只用软链。 不复制 skill 文件，避免多端出现版本分叉。
- 源目录可以在任何位置。 桥接目录只指向源目录。
- 绝不覆盖真实目录。 如果目标位置已有同名真实目录，停下来报告，让用户手动处理。
- Grok 生成薄 bridge。 Grok bridge 必须包含
user_invocable: true 并指向真源。
- 默认避开
~/.agents/skills。 只有用户明确要求通用 Agents 时才使用 --with-agents，避免 Codex 重复显示。
- 拆桥只删派生产物。 取消桥接时只移除目标目录下的软链和
~/.grok/skills 下由本工具生成的 bridge，不删除源目录。
- 优先用脚本执行。 使用本 skill 自带脚本
scripts/bridge-skill.sh，不要临场重写桥接命令。
确定源 skill
用户可能给：
- skill 名称：
dbs-hook
- 相对路径：
skills/dbs-hook
- 绝对路径：
/Users/.../dbskill/skills/dbs-hook
- 外部绝对路径：
/Users/.../.agents/skills/lark-doc
- skill 集合目录：
/Users/.../dbskill/skills
- 当前上下文刚创建或刚修改的 skill
按优先级判断：
- 用户明确给了绝对路径，直接使用该路径。
- 用户给了相对路径，先按当前工作目录解析，再按 dbskill 仓库根目录解析。
- 用户只给 skill 名称，优先查当前工作目录下的同名目录，再查 dbskill 仓库
skills/<name>。
- 用户只说“这个 skill”，使用当前对话里刚创建、刚改名或刚讨论的 skill。
- 仍不确定时，查看当前工作目录和仓库
skills/ 下最近修改的 skill。
- 还是无法确定时，只问一句：
桥接哪个 skill？给我 skill 名称或路径。
源目录必须满足其中一种条件：
- 目录本身包含
SKILL.md；
- 目录的一级子目录里包含多个
SKILL.md，用于批量桥接。
执行桥接
在 dbskill 仓库根目录运行：
skills/dbs-bridge/scripts/bridge-skill.sh link <skill-name-or-path>
例子：
skills/dbs-bridge/scripts/bridge-skill.sh link dbs-hook
skills/dbs-bridge/scripts/bridge-skill.sh link skills/my-custom-skill
skills/dbs-bridge/scripts/bridge-skill.sh link skills
skills/dbs-bridge/scripts/bridge-skill.sh link "/absolute/path/to/skill"
skills/dbs-bridge/scripts/bridge-skill.sh link "/Users/me/external-skills/my-skill"
skills/dbs-bridge/scripts/bridge-skill.sh link "/Users/me/external-skills"
执行后把脚本输出里的各宿主桥接结果回给用户。
如果用户明确要求豆包 Mac App、Trae Solo 或通用 Agents，也写入 ~/.agents/skills：
skills/dbs-bridge/scripts/bridge-skill.sh link --with-agents <skill-name-or-path>
查看状态
用户问“桥好了没”“查看桥接状态”时运行：
skills/dbs-bridge/scripts/bridge-skill.sh status <skill-name-or-path>
默认状态检查说明 Claude Code、Codex、WorkBuddy 和 Grok 四个位置；只有使用 --with-agents 时才额外检查 ~/.agents/skills。
取消桥接
用户说“取消桥接”“拆桥”“unlink”时运行：
skills/dbs-bridge/scripts/bridge-skill.sh unlink <skill-name-or-path>
拆桥完成后告诉用户：源 skill 没有被删除，只移除了各端派生产物。
输出规范
桥接完成后，简短回报：
已桥接 `<skill-name>`：
- Claude Code：`~/.claude/skills/<skill-name>` -> `<source-path>`
- Codex：`~/.codex/skills/<skill-name>` -> `<source-path>`
- WorkBuddy：`~/.workbuddy/skills/<skill-name>` -> `<source-path>`
- Grok：`~/.grok/skills/<skill-name>` -> `<source-path>/SKILL.md`
如果遇到同名真实目录：
没有覆盖 `<target-path>`，因为那里已经是一个真实目录。需要你先手动确认这个目录能否移走。
自检
每次执行前确认：
- 源目录存在；
- 源目录含
SKILL.md，或其一级子目录包含 SKILL.md；
- 外部路径必须使用绝对路径，或能从当前工作目录解析；
- Claude / Codex / WorkBuddy 目标位置如果存在，必须是软链才允许更新；
- 只有用户明确要求通用 Agents 时才写
~/.agents/skills，且目标位置如果存在，必须是软链才允许更新；
- Grok 目标位置如果存在，必须是本工具生成的 Grok Bridge 才允许更新；
- 不能删除源目录；
- 不能把
skills/dbs-bridge 自身复制到各端；Grok 只能生成薄 bridge。
完成当前任务后直接结束。只有用户明确询问下一步，且当前环境已经安装 /dbs 时，简短提示：「下一步不确定时，可以输入 /dbs。」
