dbs-install-skill

1仕組みと動作原理

SKILL.md 自体は「プロトコル説明＋出力仕様」のレイヤーに過ぎず、実際のインストール処理は付属の bash スクリプトに委ねられます。ユーザーは常に同一の単一コマンドを入力するだけで、スクリプト内部でホストの種類とエントリポイントが自動判別されます。

ルーティング戦略は「単一の共有エントリ優先」を採用しています。すべての Skill はまず ~/.agents/skills にリンクされ、この規約を未導入のホストに対してのみ専用ディレクトリが補完されます（当該ホストのホームディレクトリが既に存在する場合に限る）。

スクリプトは INSTALL_HOME 変数を用いて全ホストのルートディレクトリを一元管理し、デフォルトは $HOME で、DBS_INSTALL_HOME によるオーバーライドが可能です（テストやサンドボックス環境に便利）。

実際の書き込み処理はシンボリックリンク（Unix）またはディレクトリエクステンション Junction（Windows）であり、ソースファイルをコピーしないため、ソース Skill 更新時は各ホストへ即座に反映されます。

Grok はリンクではなく「薄いアダプター層」を使用します。スクリプトは frontmatter に user_invocable: true を含み、本文には真のソースを指す Source of truth 行のみを持つ最小限の SKILL.md を生成します。

Skill 名にはディレクトリ名ではなく真のソースの SKILL.md frontmatter にある name を採用（スクリプトは awk で frontmatter 領域のみを読み込み）、ソースディレクトリに分類プレフィックスが付いていても各 Agent のトリガー名は安定して保持されます。

link 実行時に併せて冪等なクリーンアップを実施：同一の真のソースを指す冗長／過去のエイリアス／破損リンクを削除しつつ、実ディレクトリや別ソースを指すリンクは保護（競合時はレポートを出力）。

status アクションは「冗長なエントリが存在するかどうか」を判定可能な終了コードのセマンティクスに変換します：冗長性がない場合のみ ✓ を出力し、冗長性がある場合は ✗ を報告して異常終了します。

2コア機能

4推奨統制措置と判定根拠

5二重目の独立検証

• [ok] 外部资源/工具：是否存在未披露的网络或第三方依赖 — skills/dbs-install-skill 整目录（SKILL.md + install-skill.sh + windows-junction.ps1 + agents/openai.yaml）token 扫描 curl/wget/https?:///api_key/token/secret/fetch 全部零命中；脚本只调用 ln/mkdir/rm/find/awk/sed/uname/dirname/basename 与（Windows 时）pwsh/powershell，均为本机命令。external_deps 记为空数组成立。
• [ok] 安全结论：删除动作是否会危及用户既有文件 — unlink 路径只走 unlink_if_points_to（先比对链接目标是否等于本次真源）与 unlink_grok_one；Grok 分支的 rm -rf 前面有两道门：is_managed_link、或以 grep -q '^## Grok Bridge$' 判定为本工具生成的桥接文件，否则打印「✗ 是真实目录或文件，已保留」并 return 2。link 路径同理（link_one 遇 -e "$link" 即保留）。未发现无条件 rm -rf。
• [discrepancy] SKILL.md 自检项「private/ 与 .private/ 没有被读取、复制、暂存或安装」是否由脚本兑现 — 该句仅出现在 skills/dbs-install-skill/SKILL.md:203；对整个 skill 目录 grep -rni private 只此一处，install-skill.sh 与 windows-junction.ps1 中均无任何 private/.private 过滤或跳过逻辑，仓库工具层 tools/test-dbs-install-skill*.sh 也无相关用例。真实行为是：脚本对源目录建链接/桥接，既不复制也不过滤子目录，因此源 Skill 目录内若存在 private/，它会随源目录一起被 Agent 目录侧访问到（不会产生副本）。该项属文档声明超前于实现，不构成凭空夸大宣传，但「没有被读取/安装」这一表述在脚本层面无证据。
• [ok] 功能声明 vs 实际代码能力：SKILL.md 描述的宿主清单与脚本数组是否一致 — SKILL.md 专属入口列 6 家（Claude Code/WorkBuddy/Hermes Agent/Kiro/Qwen Code/Cline），对应 NATIVE_TARGET_DIRS 恰好 6 项；公共兼容客户端列 8 家（Codex/GitHub Copilot/Gemini CLI/Cursor/Augment/Roo Code/OpenCode/OpenHands），对应 REDUNDANT_TARGET_DIRS 前 8 项注释「前 8 项已能读取 ~/.agents/skills」，数组实际长度 24（其余为旧版目录，仅用于清理）。一致。
• [unlocatable] 证据定位：stars/last_push/license 是否能在 pin 源码内定位 — stars=10121、last_push=2026-09-07 取自站点池 data/pool.json 的机器采集字段（GitHub API），pin 工作副本为本地镜像，源码内无此数据，无法在用 read 可及的仓库文件内逐字命中；license 可在仓库根 LICENSE 逐字命中（CC BY-NC 4.0）。

6結論