Communitygithub.com

Moep90/agent-toolkit-for-kapitan

Kit de herramientas para agentes de IA destinado a Kapitan: un servidor MCP, habilidades de agente y reglas que permiten a los agentes de codificación de LLM inspeccionar, compilar y comparar proyectos Kapitan de forma segura.

¿Qué es agent-toolkit-for-kapitan?

Este skill proporciona a agentes de codificación de IA (como Claude Code, Cursor o Codex) las instrucciones necesarias para trabajar con Kapitan, una herramienta de configuración y plantillas. El skill incluye un servidor MCP (Model Context Protocol), habilidades de agente y reglas que guían al LLM para inspeccionar, compilar y generar diffs de proyectos Kapitan de manera segura. Está diseñado para plataformas que soportan MCP o la ejecución de scripts definidos en skills. La funcionalidad principal se centra en el renderizado nativo de charts de Helm a través de Kapitan, explicando la estructura de dos mitades (dependencia y compilación) y el contrato clave que las une. Permite a los agentes modificar valores como `chart_version` y ejecutar `kapitan_compile_diff` para revisar los manifiestos renderizados, evitando la edición manual de archivos compilados. El skill ha sido validado con Kapitan 0.34 a 0.36 y Helm 3.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Renderizado de charts de Helm con Kapitan

Kapitan renderiza charts de Helm de forma nativa con input_type: helm. Declaras el chart como una dependencia (Kapitan lo obtiene) y una entrada de compilación (Kapitan lo plantilla con tus valores). Los manifiestos renderizados terminan en compiled/; nunca añades el chart manualmente ni ejecutas helm tú mismo.

Dos mitades viven bajo un mismo bloque parameters.<app>, referenciadas mediante autoenlaces ${<app>:key} para que un valor se escriba una sola vez.

Forma

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}

Las dos mitades

  • Dependencia (type: helm) obtiene el chart desde source en la version hacia output_path. Solo se ejecuta cuando la obtención está habilitada, por lo que la primera compilación de un objetivo necesita una obtención; las compilaciones posteriores reutilizan el chart obtenido.
  • Compilación (input_type: helm) plantilla el chart obtenido. helm_params.release_name y helm_params.namespace son las banderas de helm template; helm_values es el documento de valores pasado al chart.

Contrato clave

chart_name, chart_version, namespace y helm_values son los valores que tú estableces; todo lo demás los referencia con ${<app>:...}. Mantén chart_dir apuntando a donde la dependencia obtiene los archivos, o la entrada de compilación plantillará un directorio vacío y no emitirá nada.

Algunos inventarios (especialmente los de omegaconf) envuelven todo este bloque en un resolvedor personalizado para que una sola línea se expanda a las entradas de dependencia y compilación, lo que hace que los charts sean duplicables. El contrato subyacente sigue siendo las dos mitades anteriores; consulta kapitan-omegaconf-resolvers para ese mecanismo de reutilización.

Después de editar

Compila y haz diff (kapitan_compile_diff) para revisar los manifiestos renderizados. Un cambio de versión de chart es una modificación de chart_version más una reobtención, nunca una edición manual de compiled/.

Validado con

Kapitan 0.34 a 0.36 con Helm 3.

Skills relacionados