---

name: mise-configurator description: "生成生产级 mise.toml 配置，用于本地开发、CI/CD 流水线和工具链标准化。" category: devops risk: safe source: self source_type: self date_added: "2026-04-16" author: community tags: [mise, devops, ci-cd, toolchain, runtimes, automation] tools: [claude, cursor, gemini]

Mise 配置生成器

概述

此技能用于生成简洁、生产级的 mise.toml 配置文件，适用于本地开发环境和 CI/CD 流水线。

它帮助标准化运行时版本、简化新成员入职流程、替代 asdf、nvm 和 pyenv 等旧版版本管理器，并以最少的配置工作创建可复现的多语言开发环境。

何时使用此技能

• 需要创建或更新 mise.toml 时使用
• 使用 Node.js、Python、Go、Rust、Java、Bun、Terraform 或混合技术栈时使用
• 用户询问使用 mise 进行 CI/CD 运行时配置时使用
• 从 .tool-versions、asdf、nvm 或 pyenv 迁移时使用
• 需要在团队或 monorepo 中统一工具版本时使用

工作原理

第一步：检测项目上下文

检查仓库中的相关文件，例如：

• package.json
• pnpm-lock.yaml
• pyproject.toml
• requirements.txt
• go.mod
• Cargo.toml
• .tool-versions
• Dockerfile
• GitHub Actions 或 CI 配置文件

推断使用的语言、包管理器和固定版本。

第二步：生成 mise.toml

创建最小化、有效、可直接复制使用的配置，遵循以下原则：

• 优先使用已有的固定版本
• 缺少版本时使用用户明确指定的目标版本
• 采用提升开发效率的实用默认值
• 在共享生产配置中使用具体的固定版本

第三步：添加引导命令

提供如下设置命令：

mise trust
mise install

第四步：生成 CI/CD 集成配置

如有需要，生成包含缓存和运行时安装的流水线示例。

示例

示例 1：Node.js + pnpm 项目

[tools]
node = 22.11.0
pnpm = 9.15.0

示例 2：Python + GitHub Actions

[tools]
python = 3.12.7
poetry = 1.8.4

steps:
  - uses: actions/checkout@v4
  - uses: jdx/mise-action@v2
  - run: poetry install
  - run: pytest

最佳实践

• 尊重仓库中已固定的版本

• 保持配置最小化且易读

• 优先使用稳定的运行时版本

• 生成带缓存的 CI 示例

• 在仓库未声明版本时，先询问目标版本再固定

• 不要在共享生产配置中使用浮动的 latest 或 lts 别名（除非明确要求）

• 不要过度设计不必要的工具条目

• 不要忽略已有的锁文件或版本文件

局限性

• 此技能不能替代特定环境的验证、测试或专家审查。

• 如果缺少必要的输入、权限或安全边界，应停下来请求澄清。

• 运行时可用性可能因操作系统、Shell 或 CI 平台而异。

• 某些插件或小众工具可能需要手动调整。

安全注意事项

• 执行前请审查生成的 Shell 命令。

• 修改流水线前确认 CI/CD 权限。

• 根据生产要求验证运行时版本。

• 仅在授权的仓库和环境中使用。

常见问题

• 问题： 选择了错误的运行时版本 解决方案： 先检查仓库的锁文件和固定版本。

• 问题： CI 安装速度慢 解决方案： 启用缓存层并复用 mise 缓存目录。

• 问题： 工具不在注册表中 解决方案： 验证插件支持或手动安装。

相关技能

• @docker-expert - 构建容器化开发环境时使用

• @github-actions-templates - 高级工作流自动化时使用

• @monorepo-architect - 大型多包仓库时使用