使用说明
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 xbridge
2.启用Xcode MCP
打开 Xcode>设置 (⌘,) → 智能 → 启用 Xcode工具 在模型上下文协议下。
3.打开您的项目
open MyApp.xcodeproj
# or
open MyApp.xcworkspace
4.启动您的代理
您的代理将自动检测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设置中撤销进程并重新连接以重新触发对话框
资源
许可证
麻省理工学院
