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

tusk-make-run

GitHub

用于在 Tusk macOS 项目中执行 make run 以构建并启动应用，或诊断构建与启动失败。捕获输出并评估结果，针对编译、链接、签名等常见错误提供具体分析和修复建议。

.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.