菜单
Interact with Xcode via mcpbridge. List windows, open files, build projects, or launch Claude agent with Xcode-provided config. Use when user mentions "xcode", "xcode windows", "open in xcode", "mcpbridge", or invokes /xcode-mcp.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when designing, reviewing, or refactoring code architecture and engineering structure, especially when logic is leaking into the wrong layer, UI components contain business rules, orchestration services do data parsing, one bug hints at a reusable abstraction, or a feature needs clear boundaries between data source, transformation, state management, extension points, and rendering. Use for separation of concerns, layered design, parser/adapter/pipeline decisions, reusable contracts, and preventing narrow fixes from becoming hardcoded architecture.
智能分析工作区变更，自动生成符合 Conventional Commits 规范的精炼提交信息并执行提交。
Review staged, unstaged, and untracked local code changes in the current project. Use when the user asks to review uncommitted changes, check the working tree, inspect local diffs, or perform a pre-commit code review.
Generate or update Ninebot iOS VApp native methods and services. Use when adding a Swift VApp API, creating a VApp-backed pod under ios/Modules, exposing native methods through NBVAppManager/NBUnifiedAPIRegistry, wiring registrations in RootVCService+vapp.swift, or converting RN/callnative methods to the VApp service pattern.
Git commit workflow with conventional format and comprehensive summaries
Harlan 的通用架构设计哲学 — 指导 AI 在任何架构任务中遵循 Harlan 的设计偏好、决策风格和输出格式。适用于系统设计、重构、模块拆分、API 设计等所有架构级别的任务。
| name | xcode-mcp |
| description | Interact with Xcode via mcpbridge. List windows, open files, build projects, or launch Claude agent with Xcode-provided config. Use when user mentions "xcode", "xcode windows", "open in xcode", "mcpbridge", or invokes /xcode-mcp. |
This skill provides interaction with Xcode through Apple's mcpbridge tool:
mcpbridge 路径:
/Applications/Xcode-26.5.0-Release.Candidate.app/Contents/Developer/usr/bin/mcpbridge
无子命令运行时，作为 MCP (Model Context Protocol) 客户端与 Xcode MCP 工具服务之间的 STDIO 桥接：
xcrun mcpbridge
读取 stdin 的 JSON-RPC 2.0 消息，转发响应到 stdout。
启动编码代理（如 Claude），从 Xcode 获取配置、认证令牌、环境：
# 启动 Claude 代理
xcrun mcpbridge run-agent claude
# 预览配置（不执行）
xcrun mcpbridge run-agent --dry-run claude
# 不包含 Xcode MCP 工具（避免 schema 问题）
xcrun mcpbridge run-agent --no-xcode-tools claude
# 传递额外参数
xcrun mcpbridge run-agent claude --model opus -p "fix the bug"
run-agent 选项:
<agent-name> - 代理名称（如 "claude"）--dry-run - 打印解析的命令但不执行--no-xcode-tools - 不包含 Xcode MCP 工具在代理配置中# 指定 Xcode 进程 PID
MCP_XCODE_PID=12345 xcrun mcpbridge
# 指定 Xcode 工具会话 UUID
MCP_XCODE_SESSION_ID=<uuid> xcrun mcpbridge
自动检测逻辑（未设置 MCP_XCODE_PID 时）:
bash /Users/ninebot/.codex/skills/xcode-mcp/scripts/xcode-windows.sh
open -a Xcode <file-path>
xcodebuild -scheme <scheme-name> build
/Applications/Xcode-26.5.0-Release.Candidate.app/Contents/Developer/usr/bin/mcpbridge run-agent --dry-run claude
输出示例：
=== mcpbridge run-agent dry run ===
Executable: /Users/ninebot/Library/Developer/Xcode/CodingAssistant/Agents/XcodeVersions/17F42/claude/claude
Xcode PID: 9793
Signing: team=Q6L2SF6YDW, identifier=com.anthropic.claude-code
Environment variables (from Xcode):
ANTHROPIC_MODEL=best
CLAUDE_CONFIG_DIR=/Users/ninebot/Library/Developer/Xcode/CodingAssistant/ClaudeAgentConfig
MCP_XCODE_PID=9793
Full command:
... --mcp-config /var/folders/.../mcp-config-XXX.json --settings '{...}'
scripts/xcode-windows.sh - AppleScript 列出 Xcode 窗口scripts/xcode_mcp_wrapper.py - Python mcpbridge wrapper（实验性）mcpbridge 作为 MCP 服务器时返回 inputSchema: {} 而非 {"type": "object"}，
导致某些 API（如 ninebot API）schema 验证失败。解决方案：
--no-xcode-tools 避免加载 Xcode MCP 工具