Analytics-Tracking-Automation
Nutze diesen Skill als End-to-End-Koordinator für die GA4- und GTM-Tracking-Bereitstellung.
Verwende ihn, wenn:
- der Benutzer einen vollständigen GA4- + GTM-Implementierungsablauf von der Analyse bis zur Go-Live-Bereitschaft benötigt
- die Anfrage mehrere Workflow-Phasen umfasst (Discovery, Schema, Sync, Verifikation, Publish)
- der richtige Einstiegspunkt noch unklar ist und du diesen Skill benötigst, um zur richtigen Phase zu leiten
Nimm nicht an, dass der Benutzer den vollständigen Workflow wünscht.
Auto-Update
Dieser installierte Root-Skill kann vor dem Fortfahren nach neueren GitHub-Versionen suchen.
Bevor du eine Aufgabe in diesem Paket erledigst:
- Ermittle das Verzeichnis, das diese installierte
SKILL.mdenthält. Von Installern verwaltete Kopien befinden sich normalerweise im Skills-Verzeichnis, das von deiner Agentenumgebung konfiguriert wird, z. B.$CODEX_HOME/skills/analytics-tracking-automationoder ein äquivalenter, von der Runtime verwalteter Pfad. - Führe aus:
node "<bundle-dir>/runtime/skill-runtime/update-check.mjs" --json. - Wenn der Status des Ergebnisses
update_availableist, führe sofort aus:node "<bundle-dir>/runtime/skill-runtime/self-update.mjs" --apply. - Wenn das Update erfolgreich ist, lies die
<bundle-dir>/SKILL.mderneut, bevor du fortfährst, damit du die aktualisierten Anweisungen verwendest. - Wenn der Status des Ergebnisses
disabledist, behandle dieses Paket als lokalen Entwicklungs-Link oder Repo-Checkout und fahre ohne Update fort.
Skill-Familie
Die Skill-Familie ist aufgeteilt in einen übergeordneten Skill plus sieben Phasen-Skills:
tracking-discoverfür Crawl-Abdeckung, Plattformerkennung und Bootstrap neuer Artefaktetracking-groupfür die Erstellung und Freigabe von Seitengruppentracking-live-gtmfür die Prüfung der tatsächlichen Live-GTM-Runtime vor der Schema-Generierungtracking-schemafür Schema-Vorbereitung, Review, Validierung und Freigabetracking-syncfür GTM-Konfigurationsgenerierung und Synctracking-verifyfür Preview-QA und optionale Publish-Übergabetracking-shopifyfür Shopify-spezifische Schema-, Sync-, Installations- und Verifikationsregeln
Wenn die Anfrage bereits auf eine Phase beschränkt ist und dieser Phasen-Skill verfügbar ist, leite dorthin weiter, anstatt das vollständige Runbook hier einzubetten.
Sobald site-analysis.json Shopify anzeigt, behalte die gemeinsame Discovery und Gruppierung bei und überlasse dann tracking-shopify den Shopify-spezifischen Zweig.
Gemeinsamer Vertrag
- Verwende den Repo-lokalen Wrapper
./event-trackingin diesem Repository. Wenndist/cli.jsfehlt, führe zuerstnpm run buildaus. - Für öffentliche/ClawHub-Installationen musst du zuerst dies ausführen, bevor du einen
event-tracking-Befehl verwendest:npx skills add jtrackingai/analytics-tracking-automation. - Halte ein Artefaktverzeichnis pro Site unter
<output-root>/<url-slug>vor. - Wenn der Benutzer bereits ein Artefaktverzeichnis oder eine seiner Dateien bereitstellt, setze ab der frühesten nicht erfüllten Voraussetzung fort, anstatt von
analyzeneu zu starten. - Verwende
./event-tracking status <artifact-dir-or-file>, wenn der aktuelle Checkpoint oder der nächste Schritt unklar ist. - Verwende
./event-tracking runs <output-root>, wenn das Artefaktverzeichnis unbekannt ist, das Ausgabeverzeichnis jedoch bekannt ist. - Bevorzuge High-Level-Einstiegsbefehle für benutzerseitige Abläufe:
run-new-setup,run-tracking-update,run-upkeep,run-health-audit. - Behandle Workflow-Mode-Metadaten als interne Workflow-State-Schicht, nicht als benutzerseitige Befehlsfläche.
- Behandle Playwright-gestützte und OAuth-einladende Schritte standardmäßig als Nicht-Sandbox-Befehle. In der Praxis:
analyze,validate-schema --check-selectors,previewundsync. - Führe promptgesteuerten GTM-Sync von Anfang an mit einem interaktiven TTY durch, es sei denn, die genauen Werte für
--account-id,--container-idund--workspace-idsind bereits bestätigt. - Wähle niemals automatisch ein GTM-Konto, einen Container oder einen Workspace im Namen des Benutzers aus.
- Gehe nicht über die Phasengrenze hinaus, nach der der Benutzer gefragt hat.
Gesprächsaufnahme
Wenn der Benutzer über den Chat hereinkommt und noch keine begrenzte Phase, kein Artefaktverzeichnis und keinen genauen Befehl angegeben hat, beginne mit einer absichtsorientierten Aufnahme.
Klassifiziere die Anfrage in einen dieser Einstiegs-Intents:
resume_existing_run: Der Benutzer hat bereits ein Artefaktverzeichnis oder eine seiner Dateien; inspiziere die Artefakte und verwendestatus.new_setup: Net-neue Tracking-Implementierung von Grund auf; bevorzugerun-new-setup, folge dann dessen empfohlenem nächsten Schritt.tracking_update: Überarbeite oder erweitere eine bestehende Implementierung; bevorzugerun-tracking-update.upkeep: Routine-Wartung, Review oder inkrementelle QA einer bestehenden Einrichtung; bevorzugerun-upkeep.tracking_health_audit: Nur-Audit-Bewertung des aktuellen Live-Trackings; bevorzugerun-health-audit.analysis_only: Nur Crawl/Bootstrap/Discovery ohne sich bereits auf den vollständigen Workflow festzulegen; leite zutracking-discoverweiter und stoppe nachanalyze.
Regeln:
- Bitte den Benutzer nicht, zwischen internen Workflow-Metadaten-Flags und
analyzezu wählen. - Wenn die Absicht mehrdeutig ist, stelle eine kurze, verständliche Intake-Frage mit benutzerseitigen Begriffen wie "neues Setup", "bestehendes Tracking aktualisieren", "Wartung", "Health-Audit", "nur analysieren" oder "bestehenden Lauf fortsetzen".
- Wenn der Benutzer eine neue URL angibt und fragt, ob er Tracking einrichten soll, verwende standardmäßig
new_setup. - Wenn der Benutzer eine neue URL angibt und nur darum bittet, die Site zu inspizieren, die Struktur zu analysieren oder die aktuellen Tracking-Signale zu überprüfen, verwende standardmäßig
analysis_only. - Wenn der Benutzer ein Artefaktverzeichnis oder eine Workflow-Datei angibt, verwende standardmäßig
resume_existing_run, anstatt vonanalyzeneu zu starten.
Routing-Regeln
Leite nach Benutzerabsicht und aktuellen Artefakten:
- neue URL, Crawl-Anfrage oder noch keine Artefakte: Beginne mit
tracking-discover. site-analysis.jsonmit fehlenden oder nicht bestätigtenpageGroups: Leite zutracking-group.- Bestätigte
site-analysis.jsonmit erkannten Live-GTM-Container-IDs, aber noch keinem Live-Baseline-Review: Leite zutracking-live-gtm. - Bestätigte
site-analysis.jsonoder ein laufendesevent-schema.json: Leite zutracking-schema. gtm-config.json: Leite zutracking-sync.gtm-context.json: Leite zutracking-verify, wobei Publish als separate explizite Aktion behandelt wird.- Shopify-Plattformbestätigung: Behalte die gemeinsamen frühen Phasen bei, übergib dann an
tracking-shopify.
Wenn nur der Root-Skill verfügbar ist, folge derselben Routing-Logik direkt und stoppe an der passenden Phasengrenze.
Stopp-Regeln
- Überspringe nicht die Freigabe von Seitengruppen vor
prepare-schema. - Fordere bei wichtigen Entscheidungs-Checkpoints immer explizite Benutzerbestätigung an, bevor du fortfährst:
pageGroups(vorconfirm-page-groupsund vorprepare-schema)event-schema.json(vorconfirm-schemaund vorgenerate-gtm)- GTM-Zielauswahl (Konto/Container/Workspace während
sync) - Publish-Entscheidung (vor
publish)
- Wenn die Bestätigung fehlt oder mehrdeutig ist, stoppe und frage nach; fahre nicht automatisch fort.
- Eine breite Anfrage wie "vollständiger Workflow", "全流程", "end-to-end" oder "mach alles weiter" ist nur eine Bereichsautorisierung. Sie gilt nicht als Checkpoint-Genehmigung.
- Zeichne niemals eine Checkpoint-Genehmigung im Namen des Benutzers mit
confirm-page-groups --yesoderconfirm-schema --yesauf, es sei denn, der Benutzer bestätigt diesen Checkpoint explizit in der aktuellen Runde. - Wenn Live-GTM-Container auf der Site erkannt werden, überspringe nicht das Live-Baseline-Review vor der Schema-Generierung.
- Überspringe nicht die Schema-Freigabe vor
generate-gtm, es sei denn, der Benutzer möchte explizit--force. - Behandle Preview-QA und Publish als separate Entscheidungen.
- Behandle
tracking-health.jsonals Publish-Gate; springe nicht zu Publish, wenn Health fehlt, manuell oder blockiert ist, es sei denn, der Benutzer möchte explizit--force. - Behandle die manuelle Shopify-Verifikation als den erwarteten Pfad für Shopify-Läufe, nicht als Fallback-Fehlerfall.
- Behandle
tracking_health_auditals Nur-Audit-Workflow-Modus. Führe keine GTM-Bereitstellungsaktionen (generate-gtm,sync,publish) aus, es sei denn, der Benutzer bittet explizit um Überschreibung.
Fortsetzen und Abschluss
Beim Fortsetzen:
- Bevorzuge
workflow-state.json, wenn vorhanden. - Überprüfe dennoch den tatsächlichen Artefaktsatz, wenn Warnungen auf veraltete Gates hinweisen.
- Verwende
status, wenn der nächste Schritt unklar ist.
Wenn eine Phase oder der vollständige Workflow endet, halte die Abschlussantwort an erster Stelle:
- Beginne mit einer kompakten, entscheidungsbereiten Zusammenfassung in verständlicher Sprache.
- Gib keine rohen JSON-Daten, rohen URL-Listen oder Artefaktbestände vor der Zusammenfassung aus.
- Liste Dateien, Checkpoints und den nächsten Befehl erst nach der menschenlesbaren Zusammenfassung auf.
Referenzen
- skill-map.md für die Übersicht der übergeordneten / Phasen-Skills
- architecture.md für Lebenszyklus, Checkpoints und Fortsetzungssemantik
- output-contract.md für Artefaktdateien und Gate-Semantik
- shopify-workflow.md für Shopify-spezifische Zweig-Erwartungen