mcpField
D
dbs-bridge

dbs-bridge

github.com/dontbesilent2025Agent 工作流10.9k9.0k 次安装1 天前更新
代码仓库

关于 dbs-bridge

dbs-bridge 是用于将 Skill 源目录桥接到本机 Agent 环境的工具，适合管理多个 Agent 的用户。它自动选择公共或专属入口，并清理重复桥接项，同时保留源 Skill。

主要功能

  1. 01自动识别 Skill 源目录
  2. 02按 Agent 自动选择入口
  3. 03通过软链桥接 Skill
  4. 04生成 Grok 专用 bridge
  5. 05检查状态并清理冗余项
  6. 06取消桥接时保留源文件

适用场景

  1. 01将单个 Skill 接入已安装的 Agent
  2. 02批量桥接 Skill 集合目录
  3. 03检查重复入口并清理旧软链
  4. 04解除桥接而不删除源 Skill

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/dontbesilent2025/dbskill --skill dbs-bridge

安装后在 Claude Code 中输入/dbs-bridge确认已加载。

附带文件agents/openai.yamlscripts/bridge-skill.sh

详细介绍

来自项目 README

dbs-bridge：多端 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 薄 bridge

本机存在 ~/.grok 时，脚本生成：

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

该文件必须包含 user_invocable: true，并指向真源 SKILL.md。

自动清理

每次执行 link 时，脚本同时处理历史遗留项：

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

核心原则

  1. 一个公共入口。 支持通用 Agents 目录的客户端统一读取 ~/.agents/skills。
  2. 必要时补专属入口。 仅给当前仍依赖原生目录的客户端创建软链。
  3. 用户无需选择模式。 脚本不要求用户提供路由参数。
  4. 公共兼容客户端只保留一份。 Codex 等客户端不能同时存在公共入口和专属入口。
  5. 各宿主只使用软链。 Grok 是唯一使用薄 bridge 的宿主。
  6. 不创建不存在的 Agent 主目录。 ~/.agents 是公共桥接基础设施，可以由脚本创建；其他 Agent 主目录不存在时直接跳过。
  7. 不覆盖真实目录。 目标位置已有真实目录或文件时，保留并报告。
  8. 拆桥只删派生产物。 unlink 只删除指向指定真源的软链，以及本工具生成的 Grok bridge。
  9. 优先使用脚本。 使用本 Skill 自带的 scripts/bridge-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。

按以下优先级判断：

  1. 用户给了绝对路径，直接使用；
  2. 用户给了相对路径，先按当前工作目录解析，再按 dbskill 仓库根目录解析；
  3. 用户只给 Skill 名称，先查当前工作目录，再查 dbskill 仓库 skills/<name>；
  4. 用户只说“这个 Skill”，使用当前对话刚创建、改名或讨论的 Skill；
  5. 仍不确定时，查看当前工作目录和仓库 skills/ 下最近修改的 Skill；
  6. 仍无法确定时，只问一句：桥接哪个 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"

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

查看状态

用户问“桥好了没”“有没有重复”“查看桥接状态”时运行：

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

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

✓ 未发现冗余入口

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

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

取消桥接

用户说“取消桥接”“拆桥”“unlink”时运行：

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

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

输出规范

桥接完成后简短回报：

已桥接 `<skill-name>`：

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

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

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

自检

每次执行前后确认：

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

完成当前任务后直接结束。只有用户明确询问下一步，且当前环境已经安装 /dbs 时，简短提示：「下一步不确定时，可以输入 /dbs。」

评论

支持 Markdown