CommunityCodierung & Entwicklunggithub.com

Agent Pulse

Eine leichtgewichtige OpenClaw-Fähigkeit, die die Auslastung und Unterbrechbarkeit des Agents meldet.

Was ist Agent Pulse?

Agent Pulse ist ein spezialisiertes Statusprüfungsprotokoll für AI-Agenten in OpenClaw-ähnlichen Umgebungen. Es erzeugt eine kompakte Puls-Karte (Pulse Card) mit vier festgelegten Feldern: Status (idle/light/busy/blocked/unknown), Unterbrechbarkeit (high/medium/low), Bereitschaft für neue Aufgaben (yes/caution/no) und eine kurze Begründung. Das Skill reagiert auf explizite Auslöser wie 'Agent Pulse', '/pulse' oder natürlichsprachliche Äquivalente. Es priorisiert deterministische Regeln gegenüber Modellurteilen, verwendet kostengünstige Signale wie aktuelle Tool-Aktivität, ausstehende Hintergrundausführungen und blockierte Zustände, und bewertet diese mit einem gebündelten Python-Skript (`pulse_eval.py`). Wichtigstes Gestaltungsprinzip ist die **Basislinie**: Der Puls-Abruf selbst darf den Agenten nicht beschäftigter erscheinen lassen, als er vor dem Check war. Standardausgabe ist die feste Karte, keine Erklärung. Nur auf Nachfrage werden Details geliefert. Bei schwachen oder widersprüchlichen Signalen wird 'unknown' gemeldet, um Übergenauigkeit zu vermeiden. Das Skill unterstützt alle gängigen Agentenplattformen (OpenClaw, Claude Code, Cursor, Codex etc.), indem es runtime-agnostische Signalquellen verwendet – besonders nützlich in Umgebungen, in denen schnelle, reproduzierbare Statuschecks gewünscht sind.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add stevengaojn2010/agent-pulse

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 Agent Pulse?

Übersicht

Verwende dieses Skill als strenges Statusprüfungsprotokoll. Gib eine kompakte Puls-Karte (Pulse Card) zum aktuellen Last- und Unterbrechbarkeitszustand mit festgelegter Formulierung und Feldern zurück.

Standardmäßig wird der Basislinien-Status gemeldet, nicht der selbstbeeinflusste Status. Die Puls-Anfrage selbst soll den Agenten nicht beschäftigter erscheinen lassen, als er unmittelbar vor der Prüfung war.

Standard-Auslöser

Behandle diese als direkte Puls-Anfragen:

  • Agent Pulse
  • /pulse
  • 你现在忙吗
  • 忙不忙
  • 现在方便吗
  • 现在负荷怎么样
  • 能接新任务吗
  • 能插个任务吗
  • 现在能接活吗

Wenn der Benutzer explizit Agent Pulse oder /pulse verwendet, gib immer das feste Puls-Karten-Format zurück und wechsle nicht in eine erklärende Konversation, es sei denn, der Benutzer fordert dies an.

Festgelegtes Ausgabeformat

Gib exakt diese vier Zeilen nach der ersten Zeilenbeschriftung zurück:

Agent Pulse
status: <idle|light|busy|blocked|unknown>
interruptibility: <high|medium|low>
acceptNewTask: <yes|caution|no>
reason: <short reason>

Regeln:

  • Standardmäßig keine zusätzlichen Absätze
  • Standardmäßig keine Aufzählungspunkte
  • Keine lange Erklärung, es sei denn, der Benutzer fragt nach dem Warum
  • Halte reason möglichst unter 12 Wörtern

Statusbedeutungen

  • idle: nicht aktiv beschäftigt; leicht zu unterbrechen
  • light: aktiv, aber nicht ausgelastet; kann Arbeit annehmen
  • busy: derzeit beschäftigt; Unterbrechungen sollten minimiert werden
  • blocked: wartet auf Abhängigkeit/Tool/Mensch
  • unknown: signalisiert unzureichende oder widersprüchliche Informationen

Entscheidungsablauf

1. Kostengünstige Signale sammeln

Verwende zuerst nur kostengünstige Signale:

  • laufende Aufgabe oder Stream
  • in der Warteschlange befindliche Nachrichten
  • blockierter oder wartender Zustand
  • Aktualität der letzten Aktivität
  • offensichtliche Rückstands-Anzeichen
  • aktives Projekt, das vorangetrieben wird
  • ausstehende Aktionspunkte, die noch nicht geliefert wurden
  • bereits begonnene Arbeit, auch wenn derzeit kein schweres Tool läuft
  • release-kritische oder bald fällige Arbeit
  • aktuelles Tool oder Exec-Aktivität, wenn sichtbar
  • ob der Agent auf den Benutzer oder eine externe Abhängigkeit wartet

Für OpenClaw-ähnliche Umgebungen bevorzuge sichtbare Laufzeitsignale gegenüber Introspektion. Gute Quellen sind aktuelle Tool-Aktivität, ausstehende Hintergrund-Exec-Ausführungen, noch nicht ausgelieferte, bereits laufende Arbeit und bei Bedarf ein schneller session_status-Check. Zähle routinemäßige asynchrone Abschlussmeldungen oder die Puls-Abfrage selbst nicht als Arbeitsnachweis.

2. Mit dem gebündelten Skript auswerten

Verwende scripts/pulse_eval.py, um das Signal-JSON in das Puls-Ergebnis abzubilden.

3. Feste Karte zurückgeben

Wenn der Auslöser Agent Pulse oder /pulse ist, gib nur die feste Karte aus. Wenn der Auslöser natürliche Sprache ist, wird die feste Karte dennoch bevorzugt, es sei denn, der Benutzer wünscht eindeutig eine Erklärung.

Schutzmaßnahmen

  • Bevorzuge deterministische Regeln gegenüber Modellurteilen
  • Tue keine Übergenauigkeit vor
  • Leite keinen verborgenen internen Zustand ohne Belege ab
  • Wenn Signale schwach sind, verwende unknown
  • Verwende no nur bei echten Überlastungs- oder risikobehafteten In-Flight-Zuständen
  • Führe nicht proaktiv aus; benötige standardmäßig einen expliziten Puls-Auslöser
  • Behandle die Puls-Abfrage selbst nicht als Arbeitsnachweis

Standard-Einsatzverhalten

Um das beabsichtigte Produktverhalten über verschiedene Benutzer/Umgebungen hinweg zu reproduzieren:

  • Auslösung nur bei expliziten Puls-Anfragen
  • Rückgabe der festen Puls-Karte standardmäßig
  • Bevorzugung des Basislinien-Status gegenüber selbstbeeinflusstem Status
  • Regeln zuerst, Modellüberlegungen zweitens
  • Ausgabe kompakt halten, es sei denn, der Benutzer fragt nach dem Warum

Ressourcen

scripts/

  • scripts/pulse_eval.py wandelt einfache Signale in ein Puls-Ergebnis um
  • scripts/render_pulse.py rendert die exakte festgelegte Ausgabekarte

references/

  • references/rules.md enthält die Klassifikationsschwellen und die Ausgabepolitik
  • references/openclaw-signals.md zeigt ein praktisches Signal-Mapping-Rezept für OpenClaw-ähnliche Laufzeiten

Verwandte Skills