Agent Skills
› openai/plugins
› swiftpm-macos
swiftpm-macos
GitHub用于在 macOS 环境下通过 SwiftPM 构建、运行和测试 Swift 包。适用于无 Xcode 项目或 Package.swift 为主要入口的场景，涵盖包检查、编译执行、窄范围测试及失败原因总结。
触发场景
需要构建 Swift 包时
需要运行 Swift 可执行文件时
需要测试 Swift 包时
仓库无 Xcode 项目仅含 Package.swift
安装
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
版本历史
- 11c74d6 当前 2026-07-19 09:29
