Halte KI-Skill-Dokumente an einer Stelle und schreibe sie zum Nachschlagen für die KI

## Bearbeite nur die Quelldatei und erzeuge Kopien mit dem Generator neu Das maßgebliche Fähigkeitsdokument bestimmen und erzeugte Integrationen, Manifeste sowie plattformspezifische Projektionen als abgeleitete Artefakte behandeln. Die Quelle und ihre Verweise bearbeiten und anschließend die Ableitungen mit dem Erzeugungswerkzeug des Projektarchivs neu erstellen. Von der kontinuierlichen Integration verwaltete Ausgaben niemals von Hand bearbeiten. Dort einen Prüfmodus vorhalten, der im Arbeitsspeicher oder in einem temporären Bereich neu erzeugt und fehlschlägt, wenn festgeschriebene Ableitungen von der Quelle abweichen. Wenn dieselbe Fähigkeit über mehrere Plattformen verteilt wird, Inhalte gemeinsam nutzen, statt abgespaltene Varianten zu pflegen. Festhalten, welche Datei Inhalt, Metadaten und Versionswerte verwaltet, damit Mitwirkende keine konkurrierenden Quellen schaffen. Installation und Nutzung durch Endanwender aus den Anweisungen für Mitwirkende heraushalten. Die Mitwirkendendokumentation soll Wartung, Prüfung, Tests und Veröffentlichungsverhalten erklären, ohne den Produktleitfaden zu wiederholen. ## Lass Entscheidungen im Hauptdokument und lege Details in Referenzdateien ab Das Hauptdokument der Fähigkeit als Abrufeinstieg verwenden und ausführliche Verweise nur bei Bedarf laden. Inhalte wie folgt einordnen: - Entscheidungsrahmen und häufig verwendete Muster in das Einstiegsdokument; - ausführliche Anleitungen, Vorlagen und erweiterte Beispiele in Verweisdateien; - Ausgangsszenarien und Begründungsaufzeichnungen in die Testdokumentation; - Installation und Nutzung in die benutzerseitige Dokumentation; - Einzelheiten zum Mitwirkendenablauf in den Beitragsleitfaden. Zwischen Einstiegsdokument und benachbarten Verweisen stabile relative Verknüpfungen verwenden. Die von Verteilungstabellen verwendeten obersten Verweisanker auch dann beibehalten, wenn tiefer liegende Unterabschnitte neu gegliedert werden. Eine Platzierungsprüfung anwenden: Bestimmt ein Eintrag, welcher Weg zu wählen ist, bleibt er nahe am Einstiegspunkt. Erklärt er ausführlich, wie ein bereits gewählter Weg auszuführen ist, wird er in einen Verweis verschoben. ## Schreibe kurze, direkte Anweisungen und stelle Entscheidungstabellen voran Für einen Agenten optimieren, der Absichten einordnet, einen Zweig auswählt und ausführt, nicht für einen Leser, der den Leitfaden von Anfang bis Ende durcharbeitet. Wenn mehrere Vorgehensweisen gültig sind, vor dem Ablaufleitfaden eine kompakte Entscheidungstabelle platzieren. Jeden Abschnitt wie folgt ordnen: 1. Entscheidungstabelle; 2. Standardverfahren; 3. Alternativen; 4. knappe Regeln und Fallstricke. Die Befehlsform verwenden und je Aufzählungspunkt genau eine Tatsache nennen. Beratende Einleitungen wie „du solltest erwägen“, „beachte“ oder „behalte im Hinterkopf“ in unmittelbare Handlungen umwandeln. Für nicht offensichtliche Unterschiede knappe positive und negative Regeln bevorzugen. Jede Tabelle, jedes Beispiel und jeder Quelltextblock muss eine noch nicht genannte Tatsache hinzufügen. Wenn das Verfahren die Anweisung bereits vermittelt, Vorher-Nachher-Unterschiede, wiederholte Begründungen, lehrhafte Exkurse und nur der Vollständigkeit dienende Beispiele weglassen. Begründungen auf höchstens einen einleitenden Satz begrenzen. Für jeden Unterabschnitt ein Tokenziel festlegen und Abschnitte bei Überschreitung teilen oder verdichten, ohne Entscheidungskriterien, erforderliche Handlungen, Einschränkungen oder Ausnahmen zu entfernen. ## Prüfe nach Änderungen die Dokumentstruktur und teste das Verhalten der KI Die Prüfung an das Artefakt anpassen. Dokumentationsorientierte Fähigkeiten benötigen möglicherweise keine Kompilierung, erfordern aber weiterhin automatische Strukturprüfungen und manuelle Verhaltenstests. Prüfungen der Pflichtfelder im Dokumentkopf, Benennungsregeln, Zeilen- oder Tokenbudgets, internen Verknüpfungen, Synchronisierung erzeugter Artefakte und projektspezifischen Stilprüfregeln automatisieren. Weiche Größenziele als Warnungen und harte Unversehrtheitsvorgaben als Fehler behandeln. Bei einer Inhaltsänderung: 1. die maßgebliche Fähigkeit oder einen Verweis bearbeiten; 2. die lokale Strukturprüfung ausführen; 3. die Fähigkeit in ihrer Zielumgebung neu laden; 4. realistische Benutzeranfragen ausführen, die den geänderten Zweig durchlaufen; 5. das Verhalten mit Ausgangsszenarien vergleichen und auf Rückschritte prüfen. Im Änderungsantrag Vorher-Nachher-Nachweise für betroffene Szenarien verlangen. Bei wesentlichen Änderungen der Informationsarchitektur eine unabhängige Prüfung einholen, die sich auf Abrufstruktur, Verdichtung und fehlende Entscheidungszweige konzentriert. ## Verlange Prüfungen im Pull Request und lass Versionen automatisch setzen Den Hauptzweig schützen: Änderungsanträge, Prüfkontrollen und einen gültigen konventionsgerechten Titel verlangen. Wenn Änderungen zu einem Commit verdichtet zusammengeführt werden und der Titel des Änderungsantrags zum Veröffentlichungs-Commit wird, diesen Titel prüfen, weil er die Versionierung bestimmt. Konventionsgerechte Änderungsarten Versionssprüngen zuordnen und ein ausdrückliches Signal für eine Hauptversionsänderung einschließen. Der Veröffentlichungsablauf soll Änderungsprotokoll, maßgebliche Versionsmetadaten, Plattformmanifeste und erzeugte Artefakte in einer einzigen Veröffentlichungsänderung aktualisieren. Synchronisierte Versionsnummern niemals von Hand bearbeiten. Genau eine maßgebliche Versionsquelle beibehalten und sie vor dem Erstellen der Versionsmarke durch die Veröffentlichungskette verbreiten lassen. Vor dem Zusammenführen bestätigen: - erzeugte Ausgaben stimmen mit der maßgeblichen Quelle überein; - Entscheidungstabellen stehen vor verzweigten Ablaufleitfäden; - überflüssige Einleitungen und Beispiele wurden weggelassen; - für die Verteilung verwendete Anker bleiben stabil; - geänderte Ausgangsszenarien enthalten Nachweise; - erforderliche Prüfungen und Titelkontrollen sind bestanden.