Skills

Skills

Skills 是用于执行复杂多步骤 Tuist 任务的预构建指令集。你无需手动引导代理完成迁移或设置过程，而是安装一个 skill 并让代理来处理。

可用的 skills

Skill	描述
migrate	将现有 Xcode 项目迁移到 Tuist 生成的 workspace，包含构建和运行验证、外部依赖映射和迁移清单。
generated-projects	指导在 Tuist 生成的 workspace 中的日常工作：生成、构建/测试命令和可构建文件夹。
fix-flaky-tests	通过分析 Tuist 测试洞察的失败模式、识别根本原因并应用针对性修复来修复 flaky 测试。
debug-generated-project	通过复现场景、必要时从源代码构建 Tuist 并分类判断是 bug、配置错误还是需要团队输入的问题，来调试 Tuist 生成项目的问题。
compare-gradle-builds	比较两次 Gradle 构建运行以识别持续时间回归、缓存变化和任务结果差异。可使用构建 ID、仪表板 URL 或分支名称调用。

安装 {#installation}

安装 Tuist skills 的推荐方式是使用 skills CLI。它会自动检测你的编码代理并将 SKILL.md 文件放置在正确的位置。

安装所有 skills

npx skills add tuist/agent-skills

交互式提示让你选择要为其安装的 skills 和代理。

安装特定的 skill

npx skills add tuist/agent-skills --skill migrate

为特定代理安装

npx skills add tuist/agent-skills -a claude-code

全局安装

添加 -g 标志将 skills 安装到你的主目录，以便在所有项目中可用：

npx skills add tuist/agent-skills -g

更新 skills

npx skills update

非交互式（CI）

npx skills add tuist/agent-skills --all -y

手动安装 {#manual}

如果你更喜欢不使用 skills CLI，可以直接下载 SKILL.md 文件。为你想要的 skill 设置变量，然后为你的代理运行 curl 命令：

SKILL_NAME=tuist-migrate          # 或 tuist-generated-projects
SKILL_URL=https://tuist.dev/skills/migrate/SKILL.md  # 或 .../generated-projects/SKILL.md

::: code-group

mkdir -p .claude/skills/$SKILL_NAME
curl -o .claude/skills/$SKILL_NAME/SKILL.md $SKILL_URL

mkdir -p .codex/skills/$SKILL_NAME
curl -o .codex/skills/$SKILL_NAME/SKILL.md $SKILL_URL

mkdir -p .agents/skills/$SKILL_NAME
curl -o .agents/skills/$SKILL_NAME/SKILL.md $SKILL_URL

mkdir -p .opencode/skills/$SKILL_NAME
curl -o .opencode/skills/$SKILL_NAME/SKILL.md $SKILL_URL

:::