Agent Skills › Shape-Machine/tusk-macos › tusk-make-run

tusk-make-run

GitHub

用于构建并启动 Tusk macOS 应用，自动终止旧实例。若失败则诊断编译、链接、签名或环境配置等错误原因并提供修复建议，不自动执行修复操作。

.codex/skills/tusk-make-run/SKILL.md Shape-Machine/tusk-macos

Trigger Scenarios

用户要求运行 make run 需要构建并启动 Tusk 应用排查构建或启动失败问题

Install

npx skills add Shape-Machine/tusk-macos --skill tusk-make-run -g -y

More Options

Non-standard path

npx skills add https://github.com/Shape-Machine/tusk-macos/tree/main/.codex/skills/tusk-make-run -g -y

Use without installing

npx skills use Shape-Machine/tusk-macos@tusk-make-run

指定 Agent (Claude Code)

npx skills add Shape-Machine/tusk-macos --skill tusk-make-run -a claude-code -g -y

安装 repo 全部 skill

npx skills add Shape-Machine/tusk-macos --all -g -y

预览 repo 内 skill

npx skills add Shape-Machine/tusk-macos --list

SKILL.md

Frontmatter

{
    "name": "tusk-make-run",
    "description": "Use when the user asks to run `make run` for the Tusk macOS project, build and launch the app, or diagnose build and launch failures."
}

Tusk Make Run

Run make run to build and launch the Tusk app. This kills any running Tusk instance, builds the project, and opens the freshly built app.

Steps

1. Run

make run

Capture the full output.

2. Evaluate Result

If the command succeeds, ** BUILD SUCCEEDED ** appears, and the app opens, report success concisely.

If the command fails or produces errors:

Read the error output carefully.
Identify the root cause.
Present the user with a one-line summary, the specific error line or lines, and concrete recommended actions.

Common failure categories:

Compile errors: pinpoint the Swift or Objective-C file and line.
Linker errors: identify missing frameworks or libraries.
Code signing or provisioning errors: call out expired certificates, missing entitlements, or provisioning issues.
Missing generated files: project.yml may be out of sync and xcodegen generate may be needed.
Missing xcodebuild: Xcode may be absent or xcode-select may point to the wrong path.
App launch failure: the build succeeded but open failed due to the app path or sandbox state.