技能

技能係預先建立嘅指令集，用嚟執行複雜、多步驟嘅 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

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