用途：该技能是在 Xcode 及 Swift 环境中执行任务的顶层入口，侧重实际执行而非文档管理或仓库同步，并遵循共享的 simplicity-first Swift 策略。
主要能力：支持 Xcode 工作区检查、读取/搜索、诊断、构建、测试、运行，Swift 工具链检查与官方 Apple CLI 回退，以及在 Xcode 管理范围内可能的直接文件系统变更。可分类请求为工作区/会话检查、读取搜索诊断、构建测试运行、包或工具链管理、变更等操作类型。
使用方式：先通过 explore-apple-swift-docs 收集 Apple 文档并说明所依赖的 API 行为后再提出改动；遵循 references/snippets/apple-xcode-project-core.md 的本地策略；运行 scripts/run_workflow.py 应用运行时配置、变更守卫检查、咨询冷却与 CLI 回退规划。MCP 操作指南见 references/mcp-tool-matrix.md，MCP 失败时结合脚本结构化回退输出与 references/cli-fallback-matrix.md。输入包括 operation_type、可选 workspace_path、tab_identifier、mcp_failure_reason、filesystem_fallback_opt_in。默认：脚本入口为 scripts/run_workflow.py，MCP 瞬时失败重试一次，咨询冷却 21 天，变更操作在 Xcode 管理范围需显式守卫。
限制：官方 CLI 是主 MCP 路径无法完成时唯一回退路径；无法解析工作区上下文或许可名单/沙箱阻止 CLI 回退时以 blocked 停止；脚本仅规划回退命令，MCP 执行仍由代理侧完成；当前工作流使用固定安全默认值而非普通用户可调项。旧称 apple-xcode-workflow 现映射至本技能，Codex 或 Claude Code 插件安装为后续首选路径。