Communitygithub.com

PascaleBeier/hitkeep

HitKeep ist eine datenschutzorientierte Analyseplattform für Menschen und KI-Agenten, selbst gehostet oder in verwalteten EU-/US-Cloud-Regionen.

Was ist hitkeep?

Diese Skill unterstützt bei der Lokalisierung des Dashboards von HitKeep. Das Dashboard verwendet Transloco-JSON-Dateien für die UI-Texte, `@jsverse/transloco-locale` zusammen mit Browser-`Intl`-APIs für sprachabhängige Formatierungen. PrimeNG-Labels werden automatisch mit der aktiven Transloco-Sprache synchronisiert. Der Skill beschreibt den Arbeitsablauf: Vorhandene Feature-Schlüssel suchen, neue Texte in Angular-Templates durch `TranslocoPipe` ersetzen, alle sieben unterstützten Sprachdateien (en, de, es, fr, it, nl, pt) aktualisieren und die Interpolationsvariablen unverändert lassen. Zudem werden Qualitätsstandards für jede Sprache festgelegt (z.B. korrekte Umlaute für Deutsch, Akzente für Französisch). Abschließend sind Prüfbefehle (`npm run i18n:check`, `sync-i18n-locales.mjs`) und Formatierungs-Checks (`npm run fmt:check`) dokumentiert, um die Konsistenz sicherzustellen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add PascaleBeier/hitkeep

In Ihrer bevorzugten KI fragen

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

Dokumentation

HitKeep i18n

Verwende diesen Skill, wenn sichtbarer Dashboard-Text oder sprachabhängige Formatierungen in HitKeep geändert werden.

Das Dashboard von HitKeep verwendet Transloco-JSON-Dateien für UI-Texte und @jsverse/transloco-locale sowie Browser-Intl-APIs für sprachabhängige Formatierung. PrimeNG-Labels werden von der aktiven Transloco-Sprache synchronisiert.

Öffentliche Oberfläche

Die Übersetzungsdateien des Dashboards befinden sich in:

  • frontend/dashboard/public/i18n/en.json
  • frontend/dashboard/public/i18n/de.json
  • frontend/dashboard/public/i18n/es.json
  • frontend/dashboard/public/i18n/fr.json
  • frontend/dashboard/public/i18n/it.json
  • frontend/dashboard/public/i18n/nl.json
  • frontend/dashboard/public/i18n/pt.json

Das Dashboard bietet derzeit diese Sprachkennungen an:

en, de, es, fr, it, nl, pt

Die Formatierungs-Locale-Zuordnungen sind in frontend/dashboard/src/app/app.config.ts konfiguriert:

en -> en-US
de -> de-DE
es -> es-ES
fr -> fr-FR
it -> it-IT
nl -> nl-NL
pt -> pt-BR

Leite keine neue unterstützte Sprache allein aus einem Angular-Locale-Helper ab. Füge eine neue Dashboard-Sprache nur dann hinzu oder ändere sie, wenn die Transloco-Konfiguration, die Locale-JSON-Datei, die Formatierungszuordnung und die Produktdokumentation übereinstimmen.

Arbeitsablauf

  1. Suche nach dem vorhandenen Feature-Schlüssel, bevor du einen neuen Schlüssel erstellst.
  2. Setze sichtbaren Angular-Template-Text hinter TranslocoPipe.
  3. Verwende TranslocoService für berechnete Labels in TypeScript.
  4. Füge denselben Schlüsselpfad zu allen sieben Locale-JSON-Dateien hinzu.
  5. Halte Schlüsselnamen semantisch und nach Feature gruppiert.
  6. Behalte Interpolationsvariablen exakt bei. Übersetze keine Variablennamen und ändere keine Platzhalter-Syntax.
  7. Für berechnete Optionslabels hänge von der aktiven Sprache ab, damit Labels nach Sprachwechseln neu berechnet werden.
  8. Für Daten, Zahlen, Prozentangaben und Dauern bevorzuge die vorhandenen Locale-Dienste oder Hilfsfunktionen anstelle manueller Zeichenkettenformatierung.
  9. Lasse PrimeNG-Locale-Text durch den vorhandenen Synchronisationsdienst fließen, anstatt Komponentenlabels fest zu codieren.
  10. Halte Labels kurz genug für Schaltflächen, Tabs, Chips, Tabellenspalten und mobile Layouts.

Nützliche Orte zur Ansicht:

  • frontend/dashboard/src/app/app.config.ts
  • frontend/dashboard/src/app/transloco-loader.ts
  • frontend/dashboard/src/app/core/i18n/
  • frontend/dashboard/scripts/check-i18n-locales.mjs
  • frontend/dashboard/scripts/sync-i18n-locales.mjs

Übersetzungsqualität

Übersetze die Produkt-UI, nicht einzelne englische Wörter.

  • Deutsch: Verwende natürliches Produktdeutsch und korrekte Zeichen wie Ä, Ö, Ü, ä, ö, ü und ß.
  • Spanisch: Verwende Akzente, ñ und Anfangssatzzeichen, wo erforderlich, z. B. ¿Seguro?.
  • Französisch: Verwende Akzente und Apostrophe natürlich, z. B. paramètres, sécurité und l'adresse e-mail.
  • Italienisch: Verwende Akzente wo erforderlich, besonders bei Wörtern mit Endbetonung wie attività, città, perché, può und è.
  • Niederländisch: Halte die Dashboard-Terminologie natürlich und prägnant. Verwende vorhandene Begriffe für Site, Team, Goal, Funnel, Share Link und API Client.
  • Portugiesisch: Verwende den vorhandenen brasilianischen Formatierungskontext (pt-BR), es sei denn, das Produkt ändert explizit das Locale-Ziel. Verwende natürliches Portugiesisch mit korrekten Akzenten.

Halte die Analyseterminologie über alle Sprachen hinweg konsistent. Wenn das Repository bereits einen Begriff für „Site”, „Team”, „Event”, „Goal”, „Funnel”, „Share Link”, „API Client”, „QR Campaign” oder „Opportunity” verwendet, verwende ihn erneut.

Prüfungen

Führe den Locale-Check nach Übersetzungsänderungen aus:

cd frontend/dashboard && npm run i18n:check

Wenn ein Schlüsselstruktur-Abweichung vermutet wird, führe das Sync-Skript aus und überprüfe die resultierenden Änderungen, bevor du sie übernimmst:

cd frontend/dashboard && node scripts/sync-i18n-locales.mjs

Führe Formatierungsprüfungen für Dashboard-Dateien aus:

cd frontend/dashboard && npm run fmt:check

Für UI-Verhalten, das von Sprachwechseln abhängt, füge gezielte Tests nahe der Komponente oder des Dienstes hinzu, der das Verhalten besitzt, oder aktualisiere sie.

Ausgabe für Reviews

Wenn du eine i18n-Änderung meldest, füge folgendes ein:

Geänderte Schlüssel:
- <Schlüsselpfad>

Aktualisierte Locales:
- en, de, es, fr, it, nl, pt

Prüfungen:
- <Befehl und Ergebnis>

Hinweise:
- <Layout-, Wortlaut- oder Review-Anmerkungen>

Behaupte nicht, dass eine Übersetzung von einem Muttersprachler überprüft wurde, es sei denn, das ist tatsächlich geschehen.

Verwandte Skills