Esquetta/CodexPluginDoctor

Was macht CodexPluginDoctor?

Lokaler CLI-Prüfer für Codex-Plugin-Pakete, Skills und MCP-Server-Bündel.

Übersicht

CodexPluginDoctor ist ein Kommandozeilenwerkzeug zur Validierung von Codex-Plugin-Paketen, Skills und MCP-Server-Bündeln. Es stellt sicher, dass diese Pakete den erwarteten Struktur- und Konfigurationsstandards entsprechen.

Funktionen

• Validierung der Paketstruktur und -metadaten
• Prüfung von Skill-Definitionen und Abhängigkeiten
• Überprüfung von MCP-Server-Konfigurationen
• Ausführliche Fehlerberichte mit Hinweisen zur Behebung
• Unterstützung für CI/CD-Integrationen

Voraussetzungen

• Node.js (Version 16 oder höher)
• npm oder yarn

Installation

npm install -g codex-plugin-doctor

Oder verwenden Sie es direkt mit npx:

npx codex-plugin-doctor

Verwendung

codex-plugin-doctor <pfad-zum-paket>

Beispiele

Validieren Sie ein lokales Plugin-Paket:

codex-plugin-doctor ./mein-plugin

Validieren Sie einen Skill:

codex-plugin-doctor ./skills/beispiel-skill

Validieren Sie ein MCP-Server-Bündel:

codex-plugin-doctor ./mcp-server/beispiel-server

Optionen

• --verbose – Detaillierte Ausgabe
• --json – Ausgabe im JSON-Format
• --fix – Automatische Korrektur erkannter Probleme
• --help – Hilfe anzeigen

Ausgabe

Das Tool gibt eine Zusammenfassung der Validierung aus, einschließlich:

• Gefundene Fehler
• Warnungen
• Erfolgreich validierte Komponenten

Integration in CI/CD

# Beispiel GitHub Actions Workflow
- name: Validate Plugin
  run: npx codex-plugin-doctor ./plugin

Fehlerbehebung

Häufige Fehler

1. Fehlende package.json – Das Plugin-Verzeichnis muss eine package.json enthalten.
2. Ungültiger Skill-Pfad – Der angegebene Pfad muss auf ein gültiges Skill-Verzeichnis verweisen.
3. Unvollständige MCP-Server-Konfiguration – Stellen Sie sicher, dass alle erforderlichen Parameter in der MCP-Server-Definition vorhanden sind.

Support

Bei Problemen oder Fragen öffnen Sie bitte ein Issue im GitHub-Repository.

Lizenz

MIT