metyatech/skill-release-publish

Workflow für Release und Veröffentlichung

Metadaten öffentlicher Repositorys

• Bei einem öffentlichen Repository MUSS der Agent die GitHub- Beschreibung, Themen (Topics) und das Homepage-Feld setzen.
• Ein öffentliches Repository MUSS enthalten: .github/workflows/ci.yml, Issue-Vorlagen, eine PR-Vorlage, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md und CHANGELOG.md.
• CI MUSS die standardmäßigen Lint-, Test- und Build- Befehle des Repositorys ausführen.

Versionsverwaltung und Release-Ablauf

• Der Agent MUSS die Versionsmetadaten aktualisieren, wenn sich der Release-Inhalt ändert, und MUSS die Paketversion und den Git-Tag konsistent halten.
• Wenn der Agent nach einer Version gefragt wird, MUSS er diese selbstständig auswählen.
• Beim Erhöhen einer Version MUSS der Agent das GitHub- Release erstellen und das Paket im selben Update veröffentlichen.
• Für die npm-Veröffentlichung von Paketen, die metyatech gehören, MUSS der Agent npm publish direkt ausführen. Ein Automatisierungstoken ist konfiguriert.
• Für andere Pakete MUSS der Agent den Benutzer bitten, npm publish auszuführen.
• Vor der Veröffentlichung MUSS der Agent die erforderlichen Vorbereitungsbefehle (npm install, npm test, npm pack --dry-run usw.) ausführen und darf nur fortfahren, wenn alles bereit ist.
• Wenn die Authentifizierung während der Veröffentlichung fehlschlägt, MUSS der Agent den Benutzer bitten, den Veröffentlichungsschritt abzuschließen.
• Der Agent MUSS vor dem Release Sicherheitsprüfungen für Abhängigkeiten durchführen, MUSS kritische Probleme beheben und MUSS die Ergebnisse melden.

Nach der Veröffentlichung: Überprüfung

Nach der Veröffentlichung MUSS der Agent eine lokal installierte Kopie auf die neu veröffentlichte Version aktualisieren und MUSS die aufgelöste Version überprüfen. Der Agent DARF NICHT „fertig“ melden, bis diese Überprüfung abgeschlossen ist (oder der Benutzer dies explizit ablehnt).

Der Agent MUSS die Überprüfung als explizite Akzeptanzkriterien mit Ergebnissen (BESTANDEN / FEHLGESCHLAGEN / N/A) und Nachweisen darstellen:

• AK1 (Registry) — überprüfen, ob die veröffentlichte Version in der Registry existiert (z. B. npm view <pkg> version).
• AK2 (Frische Installation) — überprüfen, ob das neueste Paket aufgelöst und ausgeführt werden kann (z. B. npx <pkg>@latest --version).
• AK3 (Globale Aktualisierung, falls zutreffend) — falls das Paket global installiert ist, auf die veröffentlichte Version aktualisieren und überprüfen (z. B. npm ls -g <pkg> --depth=0, npm i -g <pkg>@latest, dann <cmd> --version). Wenn AK3 nicht zutrifft, MUSS der Agent es als N/A markieren und den Grund explizit angeben.

Für npm-CLIs:

• Falls global installiert: npm ls -g <pkg> --depth=0 prüfen, über npm i -g <pkg>@latest aktualisieren, dann mit <pkg> --version überprüfen.
• Falls nicht global installiert: die globale Aktualisierung überspringen und die Verfügbarkeit über npx <pkg>@latest --version (oder das entsprechende Ökosystem) prüfen.

Standard-Repository-Themen

Der Agent MUSS Themen aus der folgenden Standardmenge zuweisen. Jedes Repository MUSS mindestens ein Standard-Thema haben, wenn es zutrifft. Ein Repository, das zu keinem Standard-Thema passt, MUSS deskriptive Themen verwenden, die für seinen Bereich relevant sind.

• agent-skill — Repository enthält eine SKILL.md (eine installierbare Agent-Fähigkeit).
• agent-tool — CLI-Tool oder MCP-Server, der von Agenten verwendet wird (z. B. task-tracker, agents-mcp, compose-agentsmd).
• agent-rule — Regelquelle oder Regelsatz-Repository (z. B. agent-rules).
• unreal-engine — Unreal Engine-Plugin oder -Beispielprojekt.
• qti — QTI-Bewertungsökosystem-Tool oder -Bibliothek.
• education — Kursinhalt, Lehrmaterialien oder studentenorientierte Plattform.
• docusaurus — Docusaurus-Plugin oder -Erweiterung.

Zusätzliche deskriptive Themen (Sprache, Framework, Bereichs- Schlüsselwörter) KÖNNEN frei neben den Standardthemen hinzugefügt werden. Der Agent MUSS die Standardthemen überprüfen und aktualisieren, wenn sich die Repository-Landschaft wesentlich ändert. Der Agent MUSS überprüfen, ob die Themen als Teil der Compliance-Prüfung für neue Repositorys gesetzt sind.

Anforderungen an veröffentlichte Artefakte

• Der Agent MUSS Paketmetadaten (Name, Beschreibung, Repository, Issues, Homepage, Engines) ausfüllen.
• Der Agent MUSS ausführbare Einstiegspunkte und erforderliche Shebangs validieren, damit installierte Befehle funktionieren.
• Wenn ein Repository ein einzelnes Tool oder Produkt repräsentiert, MUSS der Agent ein einzelnes Paket veröffentlichen (unter Bündelung zugehöriger Skripte).