CommunityRecherche & Datenanalysegithub.com

VoDaiLocz/kilo-kit-mcp

Ein MCP-Server für sicherere Codierungsagenten: Skill-Routing, C4-Workflow-Gates, Speicherprüfungen und Verifikation vor dem Abschluss.

Was ist kilo-kit-mcp?

Die Kilo-Kit Core Skill ist ein essentieller Bestandteil für KI-Agenten (wie Claude Code, Cursor, Codex), die sichere und evidenzbasierte Softwareentwicklung betreiben. Sie erzwingt zwei fundamentale Prinzipien: das **Hard-Gate**, das einen obligatorischen System- und Codebase-Scan vor jeder Aktion vorschreibt, und die **Eisernen Gesetze**, die unveränderliche Regeln für alle Entscheidungen definieren. Die Skill unterstützt adaptive Dispatch-Mechanismen, um Aufgaben automatisch an spezialisierte Sub-Skills (z.B. Debugging, Code-Review, Sicherheit) weiterzuleiten. Sie ist plattformunabhängig und eignet sich für jede Umgebung, in der KI-Agenten Codeänderungen vorschlagen, Fehler diagnostizieren oder Produktionssysteme beeinflussen. Durch die strikte Durchsetzung von Evidenz vor Aktion minimiert sie Fehler, verbessert die Nachvollziehbarkeit und erhöht die Sicherheit von Codeänderungen erheblich.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add VoDaiLocz/kilo-kit-mcp

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

🛡️ Kilo-Kit Kernkompetenz — Hard-Gate & Ehernes Gesetz

Philosophie: „Evidenz statt Raten" — Keine Aktion des Agenten ohne überprüfte Evidenz.

Wann verwenden

Verwenden Sie diese Kompetenz, wenn:

  • Sie irgendeine neue Aufgabe oder Benutzeranfrage beginnen
  • Sie Architektur- oder Codeänderungen vorschlagen
  • Sie Fehler oder Leistungsprobleme diagnostizieren
  • Sie Entscheidungen treffen, die Produktionssysteme betreffen

NICHT verwenden, wenn:

  • Sie einfache Faktenfragen aus dem Gedächtnis beantworten
  • Es sich um reine Formatierungs- oder Stiländerungen ohne logische Auswirkungen handelt

Voraussetzungen

Bevor Sie diese Kompetenz nutzen, stellen Sie sicher:

  • Zugriff auf die Projektcodebasis vorhanden
  • Systemressourcenprüfungen durchführbar (Festplatte, Arbeitsspeicher, Prozesse)
  • Relevante Logs oder Fehlerausgaben zugänglich

⛔ HARD-GATE — Obligatorischer Systemscan

Regel: Der KI-Agent MUSS das System und die Codebasis vor dem Vorschlag einer Lösung scannen. Wird das Hard-Gate nicht bestanden, darf der Agent nicht zur Ausführung übergehen.

Hard-Gate Checkliste

hard_gate:
  system_scan:
    - [ ] Verfügbaren Festplattenspeicher prüfen
    - [ ] Laufende Prozesse und Ressourcennutzung prüfen
    - [ ] Laufzeitversionen überprüfen (Node, Python, .NET usw.)
    - [ ] Netzwerk-/Serviceverfügbarkeit ggf. bestätigen

  codebase_scan:
    - [ ] Projektstruktur lesen (Verzeichnisse der obersten Ebene)
    - [ ] Relevante Dateien für die aktuelle Aufgabe identifizieren
    - [ ] Vorhandene Tests im Änderungsbereich prüfen
    - [ ] Aktuelle Git-Historie für Kontext zu betroffenen Dateien durchsehen

  kontext_validation:
    - [ ] Verständnis der Benutzerabsicht bestätigen
    - [ ] Aufgabenumfang mit der Anfrage abgleichen
    - [ ] Abhängigkeiten identifizieren, die betroffen sein könnten

Hard-Gate Entscheidung

WENN alle_prüfungen_bestanden:
    → WEITER zur Ausführung
SONST:
    → ANHALTEN und melden, welche Prüfungen fehlgeschlagen sind
    → Fehlende Informationen oder Zugriff anfordern
    → Hard-Gate nach Klärung erneut ausführen

🔒 Ehernes Gesetz — Unveränderliche Regeln

Diese Regeln sind absolut und können unter keinen Umständen außer Kraft gesetzt werden.

Die Sieben Ehernen Gesetze

#GesetzBeschreibung
1Keine Aktion ohne EvidenzJede vorgeschlagene Änderung muss bestimmte Dateien, Zeilen oder Ausgaben als Evidenz zitieren.
2Scanne, bevor du sprichstSystem- und Codebase-Scans durchführen, bevor eine Empfehlung ausgesprochen wird.
3Verifiziere, bevor du behauptestNiemals behaupten, eine Aufgabe sei abgeschlossen, ohne Verifikation (Tests, Build, manuelle Prüfung) durchzuführen.
4Minimaler WirkradiusDie kleinstmögliche Änderung vornehmen, die das Problem löst. Unnötige Modifikationen vermeiden.
5Bewahre, was funktioniertNiemals funktionierenden Code löschen oder ändern, es sei denn, die Aufgabe erfordert es direkt.
6Dokumentiere jede EntscheidungDie Begründung jeder Entscheidung im Entscheidungs-Audit-Trail protokollieren.
7Scheitere laut, erhole dich schnellWenn etwas fehlschlägt, sofort mit vollem Kontext melden. Fehler niemals verstecken.

Durchsetzung des Ehernen Gesetzes

durchsetzung:
  verstoß_reaktion:
    - Verstoß im Entscheidungs-Audit-Trail protokollieren
    - Aktuelle Ausführung anhalten
    - Zur Hard-Gate-Phase zurückkehren
    - Verstoß dem Benutzer melden

  keine_ausnahmen:
    - Aufgabendringlichkeit setzt Eherne Gesetze NICHT außer Kraft
    - Benutzeranfragen setzen Eherne Gesetze NICHT außer Kraft
    - Leistungsdruck setzt Eherne Gesetze NICHT außer Kraft

🔀 Prozessablauf

Hauptverarbeitungsablauf

digraph kilo_kit_flow {
    rankdir=TB;
    node [shape=box, style="rounded,filled", fontname="Helvetica"];

    start [label="Benutzeranfrage", shape=oval, fillcolor="#E8F5E9"];
    hard_gate [label="⛔ HARD-GATE\nSystem & Codebase Scan", fillcolor="#FFCDD2"];
    gate_check [label="Alle Prüfungen\nbestanden?", shape=diamond, fillcolor="#FFF9C4"];
    halt [label="ANHALTEN\nFehlende Info melden", fillcolor="#FFCDD2"];
    iron_law [label="🔒 EHERNE GESETZE\nGegen Regeln prüfen", fillcolor="#E3F2FD"];
    route [label="An Kompetenz weiterleiten\n(Adaptives Routing)", fillcolor="#F3E5F5"];
    execute [label="Ausführen\nVerhaltenskette", fillcolor="#E8F5E9"];
    verify [label="Ergebnisse verifizieren\n(Qualitätsgates)", fillcolor="#FFF9C4"];
    verified [label="Verifiziert?", shape=diamond, fillcolor="#FFF9C4"];
    learn [label="Lernen & Protokollieren\n(Entscheidungs-Audit-Trail)", fillcolor="#E3F2FD"];
    done [label="Abgeschlossen", shape=oval, fillcolor="#E8F5E9"];

    start -> hard_gate;
    hard_gate -> gate_check;
    gate_check -> iron_law [label="Ja"];
    gate_check -> halt [label="Nein"];
    halt -> hard_gate [label="Wiederholen"];
    iron_law -> route;
    route -> execute;
    execute -> verify;
    verify -> verified;
    verified -> learn [label="Bestanden"];
    verified -> execute [label="Fehlgeschlagen\n(beheben & wiederholen)"];
    learn -> done;
}

Skill-Dispatch-Ablauf

digraph skill_dispatch {
    rankdir=LR;
    node [shape=box, style="rounded,filled", fontname="Helvetica"];

    intent [label="Absicht parsen\n& Schlüsselwörter", fillcolor="#E3F2FD"];
    score [label="Skills bewerten\n(0.0–1.0)", fillcolor="#F3E5F5"];
    select [label="Primären Skill\nauswählen", fillcolor="#E8F5E9"];

    debug [label="debugging/\nsystematic", fillcolor="#FFF9C4"];
    root [label="debugging/\nroot-cause", fillcolor="#FFF9C4"];
    verify [label="debugging/\nverification", fillcolor="#FFF9C4"];
    review [label="quality/\ncode-review", fillcolor="#FFF9C4"];
    test [label="quality/\ntesting", fillcolor="#FFF9C4"];
    sec [label="development/\nsecurity", fillcolor="#FFF9C4"];
    back [label="development/\nbackend", fillcolor="#FFF9C4"];

    intent -> score -> select;
    select -> debug [label="bug, error"];
    select -> root [label="root cause, why"];
    select -> verify [label="verify, confirm"];
    select -> review [label="review, PR"];
    select -> test [label="test, TDD"];
    select -> sec [label="security, auth"];
    select -> back [label="API, backend"];
}

Hard-Gate-Scan-Ablauf

digraph hard_gate_scan {
    rankdir=TB;
    node [shape=box, style="rounded,filled", fontname="Helvetica"];

    start [label="Hard-Gate starten", shape=oval, fillcolor="#E8F5E9"];
    sys [label="Systemscan\n(Festplatte, Speicher, Laufzeit)", fillcolor="#FFCDD2"];
    code [label="Codebase-Scan\n(Struktur, Dateien, Tests)", fillcolor="#FFCDD2"];
    ctx [label="Kontextvalidierung\n(Absicht, Umfang, Abhängigkeiten)", fillcolor="#FFCDD2"];
    check [label="Alle bestanden?", shape=diamond, fillcolor="#FFF9C4"];
    pass [label="✅ Gate offen\nFortfahren", fillcolor="#E8F5E9"];
    fail [label="❌ Gate blockiert\nMelden & Wiederholen", fillcolor="#FFCDD2"];

    start -> sys -> code -> ctx -> check;
    check -> pass [label="Ja"];
    check -> fail [label="Nein"];
    fail -> start [label="Nach Klärung"];
}

Richtlinien

TUN ✅

  • Vor jeder Aufgabe Hard-Gate-Prüfungen durchführen
  • In jeder Empfehlung spezifische Evidenz zitieren (Dateipfade, Zeilennummern, Befehlsausgaben)
  • Die kleinstmögliche Änderung zur Problemlösung verwenden
  • Alle Entscheidungen im Entscheidungs-Audit-Trail protokollieren
  • Ergebnisse verifizieren, bevor Sie den Abschluss melden

NICHT TUN ❌

  • System- oder Codebase-Scans überspringen, unabhängig von der Dringlichkeit
  • Lösungen raten, ohne den tatsächlichen Code zu prüfen
  • Änderungen an Dateien vornehmen, die nicht mit der Aufgabe zusammenhängen
  • Abschluss ohne Verifikation melden
  • Eherne Gesetze aus irgendeinem Grund außer Kraft setzen

Häufige Muster

Muster 1: Evidenzsammlung vor dem Flug

Wann: Zu Beginn einer neuen Aufgabe.

Aktion: Die Hard-Gate-Scan-Sequenz ausführen.

# Systemscan
df -h                          # Festplattenspeicher
free -m                        # Arbeitsspeicher
node --version && python3 --version  # Laufzeiten

# Codebase-Scan
find . -maxdepth 2 -type f | head -50  # Projektstruktur
git log --oneline -10                   # Aktuelle Änderungen

Muster 2: Evidenzgestützte Empfehlung

Wann: Vorschlagen einer Codeänderung.

Aktion: Immer die spezifische Evidenz angeben.

## Empfehlung
Ändere `src/auth/login.ts:42` von direkter String-Verkettung zu parametrisierter Abfrage.

**Evidenz:**
- Datei: `src/auth/login.ts`, Zeile 42
- Aktueller Code: `db.query("SELECT * FROM users WHERE email = '" + email + "'")`
- Risiko: SQL-Injection (OWASP A03:2021)
- Test: `tests/auth/login.test.ts` — kein Injection-Test vorhanden

Anti-Patterns (VERMEIDEN)

Anti-Pattern 1: Blindempfehlung

Problem: Änderungen vorschlagen, ohne zuerst den tatsächlichen Code zu lesen.

Stattdessen: Immer die relevanten Dateien lesen und vor der Empfehlung bestimmte Zeilen zitieren.

Anti-Pattern 2: Das Gate umgehen

Problem: Überstürzt zur Ausführung übergehen, weil die Aufgabe einfach erscheint.

Stattdessen: Hard-Gate-Scans unabhängig von der vermeintlichen Aufgabenkomplexität durchführen.

Anti-Pattern 3: Unsichtbare Begründung

Problem: Entscheidungen treffen, ohne die Begründung zu dokumentieren.

Stattdessen: Jede Entscheidung mit Evidenz und in Betracht gezogenen Alternativen protokollieren.


Fehlerbehandlung

FehlertypUrsacheLösung
Hard-Gate-FehlerFehlender Systemzugriff oder InformationenMelden, welche Prüfungen fehlgeschlagen sind; Zugriff anfordern
Verstoß gegen Ehernes GesetzVersuchte Aktion ohne EvidenzAnhalten, zu Hard-Gate zurückkehren, Verstoß protokollieren
Skill-KonfliktFalscher Skill für die Aufgabe ausgewähltÜber adaptives Routing umleiten
VerifikationsfehlerÄnderungen bestehen Qualitätsgates nichtFehler beheben, Verifikation erneut durchführen

Erfolgskriterien

Vor dem Melden des Abschlusses prüfen:

  • Hard-Gate-Scan durchgeführt und bestanden
  • Alle Ehernen Gesetze während der gesamten Aufgabe eingehalten
  • Jede Empfehlung zitiert spezifische Evidenz
  • Änderungen minimal und auf die Aufgabe fokussiert
  • Verifikation (Tests, Build, manuelle Prüfung) bestanden
  • Entscheidungs-Audit-Trail vollständig
  • Benutzeranfrage vollständig beantwortet

Referenzen

  • references/patterns.md - Wiederverwendbare Muster für evidenzbasierte Workflows
  • references/performance-benchmarks.md - System- und Codebase-Scan-Benchmarks
  • references/output-formats.md - Definitionen von Standardausgabeformaten

Verwandte Kompetenzen

  • skills/kilo-kit/debugging/systematic/ - Für systematische Fehlerdiagnose
  • skills/kilo-kit/debugging/root-cause/ - Für tiefgehende Ursachenanalyse
  • skills/kilo-kit/debugging/verification/ - Zum Verifizieren von Korrekturen
  • skills/kilo-kit/quality/code-review/ - Für Code-Review-Workflows
  • skills/kilo-kit/quality/testing/ - Für testgetriebene Entwicklung
  • skills/kilo-kit/development/security/ - Für Sicherheitsbest Practices
  • skills/kilo-kit/development/backend/ - Für Backend-Entwicklung

Feedback-Integration

Wenn diese Kompetenz:

Erfolgreich war:

  • Notieren, welche Hard-Gate-Prüfungen am wertvollsten waren
  • Festhalten, welche Ehernen Gesetze Fehler verhindert haben
  • Die Evidenzmuster protokollieren, die am besten funktioniert haben

Nicht erfolgreich war:

  • Dokumentieren, welche Prüfungen unzureichend waren
  • Lücken in der Hard-Gate-Checkliste identifizieren
  • Zur Verbesserung der Kompetenz markieren

Kilo-Kit Kernkompetenz v1.0.0 — Evidenz statt Raten

Verwandte Skills