技能
技能是用于执行复杂、多步骤 Tuist 任务的预构建指令集。无需手动引导智能体完成迁移或设置流程,你只需安装一个技能,让智能体自行处理。
如果你的编码智能体支持插件,Tuist 插件会同时安装这些技能和托管的 Model Context Protocol 服务器。
可用技能#
| 技能 | 描述 |
|---|---|
migrate |
将现有 Xcode 项目迁移到 Tuist 生成的工作区,包括构建和运行验证、外部依赖映射以及迁移清单。 |
generated-projects |
指导在 Tuist 生成工作区中的日常工作:生成、构建/测试命令以及可构建文件夹。 |
fix-flaky-tests |
通过分析 Tuist 测试洞察中的失败模式、识别根本原因并应用针对性修复,来修复不稳定测试。 |
debug-generated-project |
通过重现场景、在需要时从源代码构建 Tuist,并判断问题是 bug、配置错误还是需要团队介入,来调试 Tuist 生成项目的问题。 |
compare-gradle-builds |
比较两次 Gradle 构建运行,以识别耗时回归、缓存变化和任务结果差异。可以通过构建 ID、仪表板 URL 或分支名称调用。 |
安装#
安装 Tuist 技能的推荐方式是使用 skills CLI。它会自动检测你的编码智能体,并将 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
mkdir -p .claude/skills/$SKILL_NAME
curl -o .claude/skills/$SKILL_NAME/SKILL.md $SKILL_URL
mkdir -p .claude/skills/$SKILL_NAME
curl -o .claude/skills/$SKILL_NAME/SKILL.md $SKILL_URL
bash
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 .codex/skills/$SKILL_NAME
curl -o .codex/skills/$SKILL_NAME/SKILL.md $SKILL_URL
bash
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 .agents/skills/$SKILL_NAME
curl -o .agents/skills/$SKILL_NAME/SKILL.md $SKILL_URL
bash
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
mkdir -p .opencode/skills/$SKILL_NAME
curl -o .opencode/skills/$SKILL_NAME/SKILL.md $SKILL_URL
bash
mkdir -p .opencode/skills/$SKILL_NAME
curl -o .opencode/skills/$SKILL_NAME/SKILL.md $SKILL_URL