技能

技能是預先建置的指令集，用於執行複雜、多步驟的 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