Agent Skills
› openai/plugins
› swiftpm-macos
swiftpm-macos
GitHub用于在 macOS 上使用 Swift Package Manager 构建、运行和测试 SwiftPM 包。适用于以 Package.swift 为主入口或无 Xcode 项目的场景，指导检查包结构、执行编译运行测试及分析失败原因。
Trigger Scenarios
用户需要构建 SwiftPM 包
用户需要在没有 Xcode 的情况下运行 Swift 可执行文件
用户希望使用 SwiftPM 进行快速重现或测试
Install
npx skills add openai/plugins --skill swiftpm-macos -g -y
SKILL.md
Frontmatter
{
"name": "swiftpm-macos",
"description": "Build, run, and test SwiftPM macOS packages and executables. Use when the repo is package-first or has no Xcode project."
}
SwiftPM for macOS
Quick Start
Use this skill when Package.swift is the primary entrypoint or when SwiftPM is
the fastest path to a reproducible result.
Workflow
-
Inspect the package.
- Read
Package.swift. - Identify executable, library, and test products.
- Read
-
Build with SwiftPM.
- Use
swift buildby default. - Use release mode only when the user explicitly needs it.
- Use
-
Run the right product.
- Use
swift run <product>when an executable exists. - If multiple executables exist, explain the default choice.
- Use
-
Test narrowly.
- Use
swift test. - Apply filters when a specific test target or case is known.
- Use
-
Summarize failures.
- Module/import resolution
- Package graph or dependency issue
- Linker failure
- Runtime failure
- Test regression
Guardrails
- Prefer SwiftPM over Xcode when both exist and the package path is clearly simpler.
- Do not assume an app bundle exists in a pure package workflow.
- Explain when the package is library-only and therefore not directly runnable.
Output Expectations
Provide:
- the package products you found
- the command you ran
- whether build, run, or test succeeded
- the top blocker if not
Version History
- 11c74d6 Current 2026-07-19 09:29
