用途：作为在 Xcode 环境内或周边进行 Apple 与 Swift 开发的顶层入口，指导代理侧工具使用，并应用共享的 simplicity-first Swift 策略；scripts/run_workflow.py 负责本地策略、变更防护、冷却、文档路由与结构化回退规划。
适用：Xcode 工作区检查、读取搜索、诊断、构建、测试与运行；Swift 工具链检查与官方 Apple CLI 回退；Apple/Swift 文档请求（优先 Dash 本地源再官方网页）；可能需要在 Xcode 管理范围内直接改文件时。若任务变为 Dash 文档集搜索/安装/生成，改推荐 apple-dash-docsets；若需新建 Swift 包，改推荐 apple-swift-package-bootstrap。
流程：先将请求归类为工作区/会话检查、读取搜索诊断、构建测试运行、包或工具链管理、文档查询、变更之一。任何设计、架构、实现或重构建议前先过 Apple 文档闸门：先读相关 Apple 文档，优先 Dash 或 Xcode 本地文档，再考虑官方文档；说明所依赖的已记录 API 行为、生命周期规则或工作流要求；文档与现有代码冲突时停止并报告；找不到相关文档时须明确说明。实现建议前应用共享 Swift 策略（references/snippets/apple-swift-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、docs_query（文档操作必填）、filesystem_fallback_opt_in。默认：运行时入口 scripts/run_workflow.py；代理侧 MCP 对瞬时失败重试一次；咨询冷却 21 天；文档源顺序 dash-mcp、dash-local、official-web；Xcode 管理范围内的变更操作需显式防护。
输出：status（success/blocked/handoff）、path_type（primary/fallback）、output（操作类型、guard_result、docs_route、fallback_commands、咨询状态、下一步或移交负载）。
防护与停止：仅在变更操作时应用 references/mutation-risk-policy.md 的变更防护，Xcode 管理范围内的直接文件编辑不得跳过；工作区上下文无法解析且不能安全继续、allowlist 或沙箱规则阻止官方 CLI 回退且无安全替代、文档操作缺 docs_query 时，均以 blocked 停止。回退：代理侧 MCP 无法完成时，官方 CLI 是唯一回退路径；参考 mcp-failure-handoff.md、allowlist-guidance.md、dash-docs-flow.md。MCP 执行本身仍在代理侧进行，不由本地运行时入口执行。自定义见 references/customization-flow.md 与 scripts/customization_config.py，运行时由 scripts/run_workflow.py 加载并强制执行。脚本清单：run_workflow.py、advisory_cooldown.py、detect_xcode_managed_scope.sh、customization_config.py。具体命令与配置细节资料中暂未提供。