Configurador Mise

Visão Geral

Esta habilidade gera configurações de mise.toml limpas e prontas para produção para ambientes de desenvolvimento local e pipelines de CI/CD.

Ela ajuda a padronizar versões de runtime, simplificar a integração, substituir gerenciadores de versão legados como asdf, nvm e pyenv, e criar ambientes multilíngues reproduzíveis com esforço mínimo de configuração.

Quando Usar Esta Habilidade

• Use quando precisar criar ou atualizar um mise.toml
• Use ao trabalhar com Node.js, Python, Go, Rust, Java, Bun, Terraform ou stacks mistos
• Use quando o usuário perguntar sobre configuração de runtime de CI/CD usando mise
• Use ao migrar de .tool-versions, asdf, nvm ou pyenv
• Use ao padronizar versões de ferramentas entre equipes ou monorepos

Como Funciona

Passo 1: Detectar Contexto do Projeto

Inspecione os arquivos do repositório disponíveis, como:

• package.json
• pnpm-lock.yaml
• pyproject.toml
• requirements.txt
• go.mod
• Cargo.toml
• .tool-versions
• Dockerfile
• Arquivos do GitHub Actions ou de CI

Inferir linguagens, gerenciadores de pacotes e versões fixadas.

Passo 2: Gerar mise.toml

Crie uma configuração mínima, válida e pronta para copiar e colar usando:

• Versões fixadas existentes quando encontradas
• Versões de destino explícitas fornecidas pelo usuário quando ausentes
• Padrões práticos para produtividade do desenvolvedor
• Versões fixadas concretas em configurações de produção compartilhadas

Passo 3: Adicionar Comandos de Bootstrap

Forneça comandos de configuração, como:

mise trust
mise install

Passo 4: Gerar Integração de CI/CD

Se solicitado, gere exemplos de pipeline usando mise com cache e instalação de runtime.

Exemplos

Exemplo 1: Projeto Node.js + pnpm

[tools]
node = "22.11.0"
pnpm = "9.15.0"

Exemplo 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

Melhores Práticas

• ✅ Respeite as versões já fixadas no repositório

• ✅ Mantenha as configurações mínimas e legíveis

• ✅ Prefira lançamentos de runtime estáveis

• ✅ Gere exemplos de CI com cache

• ✅ Peça as versões de destino antes de fixar quando o repositório não as declara ainda

• ❌ Não use aliases flutuantes de latest ou lts em configurações de produção compartilhadas, a menos que explicitamente solicitado

• ❌ Não crie entradas de ferramentas desnecessárias em excesso

• ❌ Não ignore arquivos de lock ou de versão existentes

Limitações

• Esta habilidade não substitui a validação específica do ambiente, testes ou revisão de especialistas.

• Pare e peça esclarecimentos se os inputs, permissões ou limites de segurança necessários estiverem faltando.

• A disponibilidade do runtime pode variar por OS, shell ou plataforma de CI.

• Alguns plugins ou ferramentas de nicho podem exigir ajustes manuais.

Notas de Segurança e Proteção

• Revise os comandos de shell gerados antes da execução.

• Confirme as permissões de CI/CD antes de modificar pipelines.

• Valide as versões de runtime contra os requisitos de produção.

• Use apenas em repositórios e ambientes autorizados.

Armadilhas Comuns

• Problema: Versão de runtime incorreta selecionada
  Solução: Verifique os arquivos de lock do repositório e as versões fixadas primeiro.

• Problema: Instalações de CI são lentas
  Solução: Habilite camadas de cache e reutilize diretórios de cache do mise.

• Problema: Ferramenta ausente do registro
  Solução: Verifique o suporte do plugin ou instale manualmente.

Habilidades Relacionadas

• @docker-expert - Use ao construir ambientes de desenvolvimento em contêineres

• @github-actions-templates - Use para automação avançada de fluxo de trabalho

• @monorepo-architect - Use para repositórios grandes com múltiplos pacotes