Communitygithub.com

zehuichan/vibe-harness

Verwenden beim Schreiben oder Ändern einer modellseitigen Werkzeugdefinition (Name, Beschreibung, Parameterschema oder deren System-Prompt-Abschnitt) sowie beim Entwerfen von Skills, Kontextladen oder mehrstufigen Agenten-Workflows, um Informationen auffindbar zu machen und Kontext effizient zu nutzen.

Was ist vibe-harness?

Dieser Skill bietet Leitlinien zur Gestaltung der Benutzererfahrung für KI-Modelle und Agenten. Er hilft Entwicklern, die Interaktion zwischen Modell und Werkzeugen zu optimieren, indem Kontext minimiert, kritisches Wissen sichtbar gemacht und die Auffindbarkeit von Informationen verbessert wird. Der Fokus liegt darauf, dass Modelle schnell verstehen können, welche Aktionen verfügbar sind, welche Einschränkungen gelten und wie sie bei Bedarf auf detaillierte Anleitungen zugreifen können. Der Skill ist für Plattformen wie Claude Code, Cursor und Codex konzipiert und unterstützt sowohl die Definition von Werkzeugen als auch die Erstellung von Skills und Agentenanweisungen. Er funktioniert durch klare Prinzipien: Starten mit minimalem Kontext, explizite Auffindbarkeit, sichtbare kritische Einschränkungen, begrenzte Ausgaben und die Vermeidung von Redundanz in Tool-Definitionen. Die Dokumentation enthält konkrete Beispiele, wie Parameterregeln direkt auf den Parameter geschrieben werden, statt sie im Tool-Beschreibungstext zu wiederholen, und wie Skills so gestaltet werden, dass die Beschreibung als Auslöser dient, während der Hauptinhalt die Umsetzung beschreibt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/zehuichan/vibe-harness/tree/HEAD/skills/agent-experience

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Agentenerfahrung

Gestalten Sie, was ein Modell sieht, damit es findet, was es braucht, sicher handelt und Kontext für die Aufgabe spart. Dies ist eine Leitlinie, keine Checkliste.

  • Mit minimalem Kontext beginnen: zuerst Zweck, verfügbare Aktionen und Einschränkungen offenlegen; detaillierte Anweisungen erst bei Bedarf laden.
  • Auffindbarkeit explizit machen: jede verzögerte Ressource benötigt eine klare Beschreibung und eine zuverlässige Methode, sie abzurufen.
  • Kritische Einschränkungen sichtbar halten: Berechtigungen, destruktive Effekte und erforderliche Validierungen erscheinen vor der relevanten Aktion.
  • Begrenzte Ausgaben bevorzugen: präzise Ergebnisse mit Identifikatoren oder Pfaden zum Abrufen von Details zurückgeben; vermeiden Sie das Ausgeben vollständiger Logs oder Dokumente.
  • Lokalität nutzen: eine begrenzte Menge wahrscheinlich benötigter benachbarter Kontext mit einem Operationsergebnis einfügen. Beispiel: eine Thread-Antwort mit einigen vorhergehenden Nachrichten ausliefern. Auslassungen und Kürzungen explizit kennzeichnen und eine Möglichkeit zum Abrufen weiterer Informationen bereitstellen.
  • Gesamtaufwand bewerten: Kontext zu sparen ist nur sinnvoll, wenn es nicht zu mehr Suchvorgängen, wiederholten Lesevorgängen oder Fehlern führt.

Werkzeugdefinitionen

  • Offensichtliche Einschränkungen entfernen. Regeln weglassen, die das Modell aus dem Aufrufergebnis lernt, z. B. dass eine fehlende Datei beim Lesen fehlschlägt oder eine fehlgeschlagene Sendung nicht zugestellt wird.
  • Verhalten beschreiben, nicht Implementierung. Angeben, was das Werkzeug tut und zurückgibt; interne Mechanismen, Ausgabemarkierungen, die das Modell in Ergebnissen sieht, und Durchsetzungsdetails weglassen.
  • Parameterregeln auf den Parameter schreiben. Standardwerte, Bereiche, Paarungen und Regeln zum Setzen gehören in die Beschreibung oder das Schema dieses Parameters; eine Beschreibung, die sich mit der Konfiguration ändert, deutet meist darauf hin, dass der variable Teil zu einem Parameter gehört.
  • Jede Tatsache einmal nennen. Die Werkzeugdefinition nicht in ihrem System-Prompt-Abschnitt, eine Parameterbeschreibung nicht in der Werkzeugbeschreibung und die Regeln eines Werkzeugs nicht in einem anderen Werkzeug wiederholen.
  • Die Änderung messen. Prompt-Tokens des ersten Schritts vor und nach einer Änderung der Werkzeugdefinition vergleichen.

Skills und Agentenanweisungen

  • Die Beschreibung ist der Auslöser. Die Beschreibung eines Skills gibt an, wann er verwendet werden soll, in den Worten, die ein Benutzer oder eine Aufgabe verwenden würde; der Hauptteil beschreibt das Wie.
  • Einstiegsdatei kurz halten und Details verlinken. Workflow und Leitplanken in die Skill-Datei schreiben; Kalibrierungsbeispiele und lange Referenzen in Dateien auslagern, die bei Bedarf geladen und direkt von der Einstiegsdatei verlinkt werden.
  • Geltungsbereichsgrenzen explizit angeben. Formulierungen wie „Leitlinie, keine Checkliste“ oder „Ergebnisse melden, ohne zu bearbeiten“ ändern, wie ein Modell den Workflow anwendet.
  • Auf die Quelle der Wahrheit verweisen. Anweisungen verlinken auf das zugehörige Dokument, statt es neu zu formulieren, damit sie nicht abweichen.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Verwandte Skills