CommunityCodierung & Entwicklunggithub.com

BreakingGap

Nutze eine kurze Wartezeit, während ein KI-Agent arbeitet, für einen nützlichen menschlichen Schritt in der aktuellen Arbeit, einer unerledigten Aufgabe oder einem relevanten Lernerlebnis – mit einem Checkpoint und einer einfachen Rückkehr.

Was ist BreakingGap?

BreakingGap ist eine Fähigkeit für KI-Assistenten (z. B. Claude Code, Cursor, Codex), die dem Menschen einen kleinen, sinnvollen Beitrag während der Wartezeit auf die Agentenausführung ermöglicht. Sie eignet sich für Situationen wie „Was kann ich tun, während das läuft?“ oder „Ich habe zehn Minuten, während mein Agent arbeitet“ – nicht jedoch für Tagesplanung, Agentenüberwachung oder Tagesabschluss. Die Fähigkeit schlägt einen konkreten Schritt vor wie eine menschliche Bewertung, einen kurzen Entwurf, die Wiederaufnahme einer autorisierten unerledigten Aufgabe oder das Lernen eines einzelnen Konzepts aus einer echten Quelle. Sie respektiert ein vom Benutzer genanntes Zeitbudget, schätzt Aufwand plus zwei Minuten für die Rückkehr und vermeidet Live-Überwachung oder die Erfindung von Backlogs. Nach der Aktion wird sauber zur primären Arbeit zurückgekehrt, mit einem optionalen Checkpoint für die lokale Sitzung, der über ein Python-Hilfsskript oder eine begleitende HTML-Oberfläche verwaltet werden kann.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/m1nga/breakinggap/tree/HEAD/skills/breakinggap

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht BreakingGap?

Eine kleine Lücke. Ein kleines Stück weiter.

Hilf der Person, einen kleinen, befriedigenden Beitrag zu leisten, während ein Agent arbeitet. Das Ergebnis kann eine klarere Entscheidung, ein paar nützliche Worte, eine wiederaufgenommene Idee oder ein besser verstandenes Konzept sein. Die Lücke leer zu lassen, ist eine legitime Wahl. Passe dich der Sprache des Gesprächs an; die mitgelieferte Companion-Oberfläche ist Englisch.

Finde einen Schritt, der hierher gehört

Nutze zuerst das aktuelle Gespräch und den bestehenden Zustand des Projekts. Halte die primäre Arbeit und ihren Rückkehrpunkt sichtbar. Überprüfe den aktuellen Agentenstatus nur über ein verfügbares, autorisiertes Statuswerkzeug oder den Bericht des Benutzers; erfinde niemals Live-Überwachung. Wenn der primäre Agent die Person benötigt oder fertig ist, kehre zu seinem Ergebnis zurück, bevor du eine andere Aktivität vorschlägst.

Verwende ein vom Benutzer genanntes Zeitbudget. Falls nicht vorhanden, stelle eine kurze Frage zur verfügbaren Zeit und zur aktuellen Arbeit; gehe nicht von einer zehnminütigen Agenten-ETA aus. Wenn die Dauer unsicher ist, biete einen explizit geschätzten, leicht unterbrechbaren Zwei-Minuten-Schritt an. Starte keine große Suche oder warte nicht darauf, dass alle Agenten fertig sind, nur um einen Vorschlag zu finden.

Leite die nützliche Absicht aus der Anfrage ab; andernfalls bevorzuge die aktuelle Arbeit:

  • Vorwärtsbringen: ein menschliches Urteil, ein Akzeptanzbeispiel, ein kurzer Entwurf oder ein Vergleich, der die aktuelle Arbeit verbessert, ohne von der ausstehenden Ausgabe abhängig zu sein.
  • Aufnehmen: einen bereits autorisierten unerledigten Punkt mit einer konkreten gespeicherten nächsten Aktion. Überprüfe erneut, ob er noch offen ist; setze keine pausierte Arbeit oder die Aufgabe eines anderen Besitzers fort.
  • Eine Sache lernen: ein Konzept aus einer echten Quelle im aktuellen Projekt. Bitte die Person, vorher zu prognostizieren, zu erklären oder zu vergleichen, bevor du eine kurze quellenbasierte Überprüfung gibst. Keine Antwort bedeutet kein gezeigtes Lernen. Kennzeichne generierte Beispiele und unbeantwortete Fragen ehrlich.

Lies nur genügend aktuelle Quelle, um die gewählte Aktion zu unterstützen. Bestätige, dass sie noch nützlich, autorisiert, unabhängig von der ausstehenden Ausgabe und frei von Konflikten mit der aktiven Arbeit ist. Behandle eine kleine Aufgabe nicht als Erlaubnis, einen Halt zu überschreiten, agenteneigene Dateien zu ändern, Nachrichten zu senden oder zu veröffentlichen. Bevorzuge eine private Scratch-Antwort gegenüber gleichzeitigen Änderungen. Wenn Kontext fehlt, frage nach dem aktuellen Ziel oder verwende den vom Benutzer gelieferten Text; erfinde niemals ein Backlog, einen Quellort, einen Fertigstellungszustand oder eine Autorisierung.

Schätze Setup + menschliche Aktion + Abschluss und lasse zwei Minuten für die Rückkehr innerhalb des Budgets des Benutzers. Schätzungen sind keine gemessenen Dauern oder Vorhersagen des Agentenabschlusses. Reduziere überdimensionierte Arbeiten auf einen sinnvollen Stopppunkt; schließe unklare oder tief absorbiermachende Aufgaben aus, anstatt unbekannten Aufwand auf eine bequeme Zahl zu setzen.

Biete einen kleinen Schritt an

Gib eine Empfehlung in einer kompakten Gesprächskarte:

Versuch: eine spezifische Aktion, mit dem ersten Schritt klar. Warum das passt: Verbindung zur Arbeit oder Neugier der Person; geschätzter Setup/Arbeit/Abschluss und Rückkehr-Zugabe. Genug für jetzt: das kleine Artefakt oder Antwort und ein sicherer Stopport. Rückkehr zu: der primären Arbeit und wo sie fortgesetzt wird.

Nenne die tatsächliche Quelle oder verlinke sie. Verwende den Kontext des Benutzers anstelle generischer Produktivitätstipps. Wenn ein anderer Schritt gewünscht wird, ersetze die Empfehlung; entlade keine lange Warteschlange. Eine optionale spielerische Einschränkung kann die Aktion einladend machen („erkläre es in drei Sätzen“, „versuche zwei Überschriften“), vorausgesetzt, sie passt zur Arbeit. Füge keine Serien, Dringlichkeit, erfundene Erfolge oder Druck hinzu, jede Lücke zu füllen.

Lass die Person den menschlichen Schritt machen. Vervollständige nicht stillschweigend ihre Lernübung oder starte einen weiteren autonomen Workstream. Führe angeforderte Unterstützung im Rahmen ihrer bestehenden Autorisierung aus. Wenn nichts passt, sag es kurz und lass die Lücke offen.

Sauber anhalten und zurückkehren

Wenn der Benutzer sagt, dass der Agent bereit ist oder aufhören möchte, priorisiere die Rückkehr. Bewahre alle bereits im Gespräch befindlichen Arbeiten; falls nötig, bitte um eine kurze Notiz „wo ich war / nächster Schritt“, aber mache dies niemals zu einer Hürde vor der Rückkehr. Der Ablauf eines Lücken-Timers ist kein Beweis dafür, dass ein Agent fertig ist.

Zeichne tatsächliche Arbeiten getrennt von geplanten Arbeiten auf. Verwende die normalen Notizen des Projekts, wenn ein Update autorisiert ist; ein Sitzungs-Checkpoint markiert keine kanonische Aufgabe als erledigt. Sage „gespeichert“ nur nach einem erfolgreichen Schreibvorgang. Wenn das Speichern fehlschlägt, gib die Notiz im Chat an und teile mit, dass sie ungespeichert bleibt. Lies beim Fortsetzen die relevante Quelle und den aktuellen Status erneut, bevor du den gespeicherten Schritt erneut anbietest.

Optionale lokale Werkzeuge

Die reine Gesprächsnutzung benötigt kein Python, keinen Account, keinen Aufgabenordner, keine Integration und keinen Companion. Behalte die Eingabe des Benutzers und die vorhandenen Projektaufzeichnungen als maßgeblich.

Für wiederholbare dateibasierte Auswahl und eine wiederherstellbare lokale Sitzung verwende den mitgelieferten Helfer aus der Standardbibliothek. Lese references/session-format.md für seine genaue Eingabe und Befehle. Der Assistent erstellt sein JSON aus tatsächlichen Beweisen; bitte den Benutzer niemals, interne Felder zu verwalten. Führe das installierte scripts/gap.py über seinen absoluten Pfad mit --root aus, der auf das bestehende Projekt des Benutzers zeigt, nicht auf diese Installation. Der Helfer prüft Quell-Hashes und gelieferte Berechtigungsbehauptungen; er kann unabhängig kein Eigentum, keine Berechtigung, keinen Status und keine Abwesenheit von Konflikten nachweisen. Überprüfe diese vor dem Start erneut.

Der optionale Offline-Companion bietet einen Timer und einen Checkpoint-Ablauf. Öffne ihn mit assets/logo.png daneben. Er beginnt mit sichtlich fiktiven Beispielen. Um echte Arbeit zu verwenden, kann der Assistent ein Schema-1-Eingabebündel aus autorisierten lokalen Quellen vorbereiten und importieren. Die Seite kann gelieferte Felder validieren, aber keine Projektdateien erneut lesen, Hashes überprüfen, Agenten überwachen oder mit dem Helfer-Journal synchronisieren. Sein lokaler Browser-Speicher und Exporte sind separate Kopien. Ein Checkpoint-Export ist ein Beweis zum Abgleich nach Überprüfung der aktuellen Quelle, niemals eine Anweisung zur Ausführung. Wenn Python oder Browser-Speicher nicht verfügbar sind, setze das Gespräch fort oder exportiere eine Notiz; installiere keine Abhängigkeiten nur, um diese Fähigkeit zu nutzen.

Verwandte Skills