xbridge技能
与Xcode项目交互的代理技能。
首选的集成是 xbridge命令行界面 --一个独立的工具,可以与Xcode通信,而不会在每个新会话上触发权限对话框。Xcode MCP桥(xcrun mcpbridge)支持手动回退。
安装
选项1:CLI安装(推荐)
# Install all skills
npx skills add 4rays/xbridge-skill
# Install specific skills
npx skills add 4rays/xbridge-skill --skill xbridge
# List available skills
npx skills add 4rays/xbridge-skill --list这将自动安装到您的 .agents/skills/ 目录(和符号链接到 .claude/skills/ 克劳德代码兼容性)。
选项2:Claude代码插件
# Add the marketplace
/plugin marketplace add 4rays/xbridge-skill
# Install the plugin
/plugin install xbridge-skill或者直接从本地路径加载:
claude --plugin-dir /path/to/xbridge-skill克劳德代码特定。对于其他代理,请使用选项1或选项3。
选项3:克隆和复制
git clone https://github.com/4rays/xbridge-skill.git
cp -r xbridge-skill/skills/* .agents/skills/选项4:Git子模块
git submodule add https://github.com/4rays/xbridge-skill.git .agents/xbridge-skill选项5:分叉和自定义
- 分叉此存储库
- 根据您的需求定制技能
- 将你的分支克隆到你的项目中
选项6:SkillKit(多代理)
npx skillkit install 4rays/xbridge-skill快速开始
1.安装xbridge
brew tap 4rays/tap
brew install xbridge2.启用Xcode MCP
打开 Xcode>设置 (⌘,) → 智能 → 启用 Xcode工具 在模型上下文协议下。
3.打开您的项目
open MyApp.xcodeproj
# or
open MyApp.xcworkspace4.启动您的代理
您的代理将自动检测xbridge并将其用于所有Xcode任务。
使用xbridge
该技能通过Bash工具使用xbridge CLI。典型的工作流程:
# Get a tab ID first
xbridge list-windows
# Then use it in commands
xbridge build windowtab1
xbridge test windowtab1
xbridge build-log windowtab1可用命令
| 类别 | 命令 |
|---|---|
| 状态 | status, stop, restart |
| 发现 | list-windows, tools, tool-schema, call |
| 文件 | read, write, update, ls, glob, grep, mkdir, rm, mv |
| 构建与测试 | build, build-log, test, test-list, test-run, issues, refresh-issues |
| 高级 | exec, preview, docs |
完整参考: 技能/xbridge/技能.md
Xcode MCP桥(替代方案)
如果您更喜欢MCP网桥而不是xbridge,请手动将其添加到您的代理中。克劳德代码:
claude mcp add --transport stdio xcode -- xcrun mcpbridge注意:这需要在每次新会话开始时在Xcode中批准权限对话框。
故障排除
- 未找到xbridge:安装
brew tap 4rays/tap && brew install xbridge - 无选项卡ID:确保Xcode在项目打开的情况下运行
- Xcode MCP未启用首选 Xcode>设置>智能>模型上下文协议
- MCP权限被拒绝:在Xcode设置中撤销进程并重新连接以重新触发对话框
资源
许可证
麻省理工学院
