SuperAPI AI 工具集

xcode-mcp-first-executor

编程与开发

查看项目

更新于 10-16 06:00

技能介绍

用途

Xcode MCP First Executor 用于在任务可以通过 Xcode MCP 完成时,优先使用 Xcode MCP 工具来执行 Apple 与 Swift 相关操作。它的目标是在 MCP 可用时走 MCP 路径,并在 MCP 不可用时给出结构化的回退交接,而不是依赖不稳定的标签页索引假设。

主要能力

  • 通过 XcodeListWindows 返回的 workspacePath 解析目标工作区,避免使用可能过期的标签页索引。
  • 对 MCP 支持的动作,优先使用 MCP 工具矩阵(references/mcp-tool-matrix.md)执行。
  • 对瞬时 MCP 失败(超时或传输错误)执行一次立即重试;若仍失败,则生成回退交接载荷。
  • 回退交接载荷包含:意图类别、首选官方 CLI 命令、MCP 路径失败原因。
  • 对 Xcode 管理范围内的变更请求,若存在 MCP 变更工具则继续通过 MCP 执行;若回退到直接文件系统编辑,则先路由到 $apple-dev-safety-and-docs。
  • 提供交互式定制流程,可加载当前生效配置、逐项询问定制问题、映射到实现文件并持久化定制状态。

使用方式

  1. 解析活动标签页:调用 XcodeListWindows,按 workspacePath 匹配选择标签页。
  2. 通过 MCP 矩阵执行:参考 references/mcp-tool-matrix.md。
  3. 对瞬时 MCP 失败重试:超时或传输错误时立即重试一次;若仍失败,生成回退交接载荷。
  4. 变更请求:在 Xcode 管理范围内,若可用则继续使用 MCP 变更工具;若回退到直接文件系统编辑,先路由到 $apple-dev-safety-and-docs。

交互式定制流程:

  • 先加载当前生效的定制设置:uv run python scripts/customization_config.py effective
  • 使用 references/customization-flow.md 驱动逐项定制问题。
  • 确认期望的行为变更与安全约束。
  • 将请求的变更映射到实现文件:更新 SKILL.md、references/* 以及 references/customization-flow.md 中列出的运行时脚本文件。
  • 持久化定制状态:从 customization.template.yaml 默认值开始;使用 uv run python scripts/customization_config.py apply --input <yaml-file> 应用已批准的覆盖。持久路径为 ~/.config/gaelic-ghost/apple-dev-skills/<skill-name>/customization.yaml;可选覆盖根目录为 APPLE_DEV_SKILLS_CONFIG_HOME。
  • 报告最终生效配置:重新运行 uv run python scripts/customization_config.py effective 并汇总最终活动设置。
  • 若用户要求移除定制状态,运行 uv run python scripts/customization_config.py reset。

适用场景

适用于可以通过 Xcode MCP 执行的 Apple 与 Swift 开发任务,尤其是需要稳定解析目标工作区、优先走 MCP 路径、并在 MCP 失败时获得结构化回退交接的场景。也适用于需要对技能行为进行交互式定制并持久化配置的场景。

限制

资料未提供该技能支持的具体 MCP 工具清单、重试策略的完整细节、回退交接载荷的完整字段定义、定制流程中可用的具体旋钮、验证检查项以及示例请求;这些内容需参考技能内的 references 文件。资料也未提供收费、价格、平台兼容性、效果保证等信息。