ctxrs/ctx

ctx Agentenverlaufssuche

Verwende ctx, wann immer du auf frühere Sitzungen von Codierungsagenten verweisen musst. Diese Transkripte können Benutzerabsichten, Entscheidungen, Zeitpläne früherer Arbeiten, frühere Versuche sowie Informationen darüber enthalten, was funktioniert hat oder fehlgeschlagen ist.

Verwende dieses Skill in zwei Modi:

• Abruf vor der Arbeit, wenn frühere Sitzungen Entscheidungen, Befehle, Fehler oder Zitate enthalten können, die die aktuelle Aufgabe betreffen;
• Historische Forschungsberichte, wenn der Benutzer einen Agenten oder einen schreibgeschützten Unteragenten beauftragt, ein historisches Thema in früheren lokalen Agentensitzungen zu recherchieren.

Voraussetzungen

• Das ctx CLI muss installiert und eingerichtet sein. Falls es fehlt und die Installation von Tools für die Aufgabe angemessen ist, installiere es mit:

  curl -fsSL https://ctx.rs/install | sh
  

• Die erste Einrichtung kann Zeit in Anspruch nehmen, während ctx vergangene Sitzungen indiziert. Lasse es bei Bedarf im Hintergrund oder in tmux laufen oder warte, bis es abgeschlossen ist.

• Wenn ctx nicht verfügbar ist, teile mit, dass die lokale Verlaufssuche nicht verfügbar ist, und erfinde keine Ergebnisse.

Arbeitsablauf

1. Bestätige, dass ctx bereit ist, wenn du von einem leeren Kontext aus startest:

   ctx status
   ctx sources
   

   Verwende ctx status --format json oder ctx sources --format json nur, wenn ein Skript genaue Felder benötigt.

2. Suche zuerst mit normaler Sprache. Füge bei Bedarf Begriffe oder Filter hinzu:

   ctx search "<Abfrage>"
   ctx search "<Abfrage>" --refresh off
   ctx search "<Abfrage>" --provider codex
   ctx search "<Abfrage>" --workspace <workspace>
   ctx search "<Abfrage>" --file <pfad>
   ctx search "<Abfrage>" --since 30d
   ctx search "<Abfrage>" --term "<verwandter Begriff>" --term "<Fehlertext>"
   ctx search "<Abfrage>" --session <ctx-sitzungs-id>
   ctx search "<Abfrage>" --verbose
   

   Verwende die Standardtextausgabe zum Lesen durch den Agenten. Füge --format json für die Suche oder Anzeige nur hinzu, wenn du die Ausgabe an jq oder ein Skript weiterleitest oder genaue maschinenlesbare Felder benötigst. JSON-Ausgaben sind wesentlich größer und können schnell den Kontextfenster verbrauchen.

   Wenn die Eingabeaufforderung nach einem Themenverlauf oder Bericht über mehrere Sitzungen fragt, führe mehrere ctx search-Abfragen mit unterschiedlichen Formulierungen und Filtern durch, um vielversprechende Sitzungen zu finden. Verwende die eingeschränkte ctx search "<Abfrage>" --session <ctx-sitzungs-id>, wenn eine Sitzung relevant erscheint und du dichte Übereinstimmungen auf Ereignisebene aus dieser Sitzung benötigst.

   Die Standardsuche gibt primäre Agentensitzungen zurück, sodass menschliche Absichten und Entscheidungen prominent bleiben. Verwende --include-subagents, wenn Implementierungsdetails, Code-Review-Notizen, Testausgaben oder Fehlerverfolgungen aus Unteragentensitzungen wahrscheinlich relevant sind.

   Verwende --verbose, wenn du vollständige ctx-IDs, Provider-IDs, Zitate und kopierbare Folge-Befehle benötigst, ohne zu JSON wechseln zu müssen.

   Du kannst ein Sitzungstranskript in eine temporäre Datei schreiben, die Dateigröße überprüfen und dann die relevanten Teile lesen:

   ctx show session <ctx-sitzungs-id> --format markdown --out /tmp/ctx-sitzung.md
   wc -c /tmp/ctx-sitzung.md
   

   In Codex schließt ctx standardmäßig den aktiven Sitzungsbaum aus, wenn CODEX_THREAD_ID verfügbar ist, damit die aktuelle Eingabeaufforderung und Unteragenten den historischen Abruf nicht dominieren. Verwende --include-current-session nur, wenn der aktive Sitzungsbaum das Ziel ist.

3. Überprüfe relevante Ergebnisse, bevor du dich auf sie verlässt:

   ctx show event <ctx-ereignis-id> --window 5
   ctx show session <ctx-sitzungs-id>
   

4. Finde das ursprüngliche Provider-Material, wenn die Quellenidentität oder Resume-Hinweise wichtig sind. provider_session_id ist die Codex-Resume-UUID:

   ctx locate event <ctx-ereignis-id>
   ctx locate session <ctx-sitzungs-id>
   

5. Schreibe ein Transkript relevanter Sitzungen, wenn du, der Mensch oder ein anderer Agent eine Datei benötigt:

   ctx show session <ctx-sitzungs-id> --format markdown --out <ausgabepfad>
   

Wenn die Suche eingegrenzt werden muss

Variiere die Abfrage und verwende Suchfilter, bevor du Schlussfolgerungen ziehst. Nützliche Folgemaßnahmen umfassen dichte Ereignissuche, sitzungsspezifische Suche und Überprüfungen des Quellenorts:

ctx search "<Abfragevariante>" --events --refresh off
ctx search "<Abfrage>" --session <ctx-sitzungs-id> --refresh off
ctx search "<Abfrage>" --include-subagents --refresh off
ctx show event <ctx-ereignis-id> --window 5
ctx show session <ctx-sitzungs-id>
ctx locate event <ctx-ereignis-id>
ctx locate session <ctx-sitzungs-id>

Die Ergebnisfenster der Suche sind begrenzt. Beanspruche keine genauen korpusweiten Zählungen oder eine vollständige Prüfung anhand der Anzahl der zurückgegebenen Treffer. Wenn die angeforderte Schlussfolgerung nicht durch Suche, Anzeige und Ortungsnachweise gestützt werden kann, gib diese Einschränkung an und berichte stattdessen über die stärksten abgerufenen Beweise.

Für erweiterte Abfragen oder eine vollständige deterministische Ereignisaufzählung verwende ctx list events. Lese die vollständige Dokumentation zu Filtern, Bereichen, Cursorn und Ausgabe vor der Verwendung:

ctx docs show event-queries

Historische Forschungsberichte

Wenn du gebeten wirst, ein historisches Thema zu recherchieren, bleibe schreibgeschützt, es sei denn, der Benutzer bittet auch um Bearbeitungen. Der Agent schreibt den Bericht; ctx ruft nur lokales Quellmaterial ab.

1. Formuliere das Thema, den Umfang und die gewünschte Länge neu, wenn die Eingabeaufforderung mehrdeutig ist. Bevorzuge standardmäßig prägnante Berichte; verwende einen längeren Bericht, wenn der Benutzer nach Chronologie, Alternativen oder detaillierten Beweisen fragt.

2. Führe mehrere gezielte Suchen durch. Variiere die Abfragebegriffe über Benutzerformulierungen, Datei- oder Modulnamen, Fehlertexte, Befehle, Branchnamen und Entscheidungsbegriffe hinweg. Beginne mit ctx search "<Thema>", erweitere dann mit --term oder grenze ein mit --workspace, --provider, --file, --since, oder --session <ctx-sitzungs-id>. Verwende --include-subagents, wenn Reviews, Implementierungsversuche, Testausgaben oder Fehlerverfolgungen wahrscheinlich in delegierten Sitzungen vorhanden sind. Füge --refresh off hinzu, wenn der Bericht den lokalen ctx-Index nicht aktualisieren darf.

3. Überprüfe die fokussierten Quellen, bevor du Schlussfolgerungen ziehst. Bevorzuge ctx show event für einen Treffer plus nahegelegene Turns und ctx show session, wenn der gesamte Sitzungsbogen wichtig ist:

   ctx show event <ctx-ereignis-id> --window 5
   ctx show session <ctx-sitzungs-id>
   

   Verwende den vollständigen oder Protokollmodus nur, wenn die Standardausgabe notwendige Beweise auslässt.

4. Vergleiche Beweise über Sitzungen hinweg. Notiere Übereinstimmungen, Konflikte, veraltete Ergebnisse und Lücken, in denen Suchen keine Beweise gefunden haben.

5. Erstelle den Bericht als Agentensynthese mit Zitaten.

Prägnante Berichtsform:

• Antwort oder Ergebnis;
• stärkste unterstützende ctx-IDs;
• wichtige Einschränkungen oder Lücken;
• optionaler nächster Such- oder Verifizierungsschritt.

Lange Berichtsform:

• Frage und Umfang;
• Suchmethode, einschließlich wichtiger Abfragen und Filter;
• Ergebnisse oder Chronologie;
• Beweistabelle mit Provider, ctx-Sitzungs-ID, ctx-Ereignis-ID (sofern verfügbar) und warum jede Quelle wichtig ist;
• Konflikte, Lücken und empfohlene Folgemaßnahmen.

Zitierregeln

• Zitiere ctx-Material, wenn es deine Antwort oder Implementierung beeinflusst.
• Füge den Provider, die ctx-Sitzungs-ID, die ctx-Ereignis-ID (sofern verfügbar) und die Provider-Sitzungs-ID (sofern verfügbar) hinzu.
• Wenn du über mehrere Ausschnitte hinweg synthetisierst, kennzeichne die Schlussfolgerung als deine Synthese und zitiere die unterstützenden Ausschnitte.
• Wenn ein zitiertes Ereignis oder eine Sitzung in der aktuellen Core-Generation fehlt, teile dies mit und erwäge, ob ein expliziter ctx import angemessen ist.

Sicherheitsregeln

• Bevorzuge Textausgabe zum Lesen durch den Agenten. Verwende JSON nur für Skripte, jq oder die genaue Feldextraktion und halte JSON-Ausgaben klein.
• Sage nicht, dass ctx eine Entscheidung abgeleitet hat, es sei denn, der zitierte Text gibt diese Entscheidung explizit an.
• Gib nicht an, dass ctx eine Modellanalyse geschrieben hat.
• Füge keine rohen Transkripte, großen JSON-Nutzlasten, Geheimnisse, Tokens oder privaten Pfade in einen benutzerorientierten Bericht ein. Fasse die überprüften Beweise zusammen und zitiere nur kurze Auszüge, die zur Untermauerung einer Behauptung erforderlich sind.
• Behandle ~/.ctx, Provider-Transkriptpfade und JSON-Ausgaben als private lokale Verlaufsdaten, es sei denn, der Benutzer bittet explizit darum, überprüfte Auszüge zu teilen.