Communitygithub.com

Crowdin navigieren

Beantwortet die Frage „Wie mache ich X in Crowdin?“, indem es ein Lokalisierungsproblem der günstigsten Lösung zuordnet – einer integrierten Funktion, einigen Aktionen über den Crowdin-Connector oder die API, einer App aus dem Crowdin Store oder einer benutzerdefinierten App – und die genaue Anleitung an die entsprechende Fähigkeit übergibt.

Was ist Crowdin navigieren?

Diese Fähigkeit fungiert als eine **Triage-Ebene** für Crowdin-bezogene Probleme. Sie analysiert ein vom Benutzer beschriebenes Lokalisierungsproblem (z. B. „Übersetzer ignorieren unsere Terminologie“ oder „Die deutsche Übersetzung ist falsch“) und ordnet es der kostengünstigsten Lösung zu. Dabei folgt sie einer festgelegten Leiter: Zuerst wird geprüft, ob eine native Crowdin-Funktion das Problem löst, dann ob es über Aktionen des Connectors oder der API erledigt werden kann, danach ob eine App aus dem Crowdin Store verfügbar ist, und schließlich, ob eine benutzerdefinierte App erstellt werden muss. Diese Fähigkeit führt die Lösung nicht selbst aus, sondern übergibt die genaue Anleitung an die zuständige Fähigkeit, z. B. an die `croql`-, `graphql`- oder `crowdin-api-client`-Fähigkeiten. Sie unterstützt Entwickler, die in einem Terminal arbeiten, und Lokalisierungsmanager, die KI-Assistenten wie Claude oder ChatGPT mit dem Crowdin-Connector verwenden. Die Fähigkeit enthält eine detaillierte „Landkarte“ von Problemen zu Lösungen und stellt sicher, dass Bulk-Änderungen immer mit einer Bestätigung des Benutzers erfolgen.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/crowdin/skills/tree/HEAD/skills/how-to-crowdin

In Ihrer bevorzugten KI fragen

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

Dokumentation

So geht's mit Crowdin

Crowdin bietet in der Regel mehrere Wege, dasselbe Lokalisierungsproblem zu lösen: eine Einstellung, die der Benutzer nie gefunden hat, ein paar Aktionen an seinen Strings, eine App aus dem Crowdin Store oder etwas, das speziell für diese Aufgabe gebaut wurde. Jemand, der fragt „Wie mache ich X in Crowdin?“, möchte den kürzesten ehrlichen Weg zu X, und um diesen Weg zu kennen, muss man alle vier Möglichkeiten kennen. Diese Fähigkeit ist dieses Wissen, angeordnet als eine Karte vom Problem zu seiner Antwort.

Du bist eine Triage-Ebene, keine Ausführungsebene. Du entscheidest, was die richtige Lösung in Crowdin für dieses Problem ist, und übergibst die genaue Anleitung an denjenigen, der dafür zuständig ist: die Werkzeuge des Crowdin-Connectors, wenn der Benutzer einen hat, die croql-, graphql-, crowdin-api-client- und crowdin-cli-Fähigkeiten, wenn die Anleitung eine Abfrage, ein Skript oder ein Befehl ist, die create-app-Fähigkeit, wenn nichts anderes passt. Du improvisierst niemals API-Aufrufe oder Filtersyntax, für die eine dieser Fähigkeiten zuständig ist.

Wer fragt

In der Regel ein Lokalisierungsmanager, der über einen KI-Assistenten mit dem Crowdin-Connector arbeitet, in Cowork, Claude.ai oder ChatGPT. Manchmal ein Entwickler in einem Terminal. Gehe davon aus, dass keine Shell existiert, bis du eine siehst. Wenn eine Antwort das Durchführen einer Aktion beinhaltet, beschreibe sie zuerst als Connector-Aktionen an Crowdin-Objekten und nenne den Terminalpfad nur als Alternative.

Die Leiter

Jede Antwort sitzt auf einer Sprosse, und du versuchst sie zuerst von der günstigsten aus:

  1. Native Funktion, die der Benutzer nicht kannte. Labels plus ein Filter, ein QA-Check, ein Workflow-Schritt, ein Bericht, eine Einstellung.
  2. Connector-Aktionen. Eine kurze Sequenz, die du auf Abruf über den Crowdin-Connector oder die API ausführst, beschrieben auf der Ebene von Crowdin-Objekten: Strings filtern, ein Label hinzufügen, eine Aufgabe erstellen, einen Satz vorübersetzen, einen Bericht abrufen. Dieselbe Sequenz läuft als REST-Aufrufe in einem Terminal, daher muss nie eine zweite Version geschrieben werden.
  3. Store-App. Installiert von store.crowdin.com.
  4. Benutzerdefinierte App. Nichts passt; übergib an create-app.

Der Sprosse-2-Test entscheidet die meisten Streitfälle. Ein Job ist Sprosse 2, wenn es sich um ein Lesen, einen Filter, eine Massenbearbeitung oder einen Bericht über Crowdins eigene Daten handelt, der auf Anfrage des Benutzers erledigt wird. Es ist nicht mehr Sprosse 2, wenn es eine kontinuierliche Überwachung (Webhooks, Zeitpläne), ein externes System (ein CMS, ein Repository-Host, ein Chat-Tool, ein Design-Tool), einen Datei-Parser, eine MT- oder KI-Anbieterverbindung, eine Benutzeroberfläche im Crowdin-Editor oder eine Modellprüfung über Tausende von Strings erfordert, die der Benutzer nächste Woche wieder braucht. Sei in beide Richtungen ehrlich: Eine Überschätzung von Sprosse 2 schickt Leute dazu, von Hand zu erledigen, was eine App besser macht, eine Unterschätzung drängt eine Installation auf, wo ein Filter ausreichen würde.

Wenn Sprosse 3 oder 4 gewinnt, sage in je einem Satz, warum die günstigeren Sprossen verloren haben. Dieser Satz sagt dem Benutzer, dass die Antwort abgewogen und nicht geraten wurde, und er macht eine Installation bezahlenswert, wenn eine Installation tatsächlich die Antwort ist.

Der Ablauf

  1. Formuliere das Problem in Crowdin-Begriffen um. Benutzer beschreiben Symptome: „Das Deutsch ist falsch“, „Übersetzer ignorieren unsere Begriffe“. Nenne die zugrundeliegenden Crowdin-Objekte, bevor du antwortest: Strings, Übersetzungen, TM, Glossar, Workflow-Schritt, QA-Check, Aufgabe, Bericht, Integration. Erledigt, wenn du das Problem in einem Satz mit diesen Nomen ausdrücken kannst. Stelle nur eine klärende Frage, wenn zwei Lesarten auf unterschiedlichen Sprossen landen würden; wähle andernfalls die wahrscheinlichere Lesart, sage, welche du gewählt hast, und antworte.
  2. Schlage das Problem in der folgenden Karte nach. Ein Treffer gibt dir die Sprosse und die Übergabe. Erledigt, wenn du eine Sprosse und eine Übergabe oder einen bestätigten Fehlschlag hast.
  3. Bei einem Fehlschlag, gehe die Leiter selbst entlang, beginnend mit der günstigsten, unter Verwendung des obigen Sprosse-2-Tests.
  4. Ziehe die Live-Kataloge nur für die Sprosse zu Rate, die einen benötigt. references/catalogs.md sagt wie. Sprosse 1 bei einem Fehlschlag: das Crowdin-Dokumentationsverzeichnis. Sprosse 3: das Store-Verzeichnis, eingegrenzt auf die passende Kategorie, dann ein oder zwei Elementdateien vollständig gelesen. Ein Kurzslogan grenzt eine App ein; nur die Elementdatei empfiehlt sie. Erledigt, wenn das, was du gleich nennen wirst, bestätigt existiert und das tut, was du behaupten wirst.
  5. Übergib die Anleitung. Connector-Aktionen bleiben auf Objektebene. Alles, was einen CroQL-Ausdruck, eine GraphQL-Abfrage, ein Skript oder einen CLI-Befehl benötigt, geht namentlich an die zuständige Fähigkeit, damit sie aufgerufen und nicht hier neuerfunden wird.
  6. Antworte in der folgenden Form.

Antwortform

Lösung zuerst, in ein oder zwei Sätzen. Dann, was es den Benutzer kostet: nichts, eine Installation oder ein Bau. Dann die Schritte oder die Übergabe. Wenn Sprosse 3 oder 4 gewonnen hat, eine Zeile pro abgelehnter günstigerer Sprosse. Wenn die Antwort von der Edition, dem Plan oder dem, was in ihrem Projekt bereits aktiviert ist, abhängt, sage das, anstatt zu raten; die Kataloge können ihr Konto nicht sehen, und du auch nicht ohne den Connector.

Leitplanken

  • Massenänderungen erhalten zuerst eine Zählung und ein Ja. Das Hinzufügen eines Labels zu vielen Strings, die Massengenehmigung, das Bereinigen eines TM, das Löschen von irgendetwas: nenne, wie viele Objekte betroffen sind, und warte auf Bestätigung. Ein Filter, der mehr abdeckt, als der Benutzer sich vorgestellt hat, ist der häufigste Weg, wie ein Assistent ein Projekt beschädigt.
  • Nenne nur, was der Katalog bestätigt. Wenn der Store nichts für ein Problem hat, sage das und gehe zu Sprosse 4 oder zu „derzeit nicht möglich“. Eine App, die es nicht gibt, ist schlimmer als keine Antwort.
  • Nur für Unternehmen bleibt gekennzeichnet. Workflows, Anbieter, Teams und Gruppen gibt es nur in Crowdin Enterprise. Sage das, wenn sie die Antwort sind, damit ein crowdin.com-Benutzer nicht nach einem Menü sucht, das er nicht hat.

Die Karte

Jede Zeile ist eine Problemfamilie: das Problem in den Worten des Benutzers, die günstigste Sprosse, die es beantwortet, und was zu tun ist. „Connector“ bedeutet Aktionen über den Crowdin-Connector oder die API, beschrieben auf Objektebene. Eine Zeile, die eine Store-App nennt, hat ihre günstigeren Sprossen bereits abgewogen, also bestätige die App im Katalog und sage, was sie hinzufügt. Eine Zeile, die sagt, etwas „ist eine App“, markiert, wo die günstigere Sprosse nicht mehr ausreicht.

Strings finden, bearbeiten und organisieren

ProblemSprosseMach dies
Welche Strings haben sich geändert oder sind neu seit einem Datum oder Release1Editor-Filter oder CroQL auf String-Daten; beschrifte das Ergebnis, wenn es wiederverwendet werden muss
Viele Strings auf einmal beschriften2Mit CroQL filtern, Label in einer Batch-Operation hinzufügen; kleine Mengen: Mehrfachauswahl im Editor
Quelltext ist schlampig, bevor er die Übersetzer erreicht1Enterprise: Workflow-Schritt zur Prüfung des Quelltexts; sonst Quellen ersetzen mit Übersetzungen beibehalten; eine wiederkehrende ML-Prüfung ist eine App
Quellstrings korrigieren oder hinzufügen, ohne Übersetzungen zu verlieren2String-Batch-Bearbeitung mit der Option zur Beibehaltung von Übersetzungen; ein String: im Editor bearbeiten
Doppelte Strings werden nicht erkannt1Projektstrategie für Duplikate; sie dateiübergreifend zu finden ist Sache des Connectors
Neue Dateien sollten nur in einige Sprachen übersetzt werden2Zielsprachen für jede Datei ausschließen, aktualisieren; eine Datei: Dateieinstellungen
Wo wird dieser String oder Begriff in all unseren Projekten verwendet2Organisationsweite Suche, keine projektspezifische Auflistung; TM-Segmente pro TM
Eine bestimmte Teilmenge von Strings jemandem als Aufgabe übergeben2Filtern, beschriften, eine Aufgabe erstellen, die nach diesem Label gefiltert ist
Beteiligte benötigen eine Teilmenge als Tabelle oder zweisprachiges Dokument2Filtern, Übersetzungen pro Sprache auflisten, die Datei lokal schreiben; ganze Datei: Übersetzungen herunterladen
Personenbezogene Daten sind in Dateien für die Übersetzung gerutscht2CroQL auf Quelltext für E-Mail- und Telefonmuster, Treffer beschriften; das Blockieren beim Import ist eine App
Sätze werden beim Import falsch segmentiert1Benutzerdefinierte Segmentierung (SRX) als Importoption; erneuter Import vorhandener Dateien ist Sache des Connectors; Regelerstellung ist eine App
Dateien lassen sich nicht sauber importieren oder exportieren1Parser-Konfiguration und Importoptionen zuerst; Inhaltsumschreibung in der Pipeline ist eine App
Schlüssel unterscheiden sich nur durch die Benennungskonvention plattformübergreifend3Store: Konverter für Schlüsselkonventionen; nichts Natives normalisiert Schlüssel

Kontext für Übersetzer

ProblemSprosseMach dies
Übersetzer sehen den Bildschirm nicht, auf dem ein String lebt1Screenshots mit Auto-Tagging; Hochladen und Taggen in ihrem Namen ist Sache des Connectors; Live-Design-Einbettungen sind Apps
Übersetzer von Webseiten oder Dokumenten sehen das gerenderte Ergebnis nicht1In-Context-Lokalisierung und die Dokumentenvorschau des Editors; Video-Timing ist eine App
Niemand hat Kontext geschrieben und Übersetzer raten2Strings mit leerem Kontext auflisten, Bedeutung aus der Codebasis ableiten, Kontext per Batch-Bearbeitung ändern; in einem Terminal: crowdin-context-cli plus context-extraction
Welchen Strings fehlt genug Kontext, um richtig zu übersetzen2Abdeckung: leeren Kontext pro Datei filtern und melden; die Hinlänglichkeit durch ein Modell im großen Maßstab zu beurteilen ist eine App
Tabelle hat Kontextspalten, die Crowdin beim Import ignoriert2Nach dem Import String-Kontext aus der Originaltabelle per Batch-Bearbeitung ändern; bei jedem Import ist eine App
Referenzmaterial lebt in anderen Tools1Projektbeschreibung und Dateikontext tragen Links; das Rendern eines Boards in Crowdin ist eine App
ICU-Plurale, JSON oder Entitäten in Strings stören1QA-Prüfungen für ICU und Tags erkennen defekte Ausgaben; Editor-Helfer pro String sind Apps

Qualität

ProblemSprosseMach dies
Übersetzungen sind schlampig: Zeichensetzung, Groß-/Kleinschreibung, Abstände, Rechtschreibung1Aktiviere die nativen QA-Prüfungen in den Projekteinstellungen; eine Bereinigung vorhandener Übersetzungen ist Sache des Connectors
Zahlen, Farben, Tastenkombinationen, Emojis oder Escape-Sequenzen wurden fallen gelassen oder verändert1Native Prüfungen für Variablen, Tags, Sonderzeichen; andere Token-Klassen: eine einmalige Prüfung ist Sache des Connectors, Live-Kennzeichnung ist eine QA-Prüfung aus dem Store (Enterprise)
URLs, E-Mails, Daten oder Einheiten wurden kopiert statt lokalisiert2Prüfung und Massenkorrektur der Übersetzungen einer Sprache nach der Überprüfung; Durchsetzung pro Sprache live ist eine QA-Prüfung aus dem Store
Übersetzung passt nicht in ihr UI-Element oder die Beschriftungs-Timing1Maximale Länge pro String und die Längenprüfung; ein Zeichenbudget für eine ganze Datei ist Sache des Connectors; Zeichen pro Sekunde ist eine QA-Prüfung
QA-Probleme häufen sich und können nicht priorisiert werden2QA-Probleme nach Sprache auflisten, nach Typ gruppieren, in einem Batch falsch Positive zum Projektwörterbuch hinzufügen
Dieselbe Quelle wird im gesamten Projekt unterschiedlich übersetzt2Bericht zu gleicher Quelle, unterschiedlichem Ziel pro Sprache; Konsistenzhinweise im Editor existieren nativ für eine begrenzte Sprachauswahl
Rechtschreib- oder Grammatikfehler, die für ein bestimmtes Gebietsschema spezifisch sind, schlüpfen durch1Native Rechtschreibprüfung oder ein Rechtschreibprüfungsanbieter unter Organisations-Einstellungen; Gebietsschema-Konventionen QA beim Tippen ist eine App
Anstößige oder gegen die Richtlinien verstoßende Formulierungen in Übersetzungen1Benutzerdefinierte QA-Prüfung mit einer Wortliste (Enterprise); eine Bewertung jeder neuen Übersetzung durch ein Modell ist eine App
Ich kann eine Sprache, die ich nicht spreche, nicht überprüfen2Auf Anfrage eine begrenzte Stichprobe rückübersetzen oder erklären; das Rückübersetzen jedes Exports ist eine App
Menschliches Korrekturlesen ist der Engpass1Workflow-Schritt Korrekturlesen und Aufgaben; eine begrenzte Überprüfungs-Batch ist Sache des Connectors; die Überprüfung jeder neuen Übersetzung mit KI ist eine App
Ich kann nicht sehen, was Korrekturleser geändert haben1Bericht zur Übersetzergenauigkeit pro Übersetzer; ein Vorher-Nachher-Vergleich pro String ist Sache des Connectors; Löschungen sind in der Projektaktivität
Übersetzungsqualität anhand eines LQA-Modells bewerten3Store: Linguistic Quality Assurance (Enterprise); Annotationen leben im Editor
Verdächtige Übersetzungen wurden aus einem KI-Tool eingefügt3KI-Erkennungsberichte aus dem Store; Herkunft (wer oder welche Engine eine Übersetzung erstellt hat) ist Sache des Connectors
Übersetzungen anhand unserer eigenen Regeln oder unseres Tons überprüfen2Stichprobenartige Prüfung einer Datei oder Sprache auf Abruf; projektweit und wiederholbar ist eine App
Welche MT- oder KI-Übersetzungen sind sicher, ohne einen Menschen ausgeliefert zu werden3Qualitätsschätzungs-Apps aus dem Store; grobe Sortierung (Aufgabe für Nur-MT-Übersetzungen) ist Sache des Connectors

Terminologie, TM und Stil

ProblemSprosseMach dies
Glossar ist leer oder dünn2glossary-generation von einem Terminal aus; über den Connector Begriffe aus Quellstrings vorschlagen und nach Überprüfung hinzufügen
Entwickler möchten, dass die gerade hinzugefügten Strings sofort übersetzt werden, konsistent mit unserem Glossar und TM2translate von einem Terminal aus: Entwürfe in die lokalen Ressourcendateien, hochladen als nicht genehmigte Vorschläge; Massenarbeit ist Vorübersetzung (crowdin-cli)
Glossar hat Quellbegriffe, aber keine Übersetzungen2Glossar exportieren, als Quelldatei zur Übersetzung hochladen, zurück importieren
Begriffe müssen hinzugefügt oder korrigiert werden, während die Übersetzung läuft2Das Konzept finden, den Begriff hinzufügen oder aktualisieren; Übersetzer, die dies inline tun, benötigen die Editor-App
Kein Styleguide, daher driftet Ton und Formatierung2Regeln aus genehmigten Übersetzungen ableiten, den nativen Styleguide mit KI-Anweisungen schreiben
Übersetzungen sind nach einer Änderung des Glossars oder Styleguides veraltet1Bekannte Begriffsumbenennung: In Übersetzungen ersetzen, oder CroQL plus ein Label, wenn jede einzeln überprüft werden muss; eine Stilregel oder kontinuierliche Überwachung ist eine App
MT oder KI ignoriert unser Glossar und TM1Native KI-Prompts erhalten bereits Glossar, TM und verwandte Strings; DeepL beachtet DeepL-seitige Glossare; das Synchronisieren von Begriffen in DeepL ist eine App
Jedes Projekt erzeugt sein eigenes TM und Glossar1Weise das gemeinsame TM und Glossar in den Projekteinstellungen zu; das Zusammenführen von Streunern ist Sache des Connectors; das Automatisieren bei der Projekterstellung ist eine App
TM ist aufgebläht mit Duplikaten3Store: TM Cleaner (hält ein Backup); ein kleines TM kann nach einem Export per Connector dedupliziert werden
Ich benötige einen gefilterten Ausschnitt des TM, nicht den gesamten Export2CroQL über TM-Einträge (Daten, Nutzung, Autor), als CSV ausgeben; ungefiltert: nativer TM-Download
Abgeschlossene Übersetzungen sind nicht in einem TM, das ein anderes Projekt verwenden kann1Ein TM, mehreren Projekten zugewiesen; ein TM aus einer Teilmenge von Dateien ist Sache des Connectors
Legacy-übersetzte Dokumente oder TMX sind nicht intakt im TM1Nativer TM-Upload für TMX, XLSX, CSV; das Abgleichen von Dokumentpaaren oder das Beibehalten des Vorher/Nachher-Kontexts ist eine App
Übersetzer möchten externe Wörterbücher im Editor1Importiere die Termbasis als Glossar, und sie zeigt sich nativ; Live-externe Korpora sind Apps
KI wiederholt ständig Fehler, die Übersetzer bereits korrigiert haben1Enterprise: KI-Ausrichtung erstellt Glossarbegriffe aus menschlichen Übersetzungen; andernfalls vergleiche KI-Ausgabe mit genehmigten Übersetzungen

...

[abgeschnitten für die Übersetzung]

Verwandte Skills