LEKTION 10 / 06.11.2026
Lernziel dieser Lektion: Du wirst lernen, wie man Versionsnummer, Änderungsprotokoll, Kompatibilitätsmatrix und Bedingungen für ein Rollback In das Skill-Repository geschrieben reference/release-checklist.md… anstatt im Chat zu schreiben: „Ich schicke es heute Abend noch.“ In der letzten Lektion hast du bereits über den Koordinatenvertrag zur Computernutzung und die Harness-Grenzen geschrieben:https://school.myshirtai.com/?p=4478. In dieser Lektion geht es, über den Vertrag hinaus, umVeröffentlichung und Verwaltung– Wer hat was geändert, lässt sich das zusammenführen, und wie kann man es zurückgeben, wenn es nicht funktioniert? Die Form ist ein Kurs (Dokumente + Übungen); da die Ausführung nicht lokal erfolgt, sondern über die CI / Skills-API hochgeladen wird, werden keine Zahlenangaben zur erfolgreichen Ausführung in der ersten Person angegeben.
Wenn im Lager keine Versandliste vorliegt, wird online standardmäßig
Aktuellste: Jeder kann den Skill überschreiben, den dein Produktions-Agent gerade verwendet.
Voraussetzungen und überprüfbare Ziele
Bitte schließen Sie zunächst Lektion 9 „Die Koordinatenvereinbarung zur Computernutzung und die Harness-Grenzen in die Fertigkeit einbauen“ ab:https://school.myshirtai.com/?p=4478. Man muss mindestens Folgendes zur Verfügung haben: eine Skill-Ziel, die geladen werden kann,reference/ Schreibrechte oder die Möglichkeit, einen PR einzureichen, Test-Hooks aus Lektion 6 (Fehlerbeispiele können in die Regression aufgenommen werden). Frühere Grundlagen können nachgeholt werden: Lektion 1 https://school.myshirtai.com/archives/3378; Lektion 2 https://school.myshirtai.com/archives/3462; Lektion 3 https://school.myshirtai.com/archives/3521; Lektion 4 https://school.myshirtai.com/archives/3661; Lektion 5 https://school.myshirtai.com/?p=3948; Lektion 6 https://school.myshirtai.com/?p=4048; Lektion 7 https://school.myshirtai.com/?p=4191; Lektion 8 https://school.myshirtai.com/?p=4331.
Heute Abend stehen nur 90 Minuten zur VerfügungEiner Füge die Liste zu „Skill“ hinzu, ohne dabei das gesamte Skript umzuschreiben.
- Ziel A:Absenden
reference/release-checklist.md(umfasst die vier Bereiche Version, Änderungen, Kompatibilität und Rollback). - Ziel B:Zwei Beispiele für Fehler – fehlendes Versionsfeld, fehlende Rollback-Bedingung – die im Test-Hook von Lektion 6 aufgezeigt werden können.
- Ziel C:Geben Sie in der Liste an, ob „die Versions-ID in der Produktionsreferenz fest vorgegeben ist / das stille Verfolgen der neuesten Version untersagt ist“. Wenn der API-Upload noch nicht getestet wurde, vermerken Sie einfach „CI noch nicht lokal ausgeführt“.
Konzept: Was muss in einer Veröffentlichungsliste unbedingt enthalten sein?
In Lektion 9 wird sichergestellt, dass die Koordinaten der Kontrollpunkte korrekt sind. In Lektion 10 wird Folgendes ergänzt: Sobald ein Skill in das gemeinsame Verzeichnis oder die Skills-API aufgenommen wird, entscheidet bei fehlenden Versionen und Rollbacks derjenige, der den Skill zuletzt hochgeladen hat. In den öffentlich zugänglichen Materialien sind Agent Skills mit SKILL.md Ordner; wenn auf der API-Seite eine Version erstellt wird, müssen nachfolgende Uploads denselben unveränderlichen Wert beibehalten name, Versionen werden über eine eindeutige ID adressiert; es können auch Literale verwendet werden Aktuellste– Genau an diesem Punkt sind in der Produktion explizite Entscheidungen erforderlich.
Bei dieser Liste geht es nicht um weitere Gedanken zu einer README-Datei, sondern um eine Checkliste vor der Veröffentlichung. Es wird empfohlen, mindestens vier Punkte festzuhalten:
- Version:Lageretiketten /
SKILL.mdFeld „Interne Version“ / API-Versions-ID – wie lassen sich diese drei miteinander abgleichen? - Änderungsprotokoll:Wurden diesmal die Beschreibung, das Skript oder der Vertrag geändert? Auf welche Auslösebedingungen wirkt sich das aus?
- Kompatibel mit:Abhängigkeiten hinsichtlich Claude Code / API / Harness / Koordinatenvertrag; gibt es einen Konflikt mit der „computer-use“-Erklärung aus Lektion 9?
- Rollback:Was sind die Fehlermeldungen, auf welche Versions-ID oder welches Git-Tag soll zurückgesetzt werden und wer ist dazu berechtigt?

Übung: Erstellen Sie eine Liste mit Beiträgen, die kopiert und eingefügt werden können.
Unter dem Ziel-Skill neu erstellen reference/release-checklist.md. Die folgende Vorlage kann direkt eingefügt und anschließend in den spitzen Klammern angepasst werden; der Code-Block dient lediglich als Übungsbeispiel und wurde nicht lokal in CI ausgeführt.
# Checkliste für die Veröffentlichung —
## Version
- Git-Tag:
- Feld „Version“ in SKILL.md:
- API-Skill-ID / Versions-ID (falls hochgeladen):
- Produktions-PIN: Versions-ID | aktuellste (Standard: PIN-ID)
## Änderungsprotokoll
- Auslöser / Beschreibung:
- Skripte / Referenz:
- Kompatibilitätsbruch? Ja/Nein — Migration:
## Kompatibilität
- Claude Code / API-Oberfläche:
- Harness / Vertrag zur Computernutzung (Lektion 9):
- Eval-Suite-ID (Lektion 6):
## Rollback
- Fehlersignale:
- Rollback auf:
- Eigentümer / Zeitrahmen:
- Anhalten, wenn:
Materialliste: Schreibrechte oder PR; Möglichkeit, der Testreihe aus Lektion 6 zwei Anwendungsfälle zum Thema „Veröffentlichungssperre“ hinzuzufügen; Möglichkeit, die Ergebnisse der Checkliste in die PR-Beschreibung einzufügen. Falls keine echten Online-Zwischenfälle vorliegen, sind fiktive Beispiele zu verwenden: Beschreibung wurde geändert, aber keine Version veröffentlicht, Produktion läuft weiterhin Aktuellste.

- Vorlage kopieren in
reference/release-checklist.md, füllen Sie das Feld „Skill-Bezeichnung“ aus. - Der „Produktions-Pin“ soll standardmäßig als konkrete Versions-ID oder Git-Tag angegeben werden; die Angabe von „latest“ ist nicht zulässig.
- Fügen Sie im Bewertungsverzeichnis von Lektion 6 zwei Beispiele für fehlerhafte Lösungen hinzu (siehe nächster Abschnitt).
- PR: Liste der Beiträge im Haupttext abhaken; bei der Prüfung nur darauf achten, ob die vier Felder leer sind.
Beispiele für Fehlversuche und Bewertungshaken für Lektion 6
Die Bewertung ist kein optionales Element. In Lektion 6 wurde bereits behandelt, wie man mit einem Bewertungssatz eine Regression durchführt; in dieser Lektion soll sichergestellt werden, dass auch die Freigabe von Zugangskontrollen über denselben Hook aufgerufen werden kann. Bereiten Sie mindestens zwei vor.Sollte scheiternBeispiel:
| Beispiel | Was fehlt? | Erwartete Testergebnisse |
|---|---|---|
| Fehlende Version | Kein Git-Tag / Kein Versionsfeld / Kein Pin | Rotes Licht am Zugang, Einfahren verboten |
| Rollback-Fehler | Es gibt ein Änderungsprotokoll, aber keine Fehlermeldungen / Rollback zu | Rotes Licht am Zugang, Einfahren verboten |
| Kompatibel mit Leerzeichen | „computer-use“ wurde geändert, ohne auf den Vertrag aus Lektion 9 Bezug zu nehmen | Warnung oder rote Ampel (vom Team festzulegen) |

Tragen Sie den Namen der Beispieldatei in die Zeile „eval suite id“ der Liste ein, zum Beispiel evals/release-missing-version.md. Auf diese Weise nutzen der „Hook“ aus Lektion 6 und die Zugangskontrolle aus Lektion 10 dieselben Pfadkonventionen, wodurch eine Abweichung der beiden Verzeichnisstrukturen vermieden wird.
Hinweis:In diesem Artikel wurde weder lokal die Skills-API aufgerufen, um eine Version zu erstellen, noch wurde die CI des Repositorys ausgeführt. Die Kriterien für die Abnahme der Übung sind: „Checkliste + zwei Beispiele für Fehlschläge + PR-Checkliste“ müssen vollständig vorliegen; die Dokumentationsübung darf nicht mit dem Vermerk „bereits in die Produktion hochgeladen“ abgeschlossen werden.
Vorschau auf die nächste Lektion
Vorschau auf die nächste Lektion (noch offen): Graustufen-Bereitstellung und MCP-Whitelist – Wie man eine festgelegte Versions-ID in den Graustufen-Verkehr einbindet und wie man Aufrufe von Tools mit hohem Risiko auf die Whitelist setzt und eine Beobachtungsphase festlegt. In dieser Lektion werden zunächst die Offline-Veröffentlichungsliste und die Bewertung bei „Rot“ stabilisiert; ohne Rollback-Bedingungen würde die schrittweise Einführung den Umfang eines Vorfalls nur vergrößern.
Inhaltsverzeichnis dieser Reihe
- Lektion 1: Erstellen Sie in 30 Minuten Ihren ersten automatisch ausgelösten Claude Agent Skill — https://school.myshirtai.com/archives/3378
- Lektion 2: Hinzufügen einer Referenz zu „Skill“ / Der Prüfkreis „Zuerst das Planungsdokument erstellen, dann ausführen“ — https://school.myshirtai.com/archives/3462
- Lektion 3: Skriptbasierte Skills und Sicherheitsaudits — https://school.myshirtai.com/archives/3521
- Lektion 4: Iteratives Arbeiten mit realen Fehlerfällen – Beschreibung — https://school.myshirtai.com/archives/3661
- Lektion 5: Skill in ein echtes Repository (CI) bzw. in ein gemeinsames Teamverzeichnis integrieren — https://school.myshirtai.com/?p=3948
- Lektion 6: Regression für „Skill“ anhand eines Testdatensatzes — https://school.myshirtai.com/?p=4048
- Lektion 7: Multi-Skill-Choreografie: Aufbrechen und Zusammenfügen von Grenzen sowie Schlichtung von Konflikten — https://school.myshirtai.com/?p=4191
- Lektion 8: Implementierung des Task-/Subagent-Musters in einem Skill: Parallelitätsgrenzen und Kontextisolierung — https://school.myshirtai.com/?p=4331
- Lektion 9: Den „Computer-Use“-Koordinatenvertrag und die „Harness“-Grenzen in die Fertigkeit einarbeiten — https://school.myshirtai.com/?p=4478
- Lektion 10: Die Skill-Veröffentlichungsliste in das Repository einpflegen: Versionen, Änderungsprotokoll, Kompatibilität und Rollback (dieser Artikel)
Unsere Einschätzung:Der Wert einer Veröffentlichungsliste liegt nicht darin, dass es „noch ein weiteres Markdown“ ist, sondern darin, dass sie dich dazu zwingt, vor dem Einpflegen Fragen zu Version, Kompatibilität und Rollback zu klären. Eine feste Versions-ID festzulegen und das Fehlerbeispiel aus Lektion 6 beizufügen, ist für die Abnahme besser geeignet als die mündliche Aufforderung „Vorsicht vor der neuesten Version“.
Weiterführende Links
- Claude Code Docs: Claude um Fähigkeiten erweitern
- Übersicht über die Fähigkeiten von Agenten (offener Standard)
- GitHub: anthropics/skills
- Claude-API-Dokumentation: Skill-Versionen
- Lektion 9: Computer-Use-Koordinatenvertrag und Harness
- Lektion 6: Regression für „Skill“ anhand eines Testdatensatzes


评论列表 (0条):
加载更多评论 Laden...