Eine Bibliothek von KI-Fähigkeiten für die Forschung ordnen und nur Geprüftes veröffentlichen

## Jede Fähigkeit genau einer Phase der Forschung zuordnen Lege die Aufgabe der Bibliothek fest, bevor du ihre Ordner auswählst. Eine forschungsorientierte Sammlung sollte den Weg von Fragestellung und Literaturauswertung über Ideenfindung, Datenaufbereitung, Experimente, Training, Bewertung und Bereitstellung bis zur Kommunikation unterstützen. Verwende nummerierte oder anderweitig stabile Kategorien, die diesen Lebenszyklus abbilden. Behalte eine zentrale Koordinationsfähigkeit bei, die Arbeiten an spezialisierte Fähigkeiten weiterleitet, ohne deren ausführliche Anleitungen zu wiederholen. Für jede vorgeschlagene Fähigkeit: - Bestimme die Lebenszyklusphase und eine zuständige Kategorie. - Beschreibe das gelöste Nutzerproblem und die Einsatzbedingungen. - Benenne benachbarte Alternativen und erkläre, wann sie besser geeignet sind. - Vermeide überlappende Zuständigkeiten, durch die dieselbe Aufgabe scheinbar zwei Verantwortliche hat. Behandle die Klassifikation als Navigationsvertrag. Aktualisiere Katalog, Anzahlen, Beschreibungen und Entwicklungsplan, sobald sich Zuständigkeit oder Bestand ändern. ## Alle Dateien einer Fähigkeit in einem Ordner bündeln Gib jeder Fähigkeit ein eigenes Verzeichnis mit einem verbindlichen Hauptleitfaden. Füge nur die von der Fähigkeit benötigten unterstützenden Ordner hinzu: - `references/` für ausführliche offizielle Dokumentation, API-Hinweise, Anleitungen, Problemmuster und Veröffentlichungsverlauf. - `scripts/` für wiederholbare Hilfsabläufe. - `templates/` für wiederverwendbare Ausgangspunkte. - `examples/` für vollständige repräsentative Umsetzungen. - `assets/` für vom Leitfaden verwendetes Material, das kein Code ist. Der Hauptleitfaden ist der Einstiegspunkt, keine Enzyklopädie. Er sollte den Betriebsweg erklären und unmittelbar auf ausführliche Referenzen eine Ebene darunter verweisen. Erstelle keine Ketten, bei denen eine Referenz den Leser an eine weitere Referenz schickt, damit er dort verbindliche Anweisungen findet. Bewahre alle zur Ausführung der Fähigkeit erforderlichen Dateien im Paket auf, damit Prüfung, Archiverstellung und Registerabgleich an einer einzigen klaren Grenze arbeiten. ## Den Hauptleitfaden mit festen Feldern wie Name und Version beginnen Jeder Hauptleitfaden beginnt mit einem gültigen YAML-Kopfbereich, der einen festen Feldvertrag verwendet: - `name`: ein eindeutiger Bezeichner in Kebab-Schreibweise, vorzugsweise ein Gerundium, das die Tätigkeit beschreibt. - `description`: ein Text in der dritten Person, der sowohl die Funktion der Fähigkeit als auch ihren Einsatzzeitpunkt angibt. - `version`: eine semantische Version, die bei jeder Änderung an Verhalten oder Anleitung aktualisiert wird. - `author`: ein Zuständigkeitswert für die Quellenklassifikation des Registers. - `license`: die Verteilungslizenz. - `tags`: Begriffe in Titelschreibweise, wobei etablierte Abkürzungen in Großbuchstaben bleiben. - `dependencies`: optionale Pakete mit ausdrücklichen Versionsbeschränkungen. Setze skalare Werte nur dann in Anführungszeichen, wenn die YAML-Syntax es verlangt. Halte Beschreibungen unterhalb der festgelegten Zeichengrenze und vermeide unklare Bezeichner wie helper, tools oder utilities. Prüfe den Deskriptor durch Parsen und nicht durch Sichtprüfung. Behandle fehlende Pflichtfelder, ungültige Versionen, doppelte Namen und fehlerhaft aufgebaute Abhängigkeiten als blockierende Fehler. ## Den Hauptleitfaden kurz halten und Details in Referenzdateien auslagern Strebe für den Hauptleitfaden 200 bis 500 Zeilen an. Wenn unverzichtbare Anleitungen 500 Zeilen überschreiten, verschiebe fortgeschrittene Einzelheiten in direkt referenzierte Dateien, statt notwendige Entscheidungen wegzukürzen oder den Einstiegspunkt unbegrenzt wachsen zu lassen. Der Leitfaden sollte Folgendes enthalten: - Einen knappen Zweck und klare Auslösebedingungen. - Einen Vergleich mit einschlägigen Alternativen. - Zwei oder drei vollständige Arbeitsabläufe für komplexe Anwendungsfälle. - Direkt einsetzbare Prüflisten, wenn die Reihenfolge wichtig ist. - Konkrete Ein- und Ausgabebeispiele. - Rückkopplungsschleifen zum Prüfen, Korrigieren und Wiederholen qualitätskritischer Arbeit. - Einen Abschnitt zu häufigen Problemen mit konkreten Abhilfen. Setze einen kompetenten Leser voraus. Erläutere fachspezifische Entscheidungen und Fehlermöglichkeiten, nicht bereits durch die Aufgabe vorausgesetzte Grundbegriffe. Gib jedem abgegrenzten Codebeispiel eine Sprachkennung. Erstelle umfangreiche Referenzen aus maßgeblichen Quellen und lege bei fachlichem Bedarf ein ausdrückliches Abdeckungsziel wie etwa 300 KB fest. Blähe Dokumente nicht auf, um eine Größenkennzahl zu erreichen; Vollständigkeit, Nachvollziehbarkeit und praktischer Nutzen bleiben das Ziel. ## Fähigkeiten immer nach denselben Schritten hinzufügen oder verbessern Für eine neue Fähigkeit: 1. Wähle einen genehmigten Punkt des Entwicklungsplans und eine zuständige Kategorie aus. 2. Erstelle die Standardstruktur des Pakets. 3. Schreibe und prüfe den Deskriptor, bevor du den Inhalt erweiterst. 4. Erstelle die wichtigsten Arbeitsabläufe und Entscheidungshilfen. 5. Füge nach Bedarf direkte Referenzen, Hilfen, Vorlagen und Beispiele hinzu. 6. Teste die Fähigkeit an repräsentativen realen Aufgaben. 7. Aktualisiere Katalog, Statistiken und Entwicklungsplan in derselben Änderung. Bewahre bei einer vorhandenen Fähigkeit den Deskriptorvertrag, erhöhe die Version, halte den Hauptleitfaden innerhalb seiner Begrenzung, ergänze fehlende Arbeitsabläufe oder Fehlerbehebungen und führe repräsentative Anwendungsfälle erneut aus. Verwende einen Funktionszweig und einen gezielten Prüfantrag. Nimm das gesamte Paket und seine Katalogänderungen gemeinsam in denselben Commit auf, damit das Repository niemals eine unvollständige Fähigkeit ausweist. ## Fähigkeiten mit automatischen Prüfungen und echten Aufgaben testen Führe vor der Prüfung mechanische Kontrollen aus: - Bestätige, dass die Hauptdatei vorhanden ist und ihr Kopfbereich geparst werden kann. - Vergleiche die Zeilenzahl des Hauptleitfadens mit dem Ziel von 200 bis 500. - Prüfe, dass jeder Codeblock eine Sprache angibt. - Miss die Referenzabdeckung anhand des gewählten Ziels. - Prüfe, dass referenzierte Dateien genau eine Ebene unterhalb des Hauptleitfadens liegen. - Bestätige, dass Namen, Kennzeichnungen, Versionen und Abhängigkeiten ihren Schemata folgen. Führe anschließend die Verhaltensprüfung durch: - Führe jeden vorrangigen Arbeitsablauf mit realistischen Eingaben aus. - Prüfe die angegebenen Ausgaben und Wiederherstellungsschritte. - Erprobe mindestens einen häufigen Fehler. - Bestätige, dass eine Alternative empfohlen wird, wenn die Fähigkeit nicht das richtige Werkzeug ist. - Wiederhole die Prüfung nach jeder wesentlichen Bearbeitung. Ein großer Referenzordner gleicht keinen unklaren Arbeitsablauf aus, und eine ausgefeilte Übersicht gleicht keine unbrauchbaren Beispiele aus. ## Geänderte Fähigkeiten nach der Freigabe automatisch ins Register hochladen Ermittle bei einer genehmigten Änderung am Standardzweig, welche Fähigkeitspakete der obersten Ebene geändert wurden. Führe für jedes geänderte Paket Folgendes aus: 1. Verlange den Hauptleitfaden und parse seinen Deskriptor. 2. Klassifiziere die Quelle gemäß der erklärten Zuständigkeitsrichtlinie. 3. Archiviere das vollständige Paket und schließe dabei versteckte Betriebssystem- und Versionsverwaltungsdateien aus. 4. Lade das Archiv in den passenden Namensraum des Registers hoch. 5. Erstelle oder aktualisiere den Registereintrag. 6. Melde übersprungene oder fehlgeschlagene Pakete, ohne sie stillschweigend als abgeglichen zu behandeln. Speichere Endpunkt- und Authentifizierungswerte ausschließlich im Geheimnisspeicher der Automatisierungsplattform. Unterstütze einen manuellen Auslöser für Wiederherstellung und Tests, stelle jedoch sicher, dass in automatischer und manueller Betriebsart dieselbe Prüf- und Paketierungslogik ausgeführt wird. Prüfe den Arbeitsablauf mit einer harmlosen versionierten Änderung, untersuche den Automatisierungslauf und bestätige Registereintrag und Archiv. Verwende nicht lediglich zum Auslösen der Verarbeitungskette ungeprüfte Bearbeitungen. ## Ein neues Paket nur veröffentlichen, wenn sich die Versionsnummer ändert Steuere die Paketveröffentlichung durch eine Versionsänderung im Paketdeskriptor des Standardzweigs. Eine Änderung nur an der Sperrdatei darf keine neue Veröffentlichung auslösen. Verwende den Versionsbefehl der Paketverwaltung, damit Beschreiber und Sperrdatei gemeinsam fortgeschrieben werden. Wähle je nach Kompatibilität eine Fehlerkorrektur-, Neben- oder Hauptversion und unterdrücke automatische Versionsverwaltungsmarken nur, wenn das Veröffentlichungsverfahren des Repositorys einen gesonderten Commit erfordert. Authentifiziere dich über einen eingerichteten vertrauenswürdigen Herausgeber statt über ein langlebiges Registerzugriffstoken. Füge jedem veröffentlichten Artefakt einen Erstellungsherkunftsnachweis oder eine gleichwertige Lieferkettenbescheinigung bei. Prüfe vor der Veröffentlichung: - Die Identität des vertrauenswürdigen Herausgebers stimmt genau mit den Namen von Repository und Arbeitsablauf überein. - Umgebungsvariablen überschreiben die vertrauenswürdige Authentifizierung nicht mit einem veralteten Zugriffstoken. - Eine saubere Installation aus der im Commit enthaltenen Sperrdatei gelingt. - Die neue Version unterscheidet sich von der vorherigen Revision. - Der Paketinhalt entspricht der geprüften Quelle. Wenn die Veröffentlichung übersprungen wird oder die Authentifizierung fehlschlägt, korrigiere die Versionsprüfstelle oder die vertrauenswürdige Identität; umgehe den Herkunftsnachweis nicht. ## Vorhandene Fähigkeiten verbessern, statt immer neue hinzuzufügen Beurteile die Bibliothek nach ausführbarem Fachwissen, nicht nach der Anzahl ihrer Verzeichnisse. Eine nützliche Fähigkeit verdichtet verlässliche Praxis in eine Form, die ein Agent befolgen und prüfen kann und die eine Wiederherstellung ermöglicht. Bestätige vor dem Zusammenführen: - Der Umfang passt in eine Kategorie und überschneidet sich nicht mit einer bestehenden Zuständigkeit. - Die Regeln für Deskriptor, Benennung und Version werden erfüllt. - Der Hauptleitfaden bleibt zielgerichtet, und alle erforderlichen Einzelheiten sind weiterhin erreichbar. - Arbeitsabläufe, Prüflisten, Beispiele, Alternativen und Fehlerbehebung sind dort vorhanden, wo sie benötigt werden. - Reale Aufgaben bestätigen die Anleitung. - Katalog, Entwicklungsplan, Archivautomatisierung und Paketveröffentlichungsdaten bleiben konsistent. Verbessere vorzugsweise eine vorhandene Fähigkeit, statt ein beinahe gleiches Duplikat hinzuzufügen. Bevorzuge einen vollständigen Arbeitsablauf mit funktionierender Rückkopplungsschleife gegenüber vielen oberflächlichen Beispielen. Wenn eine Kennzahl mit Klarheit oder Richtigkeit kollidiert, bewahre die nützliche Entscheidungshilfe und dokumentiere, warum die Kennzahl kein geeigneter Stellvertreter war.