working-with-mise

working-with-mise 技能是使用 mise 管理多語言開發環境的完整工具組。它專為需要在專案基礎上切換不同語言運行環境、基礎設施工具和 CLI 版本的開發者設計。此技能協助維護一致的專案環境，確保 Node.js、Python、Ruby、Go、Terraform 和 Kubernetes CLI 等工具正確安裝並限定在專案目錄中。適用於經常遇到依賴衝突、環境啟動失敗或終端機「找不到指令」錯誤的軟體工程師與 DevOps 從業者。

• 自動偵測現有的設定檔格式（如 mise.toml、.mise.toml、.mise.local.toml 或舊版的 .tool-versions），以維持專案一致性。

• 使用 mise use CLI 驗證工具安裝與設定，確保語法準確與註冊表相容，無需手動編輯檔案。

• 對「找不到指令」問題進行深入診斷，包括檢查 .zshrc、.bashrc 或 config.fish 中的 Shell 啟動狀態，並使用 mise doctor 與 mise which 驗證路徑解析。

• 區分專案特定的版本需求與穩定的系統工具，提供何時使用 mise 或 Homebrew/系統套件的建議。

• 使用基於 shim 的啟動策略，解決非互動式 Shell 環境、IDE 終端機或背景腳本中的複雜啟動問題。

• 分析並協調全域設定與本地目錄覆寫之間的差異，確保執行正確的工具版本。

• 永遠優先使用 mise use 指令，而非直接手動編輯 TOML 檔案，以防止設定漂移與語法錯誤。

• 當排查指令為何使用系統版本而非預期的專案本地版本時，請使用此技能。

• 以 mise doctor 和 mise ls --current 作為環境隔離問題排查的主要參考輸入。

• 清楚區分臨時測試使用 (mise exec) 與永久環境設定之間的差異。

• 確保 Shell 設定檔包含適合使用者 Shell 環境（zsh、bash 或 fish）的 mise activate 片段，以維持持續的工具可用性。