Agent Skills › robinebers/openusage › macos-swiftpm

macos-swiftpm

GitHub

指导在macOS上使用Swift Package Manager构建、运行和测试Swift包。适用于无Xcode项目或Package.swift为主入口的场景，涵盖构建、执行及测试流程与故障排查。

.agents/skills/macos-swiftpm/SKILL.md robinebers/openusage

Trigger Scenarios

需要构建SwiftPM包需要运行Swift可执行文件需要运行Swift测试

Install

npx skills add robinebers/openusage --skill macos-swiftpm -g -y

More Options

Non-standard path

npx skills add https://github.com/robinebers/openusage/tree/main/.agents/skills/macos-swiftpm -g -y

Use without installing

npx skills use robinebers/openusage@macos-swiftpm

指定 Agent (Claude Code)

npx skills add robinebers/openusage --skill macos-swiftpm -a claude-code -g -y

安装 repo 全部 skill

npx skills add robinebers/openusage --all -g -y

预览 repo 内 skill

npx skills add robinebers/openusage --list

SKILL.md

Frontmatter

{
    "name": "macos-swiftpm",
    "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.
Build with SwiftPM.
- Use swift build by default.
- Use release mode only when the user explicitly needs it.
Run the right product.
- Use swift run <product> when an executable exists.
- If multiple executables exist, explain the default choice.
Test narrowly.
- Use swift test.
- Apply filters when a specific test target or case is known.
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.