xcode-mcp-first-executor

📁 gaelic-ghost/apple-dev-skills 📅 1 day ago
2
总安装量
2
周安装量
#75261
全站排名
安装命令
npx skills add https://github.com/gaelic-ghost/apple-dev-skills --skill xcode-mcp-first-executor

Agent 安装分布

amp 2
cline 2
opencode 2
cursor 2
kimi-cli 2
codex 2

Skill 文档

Xcode MCP First Executor

Use this skill when a task can be performed through Xcode MCP.

Core Rules

  • Resolve target workspace by workspacePath from XcodeListWindows.
  • Do not trust stale tab index assumptions.
  • Use MCP tools first for supported actions.
  • If MCP fails after retry policy, output structured handoff to $apple-swift-cli-fallback.

Workflow

  1. Resolve active tab:
  • call XcodeListWindows
  • pick tab by matching workspacePath
  1. Execute via MCP matrix:
  • use references/mcp-tool-matrix.md
  1. Retry on transient MCP failures:
  • one immediate retry for timeout or transport error
  • if still failing, generate fallback handoff payload
  1. Handoff payload:
  • include intent category
  • include preferred official CLI command(s)
  • include reason MCP path failed

Mutation Note

For mutation requests in Xcode-managed scope, continue through MCP mutation tools if available. If falling back to direct filesystem edits, route to $apple-dev-safety-and-docs first.

References

  • references/mcp-tool-matrix.md
  • references/mcp-failure-handoff.md
  • references/mutation-via-mcp.md