Was macht OpenTag?
OpenTag wandelt Workspace-Erwähnungen wie @opentag fix this in überprüfbare Agentenläufe um. Verwenden Sie diesen Skill, um einem Benutzer zu helfen, den Pfad vom Workspace-Ereignis zum Dispatcher, lokalen Runner, Executor und Callback zu konfigurieren.
Anfrage weiterleiten
Lesen Sie nur die Referenz, die für den Pfad des Benutzers benötigt wird:
- Lokaler Rauchtest oder Ersteinrichtung:
references/local-echo.md - GitHub-Issue- oder PR-Erwähnungen:
references/github-setup.md - Slack-App-Erwähnungen:
references/slack-setup.md - Echte Code-Ausführung oder PR-Erstellung:
references/codex-runner.md - Fehlerhafte Läufe, fehlende Callbacks, abgelehnte Läufe oder Authentifizierungsfehler:
references/troubleshooting.md
Wenn der Benutzer nach mehr als einem Pfad fragt, konfigurieren und verifizieren Sie zuerst die kleinste funktionierende Schleife und fügen Sie dann den nächsten Adapter hinzu.
Arbeitsregeln
- Bevorzugen Sie die lokale Echo-Schleife vor echten Agenten oder Live-Callbacks, es sei denn, der Benutzer hat bereits einen funktionierenden Dispatcher und Runner.
- Halten Sie die Konfiguration explizit: Erfinden Sie keine Repository-Besitzer, Repo-Namen, Checkout-Pfade, Tokens, Slack-IDs oder Dispatcher-URLs.
- Fügen Sie kein Fallback-Verhalten hinzu. Fehlende erforderliche Werte sollten die Einrichtung mit einer klaren Liste der fehlenden Elemente stoppen.
- Behandeln Sie
opentagdals lokale Ausführungsautorität. Es sollte nur Repositorys beanspruchen, die in seiner Konfiguration aufgeführt sind. - Verwenden Sie
echofür zerstörungsfreie Rauchtests undcodexnur, wenn der Benutzer echte Code-Ausführung wünscht. - Trennen Sie Nachweisebenen: Dispatcher-Health, Runner-Registrierung, Repo- oder Slack-Bindung, Lauferstellung, Daemon-Ausführung und Callback-Zustellung.
Einrichtungsworkflow
-
Identifizieren Sie die Zielschleife. Abschluss: eine Schleife ist benannt:
local-echo,github,slackodercodex-runner. -
Sammeln Sie die erforderlichen Fakten. Abschluss: Die Antwort enthält jeden fehlenden Wert, oder alle erforderlichen Werte sind verfügbar.
-
Schreiben oder aktualisieren Sie die minimale Konfiguration. Abschluss: Die Konfiguration enthält nur die für die ausgewählte Schleife benötigten Felder und verwendet das tatsächliche Repo/den tatsächlichen Kanal/die tatsächlichen Checkouts des Benutzers.
-
Registrieren Sie Bindungen, bevor Sie Läufe erstellen. Abschluss: Der Runner ist registriert, Repositorys sind gebunden und Slack-Kanäle sind gebunden, wenn Slack im Umfang ist.
-
Verifizieren Sie einen echten Lauf. Abschluss: Der Lauf ist im Dispatcher sichtbar, hat Audit-Ereignisse und endet als abgeschlossen oder schlägt mit einem bestimmten Fehler fehl.
-
Melden Sie das Ergebnis. Abschluss: Teilen Sie dem Benutzer mit, was konfiguriert wurde, welcher Befehl es bewiesen hat und was noch nicht konfiguriert ist.
Standardbefehle
Verwenden Sie diese Standardwerte, sofern das Projekt nichts geändert hat:
- Dispatcher-App:
pnpm --filter @opentag/dispatcher-app dev - Lokale Daemon-App:
pnpm --filter @opentag/opentagd dev -- <command> - Slack-Events-App:
pnpm --filter @opentag/slack-events dev - Dispatcher-URL:
http://localhost:3030 - Slack-Events-URL-Pfad:
/slack/events - Beispiel-Lauf-Payload:
examples/github-to-echo/run.example.json
Verwenden Sie Node 22.x und installieren Sie bei Bedarf Abhängigkeiten, bevor Sie Paketbefehle in diesem Repository ausführen.