macOS 构建运行调试
给一个 Xcode 或 SwiftPM 的 macOS 项目,生成一键构建运行脚本并排查构建、启动、运行失败。
功能与用途
macOS 项目每次改完都要手动停进程、重新构建、找到产物路径再启动,中间一步错了就白等。这个能力在项目里落一个 build_and_run.sh,把停旧进程、构建、启动合成一条命令,还带调试器、日志流、遥测和进程校验几个开关,同时配好 Codex 的 Run 按钮。出问题时它会按编译器、链接器、签名、工具链等类别给出首要阻塞点,而不是甩一大段构建输出。
适用场景
- 每次改代码都要手动切到终端停进程、构建、再找产物启动,一天重:每次改代码都要手动切到终端停进程、构建、再找产物启动,一天重复几十遍
- SwiftPM 写的 SwiftUI 应用直接跑可执行文件,:SwiftPM 写的 SwiftUI 应用直接跑可执行文件,结果没有 Dock 图标也不激活到前台
- 应用构建成功但启动就退,需要看配置、权限和沙盒相关的日志而不:应用构建成功但启动就退,需要看配置、权限和沙盒相关的日志而不是瞎猜
适用人群
- 做 macOS 桌面应用的 Swift 开发者
- 维护 Xcode 工程的独立应用开发者
- 从 iOS 转向 macOS 开发需要重配工具链的工程师
使用步骤
- 把 macOS 项目交给它,系统先探查是 Xcode 工作区还是 SwiftPM 工程,并确认可运行目标。
- 生成项目内的 script/build_and_run.sh,把停进程、构建、启动三步固定下来。
- 按需启用 --debug、--logs、--telemetry、--verify 开关做调试或进程校验。
- 写入 .codex/environments/environment.toml,让 Codex 应用里出现直接可点的 Run 按钮。
- 遇到失败时拿到分类后的首要阻塞点和最小的下一步动作。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Build, run, and debug macOS apps with shell-first Xcode and Swift workflows. Use when launching apps or diagnosing build, startup, or runtime failures.
使用前准备
- 需要 macOS 系统与 Xcode/Swift 工具链
- 项目需为 Xcode 工作区/工程或 SwiftPM 工程
依赖与权限
- 读取用户主动提供的内容