CommunitySchreiben & Editierengithub.com

Cues — die nächsten Vokabeln des Nutzers vorhersagen

Diese Fähigkeit schreibt bei jeder inhaltlich relevanten Nutzeräußerung eine `.cues/CUES.md`-Datei, die das nächste Fachvokabular, Wissen und Textalternativen vorhersagt. Sie läuft als Hintergrundaufgabe parallel zur Chat-Antwort.

Was ist Cues — die nächsten Vokabeln des Nutzers vorhersagen?

Cues ist eine eigenständige Hintergrundfähigkeit für KI-Agenten (wie Claude Code, Cursor oder Codex), die bei jeder inhaltlich relevanten Nutzeräußerung automatisch eine `.cues/CUES.md`-Datei im Projekt schreibt. Diese Datei enthält vorausschauende Hinweise (Cues) zu Fachvokabular, Wissen und Textalternativen, die der Nutzer als nächstes wahrscheinlich benötigt. Die Cues werden von der OpenCues-Laufzeitumgebung beim nächsten Neuladen geladen und dem Nutzer während des Tippens angezeigt – als Wortvorschläge, Satzumschreibungen oder Tipps mit Fakten, Entscheidungshilfen und Fallstricken. Die Fähigkeit arbeitet in zwei Modi: INITIAL (Datei fehlt: breite Vorhersage von 15–20 Wortfamilien) und CONTINUATION (Datei existiert: strikte Ergänzung, ohne bereits vorhandene Quellen zu löschen, es sei denn, der Nutzer wechselt das Thema). Sie verwendet ein Drei-Band-Prioritätsmodell (85–90 aktiv, 65–80 angrenzend, 50–60 kürzlich erledigt) und demotiviert Quellen systematisch anhand der neuen Nutzeräußerung. Die Cues sind in drei Arten unterteilt: Tipps (bevorzugt – statisches Einzeilenwissen), Wort-Cues (Alternativen zu einem Begriff) und Satz-Cues (Umformulierungen ganzer Sätze). Die Fähigkeit darf nur übersprungen werden, wenn (a) die Nutzeräußerung keinem Fachgebiet zugeordnet werden kann (z. B. nur „Danke“ oder „Ok“), (b) der Nutzer direkt nach dem Cues-System selbst fragt oder (c) der Nutzer explizit um Stopp bittet. Jeder Themenwechsel löst einen frischen Schreibvorgang für das neue Gebiet aus.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/opencues/opencues/tree/HEAD/defaults/skills/cues

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Cues — die nächsten Vokabeln des Nutzers vorhersagen?

Sie sitzen neben einem Nutzer, der durch ein Gespräch ein neues Fachgebiet entdeckt. Er entwirft, baut oder verfasst etwas. Ihr Nebeneffekt ist eine Datei – .cues/CUES.md – die die OpenCues-Laufzeitumgebung bei ihrem nächsten Neuladen lädt und nutzt, um Alternativen, Umformulierungen und Tipps einzublenden, während der Nutzer tippt.

Zusätzlich zu Ihrer Chat-Antwort ausführen, nicht stattdessen

Dies ist eine Nebeneffekt-Fähigkeit. Sie koexistiert mit dem, worum der Nutzer Sie tatsächlich gebeten hat. Wenn er sagt „Ich entwerfe eine E-Mail an X – hilf mir“, antwortet Ihre Chat-Antwort mit dem E-Mail-Entwurf UND Ihr Nebeneffekt schreibt .cues/CUES.md mit Vorhersagen für zukünftige E-Mails dieser Art. Wenn er sagt „Ich baue eine Website“, stellt Ihre Chat-Antwort klärende Fragen UND Ihr Nebeneffekt schreibt .cues/CUES.md mit Vorhersagen seines Vokabulars.

Die Chat-Aufgabe und der Cue-Nebeneffekt sind unabhängig. Die Cue-Datei ist NIEMALS das sichtbare Arbeitsergebnis des Nutzers – sie lebt auf der Festplatte, um von der Laufzeitumgebung still geladen zu werden. Wenn Sie die Datei weglassen, weil „ich habe ihnen bereits im Chat geholfen“, verletzen Sie den Vertrag der Fähigkeit. Tun Sie beides.

Die einzige Erwähnung der Datei ist die einzelne Klammerzeile am Ende Ihrer Chat-Antwort. Sie überfrachtet die Chat-Ausgabe nicht.

Das Produkt ist die Vorhersage. Ein Cue, der eintrifft, nachdem der Nutzer das Wort bereits getippt hat, ist zu spät. Der Maßstab ist: Wenn der Nutzer in seiner nächsten Äußerung ein neues Wort einführt, sollte es BEREITS durch etwas abgedeckt sein, das Sie in dieser Äußerung geschrieben haben.

Zwei Modi

Bevor Sie irgendetwas tun, lesen Sie .cues/CUES.md. Dessen Existenz bestimmt den Modus:

  • INITIAL (Datei fehlt) – sagen Sie die gesamte Vorhersageoberfläche für die Aufgabe von Grund auf voraus.
  • CONTINUATION (Datei existiert) – erweitern Sie die Oberfläche. Lesen Sie die vorhandene Datei zuerst; Ihre Ausgabe ist eine strikte Obermenge.

STRICTE ERWEITERUNG (nur CONTINUATION)

Jede Quelle, die bereits in der Datei vorhanden ist, MUSS in Ihrer Ausgabe erscheinen – gleicher Name, gleiches match:, gleicher Text – ES SEI DENN, der neue Gesprächskontext widerspricht ihr direkt (der Nutzer ist umgeschwenkt, hat den Abschnitt aufgegeben usw.). Sie können:

  • Prioritäten von Quellen erhöhen, die jetzt im aktiven Fokusband liegen.
  • Prioritäten von Quellen senken für Abschnitte, die der Nutzer abgeschlossen hat.
  • Neue Quellen für Vokabeln hinzufügen, die der vorherige Durchlauf zu wenig vorhergesagt hat.

JEDE ÄUSSERUNG NEU SCHREIBEN – nicht „keine Änderung, wenn nichts passiert ist“

Sie MÜSSEN bei JEDER inhaltlich relevanten Nutzeräußerung das Write-Tool mit einer vollständig aktualisierten CUES.md aufrufen, selbst wenn sich seit der letzten Äußerung nur wenig geändert hat. Begründung: Der Nutzer hat Ihnen gerade eine neue Nachricht gegeben; diese Nachricht hat den GESPRÄCHS-Schwerpunkt verschoben, auch wenn nur um ein Unterthema. Das aktive Band muss diese Bewegung nachvollziehen. Eine „keine Änderung“-Ausgabe bedeutet, Sie haben entschieden, dass der Nutzer nicht umgeschwenkt ist, was nach einer neuen inhaltlichen Äußerung fast nie zutrifft.

Wenn Sie nach reiflicher Überlegung glauben, dass die neue Nachricht des Nutzers nichts Neues hinzufügt – er hat „Danke“ geantwortet oder eine kurze Folgefrage gestellt, die noch im selben Mikrothema liegt – können Sie das Schreiben überspringen. Aber die Messlatte ist hoch: nennen Sie den spezifischen Grund („Der Nutzer hat eine klärende Frage ausschließlich innerhalb des Themas des aktiven Bands gestellt, ohne neue Untervokabeln“). Das Überspringen ist die Ausnahme, nicht die Regel.

Benchmark-Nachweis (Mai 2026, Judge-Bench): Wenn die Fähigkeit das Überschreiben bei Äußerungen N>1 überspringt, bricht die Aktualität bis Äußerung 3 zusammen, weil das aktive Band auf dem Thema von Äußerung 1 eingefroren bleibt. Jede Äußerung neu zu schreiben hält den Schwerpunkt mit dem Nutzer synchron.

Vorausschau – nennen Sie die nächsten 2-3 Abschnitte, erhöhen Sie Quellen für diese

Bevor Sie Prioritäten vergeben, notieren Sie (mental – nicht in der Datei) die 2-3 Unterthemen, die als NÄCHSTES in diesem Fachgebiet am WAHRSCHEINLICHSTEN kommen, basierend darauf, wo der Nutzer jetzt steht. Prüfen Sie dann: Hat die Oberfläche mindestens eine Quelle bei 75+ für jeden dieser bevorstehenden Abschnitte?

Wenn nicht, erhöhen Sie eine Quelle für die Lücke – entweder eine brandneue ### <id> oder die Anhebung einer vorhandenen mit niedriger Priorität.

Der Punkt ist nicht Sicherheit, sondern Abdeckung. Wenn der Nutzer das Gespräch vorwärts bewegt, sollen seine nächsten 1-2 Abschnitte bereits vorgewärmt sein. Wenn er stattdessen zurückgeht, wird die Nachbearbeitungs-/Herabstufungsregel die Vorausschau-Quellen bei der FOLGENDEN Äußerung als inaktiv markieren – das ist günstig.

Beispiele (benchmark-validierte Fehlermodi Mai 2026):

  • API-Endpunkt schrittweise aufgebaut: bei Äußerung 3 (Fehlerhüllen) ist die wahrscheinliche Äußerung 4 Integrationstests ODER Beobachtbarkeit. Erhöhen Sie mindestens eine Quelle, die vitest|supertest|describe|it|expect ODER logger|telemetry|trace|metric abdeckt, auf 75+.
  • Freiberuflicher Vertrag Klausel für Klausel entworfen: bei Äußerung 3 (IP) ist die wahrscheinliche Äußerung 4 Kündigung / Streitbeilegung / Haftung. Erhöhen Sie mindestens eine Quelle für terminate|notice|kill.fee|dispute|arbitration|liability auf 75+.
  • Website Seite für Seite gebaut: bei Äußerung 2 (Galerie) ist die wahrscheinliche Äußerung 3 Über uns / Kontakt / Shop. Erhöhen Sie Quellen für diese auf 75+.

Die benchmark-validierte Regel: Bei Gesprächen mit mehr als 2 Äußerungen sollte das aktive Band nicht NUR zurückblicken. Mindestens eine Quelle bei 75+ sollte ein plausibles NÄCHSTES Unterthema im Fachgebiet vorhersagen. Wenn Sie nur das spiegeln, was der Nutzer bereits gesagt hat, wird die Oberfläche veralten, sobald er umschwenkt.

Dies ist keine Spekulation über zufällige Abschweifungen. Es ist der Hauptpfad durch das Fachgebiet: Verträge haben Kündigungsklauseln, REST-Endpunkte haben Tests, Websites haben Kontaktseiten, Rezepte haben Anrichteanleitungen. Nennen Sie den offensichtlichen nächsten Abschnitt und wärmen Sie ihn vor.

Herabstufung – beobachtbar, pro Quelle

Wenn der Nutzer ein Unterthema abschließt und zu einem neuen wechselt, MÜSSEN Sie die Priorität der erledigten Quellen senken. Die Frage ist WIE VIEL – und die Antwort ist in der neuen Nachricht des Nutzers beobachtbar, keine Fachgebiets-Entscheidung.

Der Test: Enthält die NEUE Nachricht des Nutzers Vokabeln, die der match:-Regex der vorherigen Quelle treffen würden?

Scannen Sie für jede Quelle, die sich derzeit im aktiven Band 85+ befindet, die neue Nutzernachricht:

  1. Treffer gefunden – der Nutzer bezieht sich noch auf das Vokabular dieser Quelle. Die Quelle ist noch aktiv oder übergreifend für die nächste Äußerung. Leicht herabstufen: von 85 auf 70 fallen. Behalten Sie sie im angrenzenden Band, damit ihre Cues erscheinen, wenn der Nutzer diese Wörter erneut tippt.

  2. Kein Treffer – der Nutzer hat sich von diesem Vokabular entfernt. Die Quelle ist orthogonal erledigt. Stark herabstufen: von 85 auf 50 fallen. Aus der Tabelle nehmen. Verhindert, dass sie mit den wirklich aktiven neuen Quellen um Worttreffer konkurriert.

Standard bei Unsicherheit: STARKE Herabstufung. Benchmark-Nachweis (Mai 2026): Die meisten Themenwechsel sind auf Vokabel-Ebene orthogonal, selbst wenn das übergeordnete Fachgebiet gekoppelt aussieht. Der Standard auf leichte Herabstufung ließ zu viel altes Vokabular im angrenzenden Band, wenn der Nutzer klar umgeschwenkt war (Website-Portfolio: Äußerung 2 über Galerie → Äußerung 3 über Stripe-Zahlungen – das Galerie-Vokabular erscheint NICHT in Äußerung 3; Galerie sollte stark herabgestuft werden, auch wenn beide Äußerungen „über die Website“ sind). Der Preis einer starken Herabstufung einer noch relevanten Quelle ist, dass das Wort des Nutzers überhaupt keinen Cue erhält, wenn er sich darauf zurückbezieht – aber die NEUE Nachricht des Nutzers ist die Bodenwahrheit: wenn er auf das vorherige Vokabular Bezug nimmt, fängt der Regex-Treffer es ein.

Durchgerechnete Beispiele (gegen dieselbe Regel v3.0e):

Vorherige Quelle bei 85Neue Nachricht des NutzersTreffer?Aktion
galerie-layout `match: galleryportfoliogrid`„Jetzt brauche ich eine Kontaktseite mit Stripe…“
jr-pass `match: JR PassShinkansenreserved`„JR Pass es ist. Jetzt Unterkunft…“
kapitänsbinde `match: captainarmbanddifferential`„Verteidiger als nächstes – Trippier oder Gordon“
eigentum `match: templatedifferentialowned`„Gehe Template für Kapitänswahl“

Die Regel ist pro Quelle, nicht pro Äußerung. In einer Äußerung können Sie einige vorherige Quellen stark und andere leicht herabstufen – es basiert darauf, ob das Vokabular jeder einzelnen tatsächlich in der neuen Nutzernachricht auftaucht.

Wenn zwei oder mehr Quellen beide noch treffen – okay, beide gehen auf 70. Das aktive Band bleibt schmal; das angrenzende Band kann mehrere übergreifende Quellen ohne Verwässerung halten.

Drei-Band-Prioritätsmodell

Denken Sie an Priorität wie einen Drei-Band-Schalter:

  • 85–90 – aktiver Fokus (was der Nutzer GERADE JETZT tippt)
  • 65–80 – angrenzend / gleich aktiv werdend / übergreifend / Projekthintergrund
  • 50–60 – kürzlich abgeschlossen orthogonal (bleibt am Leben, konkurriert aber nicht um Treffer)

Wenn Sie mehr als 3 Quellen im Band 85+ haben, stimmt etwas nicht – die meisten sollten bei 65-80 oder 50-60 sein. Das aktive Band sollte SCHMAL sein.

Sie dürfen eine vorherige Quelle NICHT mit der Begründung löschen, „der Nutzer hat sie nicht verwendet.“ Der Nutzer kann gerade darauf zurückgreifen; es ihm unter dem Hintern wegzuziehen, ist der Hauptfehlermodus der Schleife.

Wenn Ihre Ausgabe weniger Quellen hat als die vorherige Datei, haben Sie einen Fehler gemacht. Lesen Sie erneut; kopieren Sie die fehlenden vorwärts.

INITIAL-Modus – breit vorhersagen

Der erste Schreibvorgang ist tragend. Sagen Sie jedes Untervokabular voraus, das der Nutzer plausibel berühren wird – nicht nur das, was er in der Eröffnungsäußerung gesagt hat.

Behandeln Sie die Startnachricht des Nutzers als einen Datenpunkt über einen viel größeren Raum. Aus „Ich baue eine Website für mein Fotografie-Portfolio“ hat der Nutzer EIN Wort genannt, das die Laufzeitumgebung als Cue benötigt (photography); Ihre Aufgabe ist es, die ~15–20 Wortfamilien zu extrapolieren, die jede funktionierende Fotografie-Portfolio-Website berühren wird (Spezialisierungen, Galerie-Layouts, Bildformate, Bereitstellungsziele, Buchungsmechanik, Barrierefreiheit usw.).

Wenden Sie dieselbe Erweiterung unabhängig vom Fachgebiet an. Für „einen Series A Pitch entwerfen“, „Kapitel 3 eines Romans schreiben“ oder „ein Rails-Bereitstellungs-Runbook einrichten“ – lesen Sie die Startnachricht, generieren Sie jedes Untergebiet, in das der Nutzer plausibel tippen wird.

Wenn Sie bei 8 Quellen aufhören, fragen Sie „welches plausible Untervokabular fehlt mir?“ und fahren Sie fort bis 15–20. Breite von Anfang an ist das Produkt der Schleife. Eine Quellenergänzung bei Äußerung 2, die ein Wort abdeckt, das der Nutzer gerade getippt hat, ist ein Versagen bei Äußerung 1.

Die drei Cue-Typen – TIPPS ZUERST, dann Wort-Cues, dann Satz-Cues

OpenCues unterstützt drei Cue-Arten. Tipps sind das wertvollste Ergebnis der Fähigkeit – sie enthalten tatsächliches Wissen (Fakten, Abwägungen, Entscheidungshilfen, Fallstricke), das der Nutzer nicht bereits weiß. Ein Wort-Cue zeigt Alternativen, die der Nutzer hätte brainstormen können; ein Tipp zeigt Informationen, die er nicht hätte.

Prioritätsreihenfolge beim Ausgeben:

  1. Tipps zuerst. Fragen Sie für jeden bemerkenswerten Begriff, den Sie erwähnen würden: „Gibt es eine einzeilige Tatsache / einen Fallstrick / eine Entscheidungshilfe, die ich geben kann?“ Wenn ja – geben Sie einen Tipp aus.
  2. Wort-Cues nur, wenn es mehrere äquivalente Formen gibt, zwischen denen der Nutzer wechseln könnte. Wenn ein Wort eine kanonische Form hat, machen Sie sich nicht die Mühe eines Wort-Cues.
  3. Satz-Cues für Prosa-Oberflächen, die der Nutzer verfasst.

Tipp-Cues – statisches einzeiliges Wissen zu einem Begriff, kein LLM-Aufruf

Nutzer tippt webp, Tipp erscheint: „WebP ergibt ~30% kleinere Dateien als JPEG bei gleicher Qualität.“ Sofort, keine Hin- und Her-Runde. Dies ist die wertvollste Oberfläche, die OpenCues bietet. Jeder Begriff, bei dem der Nutzer von operativem Wissen profitieren würde – nicht nur einem Synonym – verdient einen Tipp.

Wort-Cues – Alternativen für ein hervorgehobenes Wort

Der Standard-Fallback. Nutzer tippt wedding, wechselt zu bridal.

  • Yaml: match: <regex> oder keywords: <Komma-Liste>, plus priority:. Kein scope:-Feld (oder scope: words).
  • Am besten geeignet für: Fachvokabular, das mehrere annähernd äquivalente Formen hat – Register, Formalität, Nischenjargon.
  • Fragen Sie für jeden Begriff, den Sie in eine Alternativenliste setzen: „Verdient dieser Begriff auch einen Tipp-Eintrag?“ Wenn ja – fügen Sie den Tipp ebenfalls hinzu. Die meisten technischen / fachlichen / Eigennamen-Alternativen SOLLTEN einen begleitenden Tipp haben, der erklärt, wann/warum man jede auswählt. Alternativen ohne Tipps sind Vokabular ohne Kontext – halber Wert.

Satz-Cues – einen ganzen Satz in einem anderen Stil umschreiben

Nutzer hat einen Satz geschrieben; Cue bietet drei Umformulierungen davon an.

  • Yaml: scope: sentence, priority: 75–85, description: <eine Zeile>. KEIN match: – Satz-Cues binden an ganze Sätze, nicht an Wörter.
  • Am besten geeignet für: Prosa-Oberflächen. Jede Stelle, an der der Nutzer ganze Sätze verfasst und eine stilistische Alternative wünschen könnte – ob das Dokument „prosalastig“ ist oder nicht. Ein technisches Dokument hat Prosa-Taschen (Endpoint-Zusammenfassungen, Feldbeschreibungen, Runbook-Einleitungen); ein Vertrag hat Prosa-Taschen (Erwägungsgründe); ein Code-Kommentar hat Prosa; eine E-Mail ist größtenteils Prosa. Entscheiden Sie pro Oberfläche, nicht pro Dokumenttyp.

Tipp-Cues – DETAIL (Formate, Taxonomie, Inhaltstypen)

  • Yaml: nur name: (im Quellordner ODER innerhalb des ## Tips-Körpers von CUES.md). Der Text ist ein JSON-Codeblock mit der [{id, words: {word: {tip, alts}}}]-Struktur.
  • Am besten geeignet für: Begriffe, bei denen der Cue eher „hier ist, was Sie wissen sollten“ ist als „hier ist ein Synonym“ – Eigennamen, APIs, Tools, Plattformnamen, technische Primitive, Geschäftsentscheidungen, jurisdiktionelle Besonderheiten.
  • Tipp-Inhaltstypen – gehen Sie über neutrale Fakten hinaus:
    • FAKT – „WebP spart ~30% gegenüber JPEG.“
    • ENTSCHEIDUNGSHILFE – „Bevor Sie Preise schreiben, entscheiden Sie pauschal vs. stündlich vs. pro Sitzung – es ändert die Rahmung.“
    • FALLSTRICK – „Stripe hält Gelder 7 Tage bei neuen Konten.“
    • ABWÄGUNG – „EXIF aus Datenschutzgründen entfernen ODER für Kunstmetadaten behalten. Zielgruppenabhängig.“
    • REFERENZ – „Siehe cloudflarepages.com/docs für Limits.“ Mischen Sie diese. Ein reines Faktentipp-Paket ist schlechter als ein gemischtes Paket.

Regel zur Auswahl pro Oberfläche

Fragen Sie für jedes Thema, das Sie ausgeben würden, welche Oberfläche es abdeckt – und prüfen Sie immer zuerst die Tipp-Cue-Option:

Begriff, bei dem der Nutzer von einer einzeiligen FAKT / ABWÄGUNG / ENTSCHEIDUNGSHILFE / FALLSTRICK profitieren würde → Tipp-Cue (BEVORZUGT)
Begriff + hat einen Tipp UND hat mehrere äquivalente Formen → Tipp-Cue MIT alternativen:
                                                          (gibt dem Nutzer beides)
einzelner Begriff mit mehreren äquivalenten Formen (kein nützlicher Tipp) → Wort-Cue
Prosa, die der Nutzer verfasst (jede Länge, jedes Dokument) → Satz-Cue
sonst → überspringen

**Ein Tipp-Cue-Eintrag kann auch tragen

[Fortsetzung auf Anfrage]

Verwandte Skills