BambooGap/skills-orchestrator

Was macht skills-orchestrator?

Open-Source SkillOps / Instruktionslieferketten-Steuerungsebene für KI-Agententeams: Policy-Pakete, Registry-Diff, Evidence-Bundles, SARIF/SBOM, Adapter und MCP-Laufzeit.

Übersicht

Der skills-orchestrator ist eine zentrale Steuerungsebene (Control Plane) für die Verwaltung der Fähigkeiten (Skills) und Instruktionen, die von KI-Agenten wie Claude Code, Cursor oder Codex genutzt werden. Er stellt sicher, dass Agenten die richtigen Fähigkeiten zur richtigen Zeit erhalten und dabei Unternehmensrichtlinien und Sicherheitsstandards eingehalten werden.

Hauptfunktionen

Policy-Pakete

• Definieren erzwingbare Regelsets für die Nutzung von Fähigkeiten
• Unterstützen granulare Zugriffskontrollen und Compliance-Prüfungen
• Beispielhafter Policy-Pack-Definition in YAML:

policies:
  - name: "security-scanner"
    rules:
      - type: "allow"
        registry: "*"
        condition: "env.ENVIRONMENT in ['staging', 'production']"
      - type: "deny"
        skill: "insecure-package"

Registry-Diff

• Vergleicht Skill-Register zwischen verschiedenen Umgebungen oder Zeitpunkten
• Erkennt hinzugefügte, entfernte oder geänderte Fähigkeiten
• CLI-Befehl: orchestrator registry diff --source ./registry1.json --target ./registry2.json

Evidence-Bundles

• Sammelt und signiert Nachweise über die Ausführung von Fähigkeiten
• Ermöglicht Audits und Compliance-Nachweise
• Ausgabe im JSON-Format mit Metadaten und Hash-Integrität

SARIF/SBOM-Integration

• Unterstützt den SARIF-Standard (Static Analysis Results Interchange Format) für Sicherheitsergebnisse
• Erzeugt SBOMs (Software Bill of Materials) für verwendete Fähigkeiten
• Beispiel-SBOM-Auszug:

{
  "format": "cyclonedx",
  "components": [
    {
      "name": "my-custom-skill",
      "version": "1.2.3",
      "type": "library"
    }
  ]
}

Adapter

• Unterstützt mehrere KI-Plattformen (Claude Code, Cursor, Codex, etc.)
• Bietet einheitliche Schnittstelle für verschiedene Agenten-Typen
• Einfache Konfiguration über Umgebungsvariablen:

export ORCHESTRATOR_ADAPTER="claude"
export ORCHESTRATOR_ENDPOINT="http://localhost:8080"

MCP-Laufzeit (Model Context Protocol)

• Ermöglicht dynamische, kontextbewusste Fähigkeitenbereitstellung
• Nutzt MCP für Echtzeit-Kommunikation zwischen Agenten und Steuerungsebene
• Reduziert Latenz und verbessert Reaktionsfähigkeit

Verwendung

Schnellstart

1. Installieren Sie das Paket:

   npm install @bamboogap/skills-orchestrator
   

2. Initialisieren Sie die Steuerungsebene:

   orchestrator init --config config.yaml
   

3. Überprüfen Sie den Status:

   orchestrator status
   

Konfiguration

Erstellen Sie eine Konfigurationsdatei config.yaml mit Ihren Einstellungen:

registries:
  - name: "default"
    path: "./skills"
    watch: true

policies:
  path: "./policies"
  default: "allow-all"

output:
  sarif: true
  sbom: true
  evidence: true

Integration in CI/CD

Fügen Sie den Orchestrator in Ihre Pipeline ein:

orchestrator validate --registry ./skills
orchestrator diff --registry ./skills --production last-known-good

Lizenz

MIT - Siehe LICENSE für Details.

Support

Bei Fragen oder Problemen öffnen Sie bitte ein Issue auf GitHub.