用途:将插件组件完整部署到各代理环境。仅用 Python 3.8+ 标准库,依赖命令:pip-compile ./requirements.in、pip install -r ./requirements.txt。相比 npx skills 只装 skills,bridge_installer.py 支持 skills、commands、rules、hooks、MCP 全量部署。
主要能力:以 .agents/ 为中央仓库,按 DETECTABLE_AGENTS 将组件符号链接或追加到 .agent/(Antigravity)、.claude/、.gemini/、.github/ 等目录;commands 源目录固定为 commands/,安装时映射到各平台目录(如 workflows/、prompts/);嵌套命令目录扁平化为 snake_case;MCP 合并到 ./.mcp.json。安装后写入 npx skills 锁文件(全局 ~/.agents/.skill-lock.json、项目 skills-lock.json),使 list/check/update 可见。
使用方式:安装单插件 python ./bridge_installer.py --plugin plugins/my-plugin;全部 python ./install_all_plugins.py;预览加 --dry-run。重装前清理:rm -rf .agents/ && npx skills remove --all -y。执行前须做 Pre-flight 检查与 Recap-Before-Execute,默认先 dry-run,等待明确确认。禁止使用 --target auto。
限制与回退:目标目录不存在时不自动创建,需打印 mkdir 命令并等待确认;插件未找到不扫描相似名;部分失败须逐项报告,不得宣称成功;Windows 无开发者模式时符号链接静默失败,回退为目录复制并记录 symlinkFailed: true;锁文件写入失败不中止安装,但提示 npx skills 可能不同步。hooks 仅 Claude 支持,Antigravity/Gemini/GitHub 忽略。Gemini 命令以 TOML 包装,仅读取 frontmatter 首个单行 description。纯远程分发给终端用户应改用 npx skills add。官方未提供收费、价格等其他信息。