用途:向现有的或新建的 Xcode 项目安装一套精简的 Makefile 与脚本,用统一的 make 命令完成构建、运行与测试,并支持多智能体/多任务并行时的产物隔离。
主要能力:以 AGENT_NAME 作为唯一智能体环境变量,按智能体将路径隔离到 build/ 下:build/DerivedData/<AGENT_NAME>、build/logs/<AGENT_NAME>、build/cache/<AGENT_NAME>、build/tmp/<AGENT_NAME>。安装后包含脚本:scripts/atomic_commit.sh、scripts/xcbuild.sh、scripts/resolve_agent_name.sh、scripts/resolve_sim_destination.sh、scripts/diagnose.sh、scripts/run_app_macos.sh、scripts/run_app_ios_sim.sh、scripts/clean.sh、scripts/move_to_trash.sh。提供的 Make 目标刻意保持最小:make diagnose、make build、make test、make run、make build-and-run、make build-and-run-background、make clean、make agent-verify。
使用方式:运行安装脚本,例如 skills/xcode-makefiles/scripts/install.sh --project-dir /path/to/project --app-name WalkTrack --platform ios。通用参数:--project-dir PATH 必填;--mode install|upgrade 默认 install;--dry-run 仅预览变更。工具集参数:--app-name NAME 必填;--platform ios|macos 必填;--sim-name NAME 可选,iOS 下默认自动;--namespace NAME 可选,安装 Makefile.NAME 与 scripts/NAME/。
适用场景:iOS/macOS 项目需要一致的命令行构建、运行、测试流程,或需要不同智能体各自独立的 DerivedData、日志、缓存与临时目录以避免互相干扰。
限制:资料未提供更多版本兼容、依赖要求、错误处理与平台限制说明;文档中的具体项目路径、应用名和平台需按实际替换。