apple-xcode-hybrid-orchestrator

用途

Apple Xcode Hybrid Orchestrator 是处理 Apple 与 Swift 任务的入口技能，用于在 Xcode MCP 与官方命令行工具之间编排开发工作流。其核心策略是「Xcode MCP 优先，受阻时自动回退到官方 Apple 与 Swift CLI 工具」。

意图分类：将任务归入以下类别之一——会话/工作区、读取/搜索、构建/测试/运行、打包/工具链、文档查询、变更请求。
执行路由：优先使用 $xcode-mcp-first-executor 处理 Xcode MCP 支持的任何操作；当 MCP 不可用、超时或缺少所需能力时，立即移交给 $apple-swift-cli-fallback。
文档策略：使用 $apple-dev-safety-and-docs 进行 Dash 本地优先的文档路由，并处理建议冷却（advisory cooldown）。
变更安全：若请求可能触及 Xcode 管理的范围，在任何直接文件系统回退之前，需通过 $apple-dev-safety-and-docs 的硬性两步同意门。

该技能作为 Apple 与 Swift 任务的入口点使用，按上述工作流进行分类与路由。

先加载当前生效的自定义设置：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。

references/customization-flow.md 中包含技能专属配置项、文件映射、护栏、校验检查与示例请求。

适用于需要编排 Apple 与 Swift 开发工作流的任务，尤其是希望优先通过 Xcode MCP 执行、并在其不可用时自动回退到官方 CLI 工具链的场景。