Agentenfähigkeiten aus der Projektdokumentation erstellen und aktuell halten

## Vor dem Bearbeiten klären, wer eine Fähigkeit pflegt Bestimme vor dem Erstellen oder Aktualisieren von Dateien, wer für jede Fähigkeit zuständig ist. Verwende erzeugte Fähigkeiten für Projekte, die Dokumentation bereitstellen, aber kein Paket mit Agentenfähigkeiten pflegen, abgeglichene Fähigkeiten für Projekte, die bereits eigene Fähigkeiten bereitstellen, und handgeschriebene Fähigkeiten für bewusst zusammengestelltes Fachwissen. Vermische diese Arbeitsabläufe nicht. Erzeugte Fähigkeiten werden aus Dokumentation zusammengeführt, abgeglichene Fähigkeiten aus ihrer vorgelagerten Fähigkeitsquelle kopiert und handgeschriebene Fähigkeiten bleiben unangetastet, sofern die Aufgabe sie nicht ausdrücklich einschließt. ## Aus der Dokumentation nur übernehmen, was dem Agenten bei Aufgaben hilft Konzentriere dich auf Fähigkeiten, Entscheidungspunkte, praktische Nutzungsmuster, funktionsfähige Beispiele und die Umstände, unter denen ein Agent einen Ansatz einem anderen vorziehen sollte. Bevorzuge Wissen, das die Aufgabenausführung spürbar verbessert. Lasse an Anwender gerichtete Einführungen, Installationsanleitungen, allgemeines Einstiegsmaterial, Werbetexte und Konzepte aus, die ein leistungsfähiges Modell bereits zuverlässig beherrscht. Formuliere das Quellenmaterial neu und führe es zusammen, statt die Dokumentation wortwörtlich zu kopieren. Halte die Fähigkeit kompakt. Erstelle nur die Referenzdateien, die für unterschiedliche Konzepte erforderlich sind, vermeide überflüssige Dateien und erkläre sowohl die Funktionsweise eines Musters als auch, warum oder wann es verwendet werden sollte. ## Ein neues Projekt im Projektverzeichnis eintragen und seine Fähigkeit erzeugen Füge eine neue erzeugte Quelle in das maßgebliche Projektverzeichnis des Projektarchivs ein, einschließlich ihres Quellorts und einer beständigen Projektkennung. Richte die Quelle über den unterstützten Arbeitsablauf des Projektarchivs ein oder gleiche sie darüber ab, statt eine nicht nachverfolgte lokale Kopie anzulegen. Lies die Projektdokumentation und alle projektspezifischen Erzeugungsanweisungen so vollständig, dass du die Fähigkeiten und Konventionen des Projekts verstehst. Gliedere das nützliche Material in Kategorien wie Grundkonzepte, Funktionen, bewährte Vorgehensweisen und fortgeschrittene Arbeitsabläufe. Erstelle das Ausgabeverzeichnis, dessen Name mit der registrierten Kennung der erzeugten Quelle übereinstimmt. Verfasse die Referenzdateien, erstelle die Fähigkeitsübersicht und erfasse Erzeugungsmetadaten mit der exakten Quellenrevision. ## Erzeugte Fähigkeiten nur dort aktualisieren, wo sich die Dokumentation geändert hat Lies die in den Erzeugungsmetadaten erfasste Quellenrevision und vergleiche sie mit der aktuellen Quelle. Beschränke den Quellenvergleich auf den Dokumentationsbereich, der für die erzeugte Fähigkeit maßgeblich ist. Aktualisiere nur die von diesem Unterschied betroffenen Referenzdateien und erneuere anschließend bei Bedarf die Projektversion, das Erzeugungsdatum, die Themenübersicht und die Beschreibungen in der Fähigkeitsübersicht. Bewahre nicht betroffene Referenzdateien und vermeide es, sachfremde Inhalte nur deshalb neu zu erzeugen, weil sich das Quellenarchiv weiterentwickelt hat. Ersetze nach der Prüfung die erfasste Revision durch die exakte Revision, die für die Aktualisierung verwendet wurde, damit der nächste Vergleich auf einer verlässlichen Grundlage beruht. ## Von der Ursprungsstelle gepflegte Fähigkeiten kopieren, ohne sie von Hand zu ändern Ermittle bei einer von der Ursprungsstelle gepflegten Fähigkeit anhand des Projektverzeichnisses, welche Quellfähigkeit kopiert und welcher Ausgabename verwendet werden soll. Der Ausgabename kann absichtlich vom Namen des Ursprungsverzeichnisses abweichen; leite ihn daher niemals allein aus dem Quellnamen ab. Kopiere beim ersten Import den eingerichteten Fähigkeitsbaum und erfasse die Ursprungsrevision in den Abgleichmetadaten. Vergleiche bei Aktualisierungen die erfasste Revision mit dem aktuellen Fähigkeitsverzeichnis der Ursprungsstelle, kopiere nur die eingerichteten geänderten Dateien und schreibe die erfasste Revision fort. Verändere den Inhalt abgeglichener Fähigkeiten niemals von Hand. Gib Korrekturen an die zuständige Ursprungsstelle weiter und übernimm sie über den Abgleichsablauf, damit lokale Kopien nicht vom Ursprung abweichen. ## Eine kurze Übersicht mit Links zu jeder Referenzdatei schreiben Statte die Fähigkeitsübersicht mit einem gültigen Metadatenkopf aus, der einen kleingeschriebenen Namen mit Bindestrichen, eine knappe Fähigkeitsbeschreibung, Herkunftsmetadaten, das Erzeugungs- oder Abgleichdatum und die maßgebliche Werkzeug- oder Projektversion enthält. Füge einen kurzen Orientierungsabsatz hinzu und ordne die Referenzdateien anschließend in klare Kategorien ein. Gib für jedes Thema eine kurze Beschreibung und einen relativen Verweis auf die zugehörige Referenzdatei an, damit ein Agent nur das für die aktuelle Aufgabe erforderliche Material laden kann. Halte die Übersicht knapp und auf die Navigation ausgerichtet. Wiederhole darin weder den vollständigen Inhalt der Referenzdateien noch Einträge für nicht vorhandene Dateien. ## In jeder Referenzdatei nur ein praktisches Thema behandeln Statte jede Referenzdatei mit einem Metadatenkopf aus, der einen beständigen Namen und eine gezielte Beschreibung enthält, gefolgt von einem klaren Konzepttitel. Behandle pro Datei eine zusammenhängende Fähigkeit oder einen zusammenhängenden Arbeitsablauf, statt sachfremde Funktionen zu verbinden. Nimm praktische Nutzungshinweise, funktionsfähige Codebeispiele bei ausführbaren Konzepten, wichtige Einschränkungen und die Begründung für empfohlene Muster auf. Lasse Hintergrundinformationen weg, die einem Agenten weder bei einer Entscheidung noch bei deren Umsetzung helfen. Schließe mit Quellenangaben ab, die die zur Zusammenführung der Inhalte verwendete Dokumentation benennen. Halte diese Angaben nachvollziehbar, ohne die Fähigkeit zu einer Kopie des Quellenmaterials zu machen. ## Quellrevision und Datum jeder Fähigkeit festhalten Erfasse bei erzeugten Fähigkeiten den Quellort, die exakte Quellenrevision und das Erzeugungsdatum. Erfasse bei abgeglichenen Fähigkeiten den Ort der Ursprungsfähigkeit, die exakte Ursprungsrevision und das Abgleichdatum. Halte die Version der Fähigkeitsübersicht mit dem tatsächlichen Quellenstand im Einklang und verwende gemäß den Richtlinien des Projektarchivs das Datum der letzten Erzeugung oder des letzten Abgleichs. Gib keine neuere Projektversion oder Revision an als jene, von der die Inhalte abgeleitet wurden. Behandle das Projektverzeichnis als maßgebliche Liste der unterstützten Projekte und Quellorte. Vermeide es, veränderliche Projektarchiv-URL oder Zuständigkeitszuordnungen über mehrere Fähigkeitsdateien hinweg zu duplizieren, wenn das Projektverzeichnis bereits dafür maßgeblich ist. ## Die letzten Änderungen auf kaputte Links und veraltete Revisionen prüfen Bestätige vor dem Abschluss, dass Quelleneinordnung, Eintrag im Projektverzeichnis, Regel für Ausgabenamen, Verweise in der Fähigkeitsübersicht, Metadatenköpfe der Referenzdateien, Kategoriegliederung, Revisionsmetadaten und Quellenangaben übereinstimmen. Prüfe, dass erzeugte Inhalte zusammengeführt und nicht kopiert wurden, abgeglichene Inhalte keine manuellen Abweichungen aufweisen, handgeschriebene Fähigkeiten nicht außerhalb des Aufgabenbereichs verändert wurden und jede Referenzdatei einen eigenständigen Nutzen für Agenten bietet. Prüfe den abschließenden Änderungsvergleich auf sachfremde Dateien, zu viele Referenzdateien, veraltete Versionen, fehlende Beispiele, ungültige Verweise und nicht erfasste Quellenänderungen. Melde jede Einschränkung der Quelle oder der Werkzeuge, die eine vollständige Erzeugung oder einen vollständigen Abgleich verhindert hat.