dbs-bridge

dbs-bridge：多端 skill 橋接

將任意包含 SKILL.md 的 skill 來源目錄，或包含多個 skill 子目錄的集合目錄，用軟連結同時連結到：

• ~/.claude/skills/<skill-name>
• ~/.codex/skills/<skill-name>
• ~/.agents/skills/<skill-name>

同時為 Grok 生成輕量 bridge：

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

如此一來，Claude Code、Codex、豆包 Mac App、Trae Solo、Grok 等 Agent 都能透過同一個來源目錄呼叫該 skill。來源目錄變更後，各端會自動同步。來源目錄可以在 dbskill 儲存庫內，也可以在外部專案、~/.claude/skills / ~/.codex/skills / ~/.agents/skills / ~/.grok/skills 以外的本機目錄、iCloud 目錄或其他工作區。

---

核心原則

1. Claude / Codex / 通用 Agents 只使用軟連結。 不複製 skill 檔案，避免多端出現版本分歧。
2. 來源目錄可以在任何位置。 橋接目錄僅指向來源目錄。
3. 絕不覆蓋真實目錄。 若目標位置已有同名真實目錄，請停止並通報，由使用者手動處理。
4. Grok 生成輕量 bridge。 Grok bridge 必須包含 user_invocable: true 並指向真實來源。
5. 拆橋只刪除衍生產物。 取消橋接時僅移除 ~/.claude/skills、~/.codex/skills、~/.agents/skills 下的軟連結，以及 ~/.grok/skills 下由本工具生成的 bridge，不刪除來源目錄。
6. 優先使用腳本執行。 使用本 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

依優先順序判斷：

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/dbs-beta-framework-builder
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"

執行後將腳本輸出中的各宿主橋接結果回報給使用者。

---

檢視狀態

使用者詢問「橋接好了沒」、「檢視橋接狀態」時執行：

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

輸出應說明 Claude Code、Codex、通用 Agents 與 Grok 四個位置分別指向何處。

---

取消橋接

使用者說明「取消橋接」、「拆橋」、「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>`
- 通用 Agents：`~/.agents/skills/<skill-name>` -> `<source-path>`
- Grok：`~/.grok/skills/<skill-name>` -> `<source-path>/SKILL.md`

如果遇到同名真實目錄：

未覆蓋 `<target-path>`，因為該處已存在一個真實目錄。需要您先手動確認該目錄是否可移走。

---

自檢

每次執行前確認：

• 來源目錄存在；
• 來源目錄包含 SKILL.md，或其一級子目錄包含 SKILL.md；
• 外部路徑必須使用絕對路徑，或能從當前工作目錄解析；
• Claude / Codex / 通用 Agents 目標位置若已存在，必須是軟連結才允許更新；
• Grok 目標位置若已存在，必須是本工具生成的 Grok Bridge 才允許更新；
• 不能刪除來源目錄；
• 不能將 skills/dbs-bridge 本身複製到各端；Grok 只能生成輕量 bridge。

---

不知道下一步用哪個 Skill？

輸入 /dbs。

它會讀取剛才的具體結論，選擇當前最值得處理的一個方向，並直接路由到對應 Skill。