ebursztein/agent-skills

Realm-Authoring

Ein Realm sagt einem Agenten, wann er im Dienst ist, was als Nächstes zu tun ist und woran er erkennt, dass es funktioniert hat. Gib dieser Disziplin eine einprägsame Fraktionsstimme.

Vor dem Schreiben

Lies die Zielanleitung und die Trigger-Tabelle der Charta. Bewahre die vereinbarte Zuständigkeit der Fraktion und grenze sie von benachbarten Realms ab. Arbeite von realen Entwicklungssituationen, die der Benutzer behandelt haben möchte. Nenne erkennbare Techniken: „Mocks, Stubs und Fakes“ hilft bei der Auffindbarkeit mehr als nur „kontrollierte Doubles“.

Auswahl in das Haupt-Skill aufnehmen

Die Haupt-SKILL.md von realms-of-code besitzt die Entscheidung, wann welcher Realm verwendet wird. Ihre Tabelle muss es einem Agenten ermöglichen, vor dem Laden einer Anleitung zu wählen. Verwende konkrete Situationen: Testen von Dateilöschung, Auswahl eines API-Standards oder Absichern einer Query-Count-Verbesserung. Halte Trigger dort einmalig fest, anstatt sie in jeder Anleitung zu wiederholen.

Best Practices in die Realm-Anleitung aufnehmen

• Name, Disziplin, Motto: eine Überschrift, eine konkrete Zuständigkeitszeile und das Motto.
• Die Überlieferung: ein kurzer, lebendiger Absatz, der die Fraktion mit ihrer ingenieurtechnischen Rolle verbindet. Die Metapher soll die Arbeit erklären.
• Axiome: einige wenige kompakte Grundsätze, die Entscheidungen leiten. Bewahre bei der Überarbeitung eines bestehenden Realms etablierte Verpflichtungen.
• Was zu tun ist: praktische Schritte, die mit Verben beginnen. Lege fest, was zu inspizieren oder zu ändern ist, wie ein Ansatz gewählt wird und was zu verifizieren ist. Verwende explizite Techniknamen und greife auf die Werkzeuge des Projekts zurück. Erkläre sinnvolle Alternativen und Fallen.
• Beweise: das beobachtbare Ergebnis oder Artefakt, das die Erledigung belegt, sowie jede wichtige Einschränkung dessen, was dieser Beweis aussagt.

Axiome erklären das Urteil; Schritte machen es ausführbar. Vermeide es, denselben Rat in beiden Bereichen zu wiederholen. Halte jeden Abschnitt so kurz, wie es seine Aufgabe erlaubt. Realm-Referenzdateien sind reines Markdown: keine IDs, doppelte YAML-Felder, Herkunftsetiketten von Mottos oder Attributionsgerede. Nur eine auffindbare SKILL.md benötigt Skill-Frontmatter.

Ausgearbeitete Korrektur

Für die Gesichtslosen ist „Abhängigkeiten kontrollieren“ zu abstrakt. Ein nützlicher Trigger ist „Testen eines Jobs, der Dateien löscht oder einen externen Zahlungsdienst aufruft.“ Die nächste Aktion ist, diese Grenze zu isolieren, einen Mock/Stub/Fake zu wählen und Erfolgs-, Fehler- und Wiederholungsverhalten ohne unbeabsichtigte Live-Effekte zu üben. Beweise umfassen das beabsichtigte Ziel und den resultierenden Zustand sowie Integrationsnachweise, wo der echte Vertrag von Bedeutung ist. Ein Spion, der immer noch den Live-Dienst aufruft, ist eine Falle, die es zu benennen gilt.

Wenn die companion realms-of-code-Fähigkeit verfügbar ist, ist deren references/realms/faceless-men.md das vollständige ausgearbeitete Beispiel.

Für Arryn gehört „Protokolle auswählen“ in die Haupt-Trigger-Tabelle. Seine Anleitung muss sagen, vorhandene Standards und Technologien zu finden, den aktuellen Wartungs- und Deprecation-Status zu überprüfen, die Lebensfähigkeit zu bewerten, die unterstützte Implementierung wiederzuverwenden und die Interoperabilität zu testen.

Lehre Schutz während der Implementierung: Kodiere wichtige Regeln als Leitplanken (Guardrails) und verifizierte Verbesserungen als Ratschen (Ratchets). Eine Ratsche zeichnet eine reproduzierbare Basislinie auf, weist Regressionen zurück und zieht sich nach einer Verbesserung fester. Zitadelle baut den Schutz auf; Eiserner Bank setzt ihn durch. Löse niemals einen fehlgeschlagenen Check, indem du ihn stillschweigend abschwächst.

Vor der Veröffentlichung prüfen

Probiere zwei realistische Zuordnungsaufgaben und eine nahegelegene Aufgabe aus, die zu einem anderen Realm gehört. Wähle den Realm aus der Haupttabelle, dann identifiziere die erste konkrete Aktion und die erforderlichen Beweise aus seiner Anleitung. Wenn einer der Schritte mehrdeutig bleibt, überarbeite die verantwortliche Datei. Vermeide pauschale Tore, die nichts mit der Aufgabe zu tun haben.

Halte das Flair in einem Motto, einer Überlieferung und gelegentlichen Arbeitsphrasen wie „Was sagen wir zu Bugs? Nicht heute.“ lebendig. Verbinde es mit nützlicher ingenieurtechnischer Anleitung. Entferne Wörter, die weder eine Entscheidung noch Charakter hinzufügen. Folge dem Veröffentlichungsworkflow des Repositorys und überprüfe relative Links sowie die Auffindbarkeit der Fähigkeit, wenn davon betroffen.