Communitygithub.com

Moep90/agent-toolkit-for-kapitan

KI-Agent-Toolkit für Kapitan: Ein MCP-Server, Agenten-Fähigkeiten und Regeln, die LLM-Coding-Agenten das sichere Inspizieren, Kompilieren und Vergleichen von Kapitan-Projekten ermöglichen.

Was ist agent-toolkit-for-kapitan?

Dieses Toolkit ermöglicht es KI-gestützten Coding-Agenten (wie Claude Code, Cursor, Codex), Kapitan-Projekte sicher zu inspizieren, zu kompilieren und Unterschiede (Diffs) zu überprüfen. Es stellt einen MCP-Server (Model Context Protocol) sowie spezifische Agenten-Fähigkeiten und Regeln bereit, die den Agenten erlauben, Kapitan-Targets zu analysieren, Helm-Charts nativ zu rendern und den resultierenden kompilierten Output mit vorherigen Versionen zu vergleichen. Der Fokus liegt auf Sicherheit: Der Agent arbeitet in einer gelesenen und kontrollierten Umgebung, sodass er keine ungewollten Änderungen am Projekt vornimmt. Entwickler profitieren von einer klar definierten Schnittstelle, die die native Helm-Integration von Kapitan (input_type: helm) in zwei konsequente Hälften aufteilt – Abhängigkeits-Fetch und Kompilierung –, deren Werte über self-links (${<app>:key}) zentral definiert werden. Das Toolkit validiert gegen Kapitan 0.34–0.36 mit Helm 3 und erlaubt es Agenten, Änderungen an Chart-Versionen sicher durchzuführen, ohne die Dateien in compiled/ jemals von Hand bearbeiten zu müssen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Rendern von Helm-Charts mit Kapitan

Kapitan rendert Helm-Charts nativ mit input_type: helm. Sie deklarieren das Chart als Abhängigkeit (Kapitan lädt es herunter) und einen Kompilierungseintrag (Kapitan erstellt das Template mit Ihren Werten). Die gerenderten Manifeste landen in compiled/; Sie binden das Chart weder ein noch führen Sie helm selbst aus.

Zwei Hälften leben unter einem parameters.<app>-Block, die durch ${<app>:key}-Selbstverweise referenziert werden, sodass ein Wert nur einmal geschrieben wird.

Struktur

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}

Die zwei Hälften

  • Abhängigkeit (type: helm) lädt das Chart von source mit der version in den output_path. Sie wird nur ausgeführt, wenn das Abrufen aktiviert ist. Der erste Kompilierungsdurchlauf eines Ziels benötigt daher einen Abruf; spätere Kompilierungen verwenden das bereits abgerufene Chart erneut.
  • Kompilierung (input_type: helm) erstellt das Template mit dem abgerufenen Chart. helm_params.release_name und helm_params.namespace sind die Flags von helm template; helm_values ist das Werte-Dokument, das an das Chart übergeben wird.

Schlüsselvertrag

chart_name, chart_version, namespace und helm_values sind die von Ihnen gesetzten Werte; alles andere referenziert sie mit ${<app>:...}. Achten Sie darauf, dass chart_dir auf den Ort zeigt, wo die Abhängigkeit abgelegt wird, sonst erstellt der Kompilierungseintrag ein leeres Verzeichnis und gibt nichts aus.

Manche Inventare (insbesondere omegaconf-basierte) umhüllen diesen gesamten Block in einem benutzerdefinierten Resolver, sodass eine einzelne Zeile zu den Abhängigkeits- und Kompilierungseinträgen expandiert, was Charts duplizierbar macht. Der zugrunde liegende Vertrag bleibt dennoch die zwei oben genannten Hälften; siehe kapitan-omegaconf-resolvers für diesen Wiederverwendungsmechanismus.

Nach dem Bearbeiten

Kompilieren und einen Diff durchführen (kapitan_compile_diff), um die gerenderten Manifeste zu überprüfen. Ein Chart-Bump ist eine Änderung von chart_version gefolgt von einem erneuten Abruf, niemals eine manuelle Bearbeitung von compiled/.

Getestet mit

Kapitan 0.34 bis 0.36 mit Helm 3.

Verwandte Skills