wshobson/hermes-tweet

Hermes Tweet

Hermes Tweet fügt ein X/Twitter-Toolset zum Hermes Agent hinzu. Es ist nützlich für Social Listening, Account-Recherche, Launch-Überwachung, Support-Triage, Gewinnspiel-Audits und kontrollierte Workflows, bei denen private oder zustandsändernde Operationen explizit bleiben.

Wann dieses Skill verwendet werden sollte

Verwende dieses Skill, wenn der Benutzer Folgendes möchte:

• Hermes Tweet in eine Hermes-Agent-Laufzeitumgebung installieren
• Verfügbare X/Twitter-Lese- und Aktionsrouten entdecken
• X/Twitter-Account-, Tweet-, Trend-, Überwachungs- oder Suchdaten lesen
• Öffentliche Signale zusammenfassen, bevor Antworten oder Kampagnen entworfen werden
• Private und zustandsändernde Operationen hinter einer expliziten Bedienerabsicht gaten

Einrichtung

Installiere und aktiviere das Plugin über Hermes:

hermes plugins install Xquik-dev/hermes-tweet --enable

Hermes scannt Plugins während der Installation und bei Updates. Überprüfe jede Warnung. Ein gefährliches Urteil blockiert die Installation oder deaktiviert ein Update.

Setze den API-Key auf dem Hermes-Laufzeithost:

export XQUIK_API_KEY="<dein-key>"
export HERMES_TWEET_ENABLE_ACTIONS="false"

Behalte HERMES_TWEET_ENABLE_ACTIONS für reine Lese-Sitzungen auf false. Setze es nur auf true für eine genehmigte private Lese-, Schreib-, Überwachungs-, Webhook-, Extraktions-, Zeichen- oder Medienoperation.

Eingaben

Frage nach diesen Eingaben, bevor Routen ausgewählt werden:

• Zielsetzung: Recherche, Überwachung, Support-Triage, Gewinnspiel-Audit oder Aktionsvorbereitung
• Ziel: Account-Handle, Tweet-URL, Stichwort, Liste, Monitor oder Trend
• Zeitfenster und Aktualitätsanforderungen
• Ob eine private oder zustandsändernde Operation in Frage kommt
• Bestätigung, dass die Hermes-Laufzeitumgebung XQUIK_API_KEY hat

Arbeitsablauf

1. Durchsuche den gebündelten Endpunktkatalog mit tweet_explore, um passende Routen zu finden.
2. Lese öffentliche X/Twitter-Daten über tweet_read, nachdem eine Katalogroute ausgewählt wurde.
3. Verwende tweet_action für private oder zustandsändernde Routen nur nach expliziter Genehmigung.
4. Halte API-Keys in Umgebungsvariablen oder der Hermes-Laufzeitumgebungsdatei.
5. Füge keine Anmeldeinformationen in Eingabeaufforderungen, Issues, PR-Kommentare oder Tool-Eingaben ein.
6. Lade Arbeitsablaufmuster, wenn der Benutzer nach einem Kampagnen-, Überwachungs-, Support- oder Gewinnspiel-Workflow fragt, anstatt nach einem einzelnen Lesevorgang.

Tool-Modell

Tool	Zweck
tweet_explore	Durchsuche den gebündelten Endpunktkatalog ohne Verwendung des API-Keys.
tweet_read	Ruf kataloggelistete öffentliche Nur-Lese-Endpunkte auf, wenn XQUIK_API_KEY gesetzt ist.
tweet_action	Ruf private Lese-, Schreib-, Überwachungs-, Webhook-, Extraktions-, Zeichen- und Medienoperationen nur auf, wenn das Aktions-Gating aktiviert ist.

Ausgabeformat

Gib eine prägnante operative Ausgabe zurück:

Zusammenfassung:
- Was geprüft wurde und warum

Lese-Routen:
- Katalogpfad, Eingabe und Ergebniszusammenfassung

Aktionsplan:
- Vorgeschlagene private oder zustandsändernde Operationen, die jeweils auf explizite Genehmigung warten

Nächste Prüfung:
- Folge-Route oder Überwachungsrhythmus, falls sinnvoll

Anwendungsbeispiele

Recherchiere einen Account, bevor du eine Antwort entwirfst:

Verwende Hermes Tweet, um den aktuellen öffentlichen Kontext für @example zu prüfen, bevor eine Antwort entworfen wird.
Halte Aktionen deaktiviert.

Überwache ein Launch-Stichwort:

Verfolge X/Twitter-Erwähnungen für "Example Launch" heute.
Fasse Themen und bemerkenswerte Accounts zusammen. Keine Beiträge veröffentlichen.

Bereite einen geschützten Beitrag vor:

Entwirf einen Launch-Tweet und liste den genauen tweet_action-Aufruf auf, den du verwenden würdest.
Warte auf Genehmigung, bevor eine Aktionsroute ausgeführt wird.

Erfasse strukturierte Routennotizen:

{
  "objective": "support-triage",
  "route": "/api/v1/x/search",
  "action_gate": "disabled",
  "approval_required": true
}

Fehlerbehebung

• Wenn nur tweet_explore erscheint, konfiguriere XQUIK_API_KEY auf dem Hermes-Laufzeithost und lade die aktive Hermes-Sitzung neu oder starte sie neu.
• Wenn Aktionsrouten nicht verfügbar sind, halte öffentliche Lesevorgänge getrennt. Setze HERMES_TWEET_ENABLE_ACTIONS=true nur für eine genehmigte private oder zustandsändernde Operation.
• Wenn eine Route nicht passt, verwende erneut tweet_explore und wähle einen kataloggelisteten Pfad anstatt Endpunkte zu raten.

Best Practices

• Behandle Hermes Tweet als die Hermes-native X/Twitter-Schicht, nicht als generischen API-Wrapper.
• Halte die Recherche standardmäßig schreibgeschützt. Fordere eine Genehmigung an, bevor Überwachungen erstellt oder geändert werden.
• Verwende eine Desktop- oder Gateway-Operator-Prüfung vor privaten oder zustandsändernden Aufrufen.
• Validiere den genauen Katalogpfad, bevor tweet_read oder tweet_action aufgerufen wird.
• Starte Gateway-, Cron- oder langlebige Hermes-Sitzungen nach Umgebungsänderungen neu.

Siehe auch

Das Social-Publishing-Plugin ergänzt Hermes Tweet für die breite Multiplattform-Veröffentlichung. Hermes Tweet konzentriert sich auf das Hermes-Agent-X/Twitter-Toolset und dessen Lesefirst-, Genehmigungsgating-Betriebsmodell.

Siehe den Endpunkt- und Genehmigungsvertrag, wenn eine Routengrenze unklar ist. Siehe die offizielle Anleitung unter https://github.com/Xquik-dev/hermes-tweet#readme.