用途：为 macOS 项目建立统一的构建/运行/调试入口，用一个项目内脚本负责停止旧进程、构建并启动应用，适合诊断构建、启动或运行时故障。
主要能力：优先使用 shell 工作流，以 ./script/build_and_run.sh 作为单一「kill + build + run」入口；Xcode 工作区或工程用 xcodebuild；纯 SwiftPM 命令行工具用 swift build 后直接启动可执行文件；SwiftPM 的 AppKit/SwiftUI GUI 应用则构建后暂存为项目内 .app bundle 并用 /usr/bin/open -n 启动。脚本支持可选参数：--debug（lldb 调试）、--logs（流式输出进程日志）、--telemetry（过滤应用子系统的统一日志）、--verify（用 pgrep -x 确认进程存在）。可写入 .codex/environments/environment.toml，让 Codex 应用显示与脚本绑定的 Run 按钮，该文件应放在 .codex/environments/environment.toml，脚本放在 script/build_and_run.sh，不要在脚本缺失前写环境文件或指向过期路径。
工作流：先用 find 检查 .xcworkspace、.xcodeproj、Package.swift，判断项目类型并确认默认可运行目标与进程名；用 xcodebuild -list 列出 scheme。若当前工作区不在 git 仓库内，先在项目根执行 git init，但不要嵌套子目录执行。GUI 应用不应直接以原始可执行文件启动，否则可能出现无 Dock 图标、无前台激活或缺少 bundle identifier 警告。
限制：不应假定模拟器、触屏交互或移动端工具链；不要声称无法检查的 UI 状态；构建输出过大时只归纳首个真实阻塞点。若已提供 Xcode 感知的 MCP（如 XcodeBuildMCP），仅在适合时窄范围使用，不匹配时回退到 shell 命令。具体脚本内容与命令细节以资料中 references/run-button-bootstrap.md 为准。安装命令、收费与平台支持等未在资料中明确说明的信息暂未提供。