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 片段，以维持持续的工具可用性。