用途:在 macOS 上构建、运行并调试本地 App 或桌面可执行文件,采用 shell 优先的 Xcode 与 Swift 工作流。核心做法是先在项目内建立一个脚本入口 script/build_and_run.sh,之后以它作为默认的构建/运行路径。
主要能力:脚本统一完成“杀掉已有进程、构建、启动”三步;支持可选标志 --debug(在 lldb 下启动或附加调试器)、--logs(启动后流式输出进程日志)、--telemetry(按 App 子系统/分类过滤统一日志)、--verify(启动后用 pgrep -x <AppName> 确认进程存在)。构建可走 xcodebuild(工作区或项目),SwiftPM 命令行工具走 swift build 加原样可执行文件启动;SwiftPM 的 AppKit/SwiftUI GUI 应用则先构建产物,再生成项目内 dist/<AppName>.app 包(含最小 Info.plist),最后用 /usr/bin/open -n 启动。
使用方式:先发现项目形态,检查是否已在 git 仓库内(git rev-parse --is-inside-work-tree),无仓库则在根目录 git init;查找 .xcworkspace、.xcodeproj 与 Package.swift,存在多个候选时说明默认选择与歧义。解析可运行目标与进程名,Xcode 列出 schemes,SwiftPM 识别可执行产物。然后创建或更新可执行的 script/build_and_run.sh,默认无参数路径保持简单的 kill + build + run。项目发现可用 find . -name '.xcworkspace' -o -name '.xcodeproj' -o -name 'Package.swift',列出 scheme 可用 xcodebuild -list -workspace <workspace> 或 xcodebuild -list -project <project>。脚本形状以 references/build-script.md 为准。
适用场景与限制:仅面向 macOS,不适用于模拟器、触屏交互或移动专用工具链;不要把移动或模拟器工作流套用到 macOS 任务。SwiftUI/AppKit SwiftPM GUI 应用不应以原样可执行文件启动(可能导致无 Dock 图标、无前台激活、缺少 bundle 标识符警告),仅真正的命令行工具才用原样可执行文件启动。脚本放在 script/build_and_run.sh,不要放进 App/、Views/、Models/、Stores/、Services/ 或 Support/ 等应用源码目录。构建失败需正确归类为编译器、链接器、签名、构建设置、缺少 SDK/工具链、脚本 bug 或运行时启动,并引用最小有效错误片段。只有用户明确要求且已有 Xcode 感知的 MCP 可用时才窄范围使用它,否则立即回退到 shell 命令。其他未在资料中说明的事实暂未提供。