技能

技能是用于执行复杂、多步骤 Tuist 任务的预构建指令集。无需手动引导代理完成迁移或设置流程，只需安装相应技能，即可让代理自动处理。

如果你的编码代理支持插件，Tuist 插件会一并安装这些技能和托管的 Model Context Protocol 服务器。

可用技能#

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

安装#

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

安装所有技能#

bash

npx skills add tuist/agent-skills

交互式提示允许你选择要为其安装哪些技能和代理。

安装特定技能#

bash

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

为特定代理安装#

bash

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

全局安装#

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

bash

npx skills add tuist/agent-skills -g

更新技能#

bash

npx skills update

非交互式（CI）#

bash

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

手动安装#

如果你不想使用 skills CLI，可以直接下载 SKILL.md 文件。设置所需技能的变量，并为你的代理运行 curl 命令：

bash

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

bash

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

bash

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

bash

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

bash

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