Communitygithub.com

Moep90/agent-toolkit-for-kapitan

Kit de ferramentas de IA para Kapitan: um servidor MCP, habilidades de agente e regras que permitem que agentes de codificação LLM inspecionem, compilem e comparem projetos Kapitan com segurança.

O que é agent-toolkit-for-kapitan?

Este kit de ferramentas fornece integração entre agentes de IA (como Claude Code, Cursor, Codex) e o Kapitan, um gerenciador de configuração para Kubernetes. Ele permite que agentes de codificação LLM inspecionem projetos Kapitan, compilem templates (incluindo Helm charts de forma nativa) e realizem diffs seguros entre compilações, sem modificar diretamente os diretórios `compiled/`. O recurso principal documentado (SKILL.md) detalha como renderizar Helm charts usando Kapitan, dividindo o processo em duas metades: uma dependência (`type: helm`) que baixa o chart, e uma entrada de compilação (`input_type: helm`) que aplica os valores e gera os manifestos. O kit suporta as plataformas Claude Code, Cursor e Codex, e utiliza o protocolo MCP para comunicação entre o agente e o ambiente Kapitan. A estrutura promove reutilização via auto-referências (self-links) `${<app>:key}` e é validada com Kapitan 0.34-0.36 e Helm 3.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Moep90/agent-toolkit-for-kapitan

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Renderizando Helm charts com Kapitan

Kapitan renderiza Helm charts nativamente com input_type: helm. Você declara o chart como uma dependência (Kapitan o busca) e uma entrada de compilação (Kapitan o templateia com seus valores). Os manifestos renderizados vão para compiled/; você nunca faz vendor do chart nem executa helm manualmente.

Duas metades vivem sob um único bloco parameters.<app>, referenciadas por auto-links ${<app>:key} para que um valor seja escrito uma única vez.

Estrutura

parameters:
  cert-manager:
    chart_name: cert-manager
    chart_version: "v1.4.0"
    chart_dir: system/sources/charts/${cert-manager:chart_name}
    application_version: "v1.4.0"
    namespace: ${namespace}
    helm_values:
      installCRDs: true
      prometheus:
        enabled: true
  kapitan:
    dependencies:
      - type: helm
        output_path: ${cert-manager:chart_dir}
        source: https://charts.jetstack.io/
        version: ${cert-manager:chart_version}
        chart_name: ${cert-manager:chart_name}
    compile:
      - input_type: helm
        input_paths:
          - ${cert-manager:chart_dir}
        output_path: .
        helm_params:
          namespace: ${cert-manager:namespace}
          release_name: ${cert-manager:chart_name}
        helm_values: ${cert-manager:helm_values}

As duas metades

  • Dependência (type: helm) baixa o chart de source na version para output_path. Só é executada quando a busca está habilitada, portanto a primeira compilação de um target precisa de uma busca; compilações posteriores reutilizam o chart baixado.
  • Compilação (input_type: helm) templateia o chart baixado. helm_params.release_name e helm_params.namespace são as flags do helm template; helm_values é o documento de valores passado para o chart.

Contrato principal

chart_name, chart_version, namespace e helm_values são os valores que você define; todo o resto os referencia com ${<app>:...}. Mantenha chart_dir apontando para onde a dependência baixa o chart, ou a entrada de compilação templateia um diretório vazio e não emite nada.

Alguns inventários (especialmente os baseados em omegaconf) envolvem todo esse bloco em um resolver personalizado, de modo que uma única linha expande para as entradas de dependência e compilação, tornando os charts duplicáveis. O contrato subjacente ainda são as duas metades acima; consulte kapitan-omegaconf-resolvers para esse mecanismo de reutilização.

Após editar

Compile e faça diff (kapitan_compile_diff) para revisar os manifestos renderizados. Um bump de chart é uma alteração em chart_version seguida de uma nova busca, nunca uma edição manual de compiled/.

Validado contra

Kapitan 0.34 até 0.36 com Helm 3.

Habilidades Relacionadas