xbridge技能
与Xcode项目交互的代理技能。
首选的集成是 xbridge命令行界面 --一个独立的工具,可以与Xcode通信,而不会在每个新会话上触发权限对话框。Xcode MCP桥(xcrun mcpbridge)支持手动回退。
安装
选项1:CLI安装(推荐)```bash
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代码插件```bash
# Add the marketplace
/plugin marketplace add 4rays/xbridge-skill
# Install the plugin
/plugin install xbridge-skill
或者直接从本地路径加载:```bash
claude --plugin-dir /path/to/xbridge-skill
> 克劳德代码特定。对于其他代理,请使用选项1或选项3。
### 选项3:克隆和复制```bash
git clone https://github.com/4rays/xbridge-skill.git
cp -r xbridge-skill/skills/* .agents/skills/
选项4:Git子模块```bash
git submodule add https://github.com/4rays/xbridge-skill.git .agents/xbridge-skill
### 选项5:分叉和自定义
1. 分叉此存储库
1. 根据您的需求定制技能
1. 将你的分支克隆到你的项目中
### 选项6:SkillKit(多代理)```bash
npx skillkit install 4rays/xbridge-skill
快速开始
1.安装xbridge```bash
brew tap 4rays/tap
brew install xbridge
### 2.启用Xcode MCP
打开 **Xcode>设置** (⌘,) → **智能** → 启用 **Xcode工具** 在模型上下文协议下。
### 3.打开您的项目```bash
open MyApp.xcodeproj
# or
open MyApp.xcworkspace
4.启动您的代理
您的代理将自动检测xbridge并将其用于所有Xcode任务。
使用xbridge
该技能通过Bash工具使用xbridge CLI。典型的工作流程:```bash
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,请手动将其添加到您的代理中。克劳德代码:```bash
claude mcp add --transport stdio xcode -- xcrun mcpbridge
注意:这需要在每次新会话开始时在Xcode中批准权限对话框。
故障排除
- 未找到xbridge:安装
brew tap 4rays/tap && brew install xbridge - 无选项卡ID:确保Xcode在项目打开的情况下运行
- Xcode MCP未启用首选 Xcode>设置>智能>模型上下文协议
- MCP权限被拒绝:在Xcode设置中撤销进程并重新连接以重新触发对话框
资源
- 苹果MCP文档
许可证
麻省理工学院
