用途:当 Package.swift 是主要入口,或 SwiftPM 是获得可复现结果的最快路径时使用本技能,处理 macOS 上的 SwiftPM 包与可执行文件。
主要能力与工作流:先检查包,阅读 Package.swift,识别可执行、库和测试产品;默认用 swift build 构建,仅在用户明确需要时使用 release 模式;存在可执行产品时用 swift run <product> 运行,若有多个可执行文件需说明默认选择;用 swift test 测试,已知具体测试目标或用例时应用过滤;失败时归纳类型,包括模块/导入解析、包图或依赖问题、链接器失败、运行时失败、测试回归。
使用方式:按上述命令执行构建、运行与测试,并输出发现的产品、运行的命令、构建/运行/测试是否成功,以及未成功时的首要阻塞点。
适用场景:包优先的仓库、无 Xcode 工程、需要可复现的 SwiftPM 结果。
限制与护栏:当 SwiftPM 与 Xcode 同时存在且包路径明显更简单时优先 SwiftPM;不要假设纯包工作流中存在 app bundle;当包仅为库、无法直接运行时需说明。