Agent Skills
› fanfan-de/anybox
› swiftpm-macos
swiftpm-macos
GitHub用于在 macOS 上通过 SwiftPM 构建、运行和测试 Swift 包。适用于以 Package.swift 为主入口或无 Xcode 项目的场景，涵盖包检查、构建执行、窄范围测试及失败分析，优先于 Xcode 使用。
Trigger Scenarios
用户需要在 macOS 上构建或运行 Swift 包
仓库包含 Package.swift 且无 Xcode 项目
需要快速复现 Swift 包构建结果
Install
npx skills add fanfan-de/anybox --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
- 08dc189 Current 2026-07-05 18:55
