Was macht skill-ci?
Wiederverwendbarer CI-Workflow für die QuickClaw-Skills-Organisation – validiert SKILL.md, skill.json, unerlaubte Dateien, Secrets, Pfade, Syntax und Release-Synchronisation (3-Wege).
Überblick
Dieser Workflow automatisiert die Qualitätssicherung für Skills in der QuickClaw-Skills-Organisation. Er kann in jedes Repository integriert werden, das Skills verwaltet, und stellt sicher, dass alle wichtigen Konfigurationsdateien und Strukturen den Anforderungen entsprechen.
Verwendung
Fügen Sie in Ihrem Repository eine GitHub Actions Workflow-Datei (z. B. .github/workflows/skill-ci.yml) mit folgendem Inhalt hinzu:
name: Skill CI
on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
jobs:
validate:
uses: QuickClaw-Skills/skill-ci/.github/workflows/skill-ci.yml@v1
Validierungen
Der Workflow führt folgende Prüfungen durch:
- SKILL.md: Überprüfung der Struktur, erforderlichen Abschnitte und Formatierung.
- skill.json: Validierung gegen das definierte Schema (z. B. korrekte Felder, Typen, optionale Felder).
- Unerlaubte Dateien: Erkennung von Dateien, die nicht in einem Skill-Repository enthalten sein sollten (z. B.
.env,node_modules/,.DS_Store). - Secrets: Prüfung, ob Secrets korrekt gesetzt und nicht in Code eingecheckt werden.
- Pfade: Sicherstellung, dass alle referenzierten Dateien und Ordner vorhanden sind.
- Syntax: Syntaxprüfung für YAML, JSON und andere relevante Formate.
- Release-Synchronisation (3-Wege): Synchronisation zwischen Quellcode, veröffentlichten Releases und dem Skill-Index, um Inkonsistenzen zu vermeiden.
Anforderungen
- Quell-Repository: Muss Teil der QuickClaw-Skills-Organisation auf GitHub sein.
- GitHub Actions: Workflow läuft nur auf GitHub Actions und benötigt mindestens die Standard-Runner (ubuntu-latest).
- Gültige SKILL.md und skill.json: Diese Dateien müssen im Repository vorhanden sein.
Beitragen
Wenn Sie Verbesserungen vorschlagen oder Fehler melden möchten, erstellen Sie bitte ein Issue oder einen Pull Request im Repository QuickClaw-Skills/skill-ci.