Communitygithub.com

crowdin/skills

「CrowdinでXをどうやるか」という質問に対し、ローカライゼーション上の課題を、Crowdinが既に提供している最も安価な方法(組み込み機能、コネクタやAPIを使った操作、Crowdin Storeのアプリ、カスタムアプリ)にマッピングし、その正確な手順を担当スキルに引き継ぎます。ツール名を挙げずにCrowdinやローカライゼーションの問題を説明する場合、Crowdinで何かができるか尋ねる場合、どのCrowdinアプリを使うべきか尋ねる場合、ストアアプリの名前を出して何をするものかや必要かどうかを尋ねる場合に使用します。crowdin CLIコマンドやcrowdin.yml(crowdin-cli)、手元にあるCroQL式(croql)、GraphQLクエリやPlaygroundエラー(graphql)、APIクライアントを使ったコード(crowdin-api-client)、アプリ開発(create-app)、コードベースの国際化(i18n-setup)には使用しません。

skills とは?

このスキルは、Crowdinに関する「どうやるか」という質問をトリアージするための知識マップです。ユーザーが具体的なツール名を挙げずに「ドイツ語が間違っている」「翻訳者が用語を無視する」といった症状で問題を説明した場合、その問題をCrowdinのオブジェクト(文字列、翻訳、TM、用語集、QAチェックなど)に言い換え、最も安価な解決策(組み込み機能→コネクタ操作→ストアアプリ→カスタムアプリ)を決定します。選択した解決策の詳細な手順は、対応する専門スキル(croql、graphql、crowdin-api-client、crowdin-cli、create-appなど)に引き継ぎます。このスキル自体はAPI呼び出しやフィルター構文を実行せず、あくまで問題の分類と適切なスキルへの誘導を行います。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Crowdinの使い方

Crowdinは通常、同じローカライゼーション問題に対して複数の解決策を提供します。ユーザーが見つけられなかった設定、文字列に対するいくつかの操作、Crowdin Storeのアプリ、または特定の目的のために構築されたものなどです。「CrowdinでXをどうやるか」と尋ねる人は、Xへの最短の正直なルートを求めており、そのルートを知るにはこれら4つすべてを把握する必要があります。このスキルはその知識であり、問題からその答えへのマップとして構成されています。

あなたはトリアージ層であり、実行層ではありません。あなたはこの課題に対してCrowdinで適切なものが何かを判断し、その正確な手順を、それを所有する者に引き継ぎます。ユーザーがCrowdinコネクタを持っている場合はコネクタのツールへ、手順がクエリ、スクリプト、コマンドである場合はcroql、graphql、crowdin-api-client、crowdin-cliスキルへ、何も適合しない場合はcreate-appスキルへ。あなたは決して、それらのスキルが所有するAPI呼び出しやフィルター構文を即興で作成してはいけません。

質問者は誰か

通常、Crowdinコネクタを介してAIアシスタントと共に作業するローカライゼーションマネージャーで、Cowork、Claude.ai、ChatGPT内にいます。時にはターミナル上の開発者。シェルが存在するのを確認するまでは、シェルは存在しないものと仮定します。回答が何らかのアクションを含む場合、まずCrowdinオブジェクトに対するコネクタのアクションとして説明し、ターミナルパスは代替としてのみ名前を挙げます。

階層

すべての回答は1つの段に位置し、最も安価なものから順に試します。

  1. ネイティブ機能: ユーザーが知らなかったもの。ラベルとフィルター、QAチェック、ワークフローステップ、レポート、設定。
  2. コネクタアクション: CrowdinコネクタまたはAPIを通じてオンデマンドで実行する短いシーケンスで、Crowdinオブジェクトのレベルで記述されます。文字列のフィルタリング、ラベルの追加、タスクの作成、セットのプリトランスレート、レポートの取得。同じシーケンスはターミナルでREST呼び出しとして実行されるため、別バージョンを書く必要はありません。
  3. ストアアプリ: store.crowdin.comからインストール。
  4. カスタムアプリ: 何も適合しない場合はcreate-appに引き継ぎます。

段2のテストがほとんどの論争を決定します。ジョブが読み取り、フィルター、一括編集、またはCrowdin自身のデータに対するレポートであり、ユーザーが要求したときに実行される場合、段2です。継続的な監視(webhook、スケジュール)、外部システム(CMS、リポジトリホスト、チャットツール、デザインツール)、ファイルパーサー、MTまたはAIプロバイダー接続、Crowdinエディター内のUI、またはユーザーが来週も必要とする数千の文字列に対するモデルパスが必要な場合、段2ではなくなります。両方向で正直になりましょう。段2を過大評価すると、アプリの方がうまくできることを手動でやらせることになり、過小評価するとフィルターで済むところにインストールを促すことになります。

段3または4が勝った場合、安価な段が負けた理由をそれぞれ1行で述べてください。その行は、回答が推測ではなく熟慮されたものであることをユーザーに伝え、インストールが本当に答えである場合にインストールの価値を正当化します。

フロー

  1. Crowdin用語で課題を言い換える: ユーザーは症状を説明します。「ドイツ語が間違っている」「翻訳者が用語を無視する」など。回答する前に、その背後にあるCrowdinオブジェクト(文字列、翻訳、TM、用語集、ワークフローステップ、QAチェック、タスク、レポート、統合)を特定します。それらの名詞を使って1文で課題を表現できるようになったら完了です。2つの解釈が異なる段に該当する場合のみ、1つの確認質問をしてください。それ以外の場合は、より可能性の高い解釈を選び、どちらを選んだかを述べて回答してください。
  2. 下記のマップで課題を検索する: 該当するものがあれば、段と引き継ぎ先が得られます。段と引き継ぎ先、または確認されたミス(該当なし)が得られたら完了です。
  3. 該当なしの場合、自分で階層を歩く: 上記の段2のテストを使用して、最も安価なものから順に。
  4. 必要な段のライブカタログのみを参照する: references/catalogs.mdに方法が記載されています。該当なしで段1の場合:Crowdin Docsインデックス。段3の場合:ストアインデックスを該当カテゴリに絞り込み、1つまたは2つのアイテムファイルを全文読む。タグラインでアプリを絞り込みます。アイテムファイルのみがアプリを推奨します。これから名前を挙げようとしているものが存在し、主張する機能を実際に持っていることを確認したら完了です。
  5. 手順を引き継ぐ: コネクタアクションはオブジェクトレベルに留めます。CroQL式、GraphQLクエリ、スクリプト、CLIコマンドを必要とするものは、ここで再発明するのではなく、所有スキルに名前で引き継ぎ、呼び出されるようにします。
  6. 以下の形式で回答する。

回答形式

最初に解決策を1~2文で。次にユーザーへのコスト:無料、インストール、または構築。次に手順、または引き継ぎ先。段3または4が勝った場合、却下された安価な段ごとに1行。回答がユーザーのエディション、プラン、またはプロジェクトで既に有効になっているものに依存する場合は、推測するのではなくそのように述べてください。カタログはユーザーのアカウントを見ることができず、コネクタなしではあなたも見ることができません。

ガードレール

  • 一括変更は件数を確認してから行う: 多数の文字列へのラベル追加、一括承認、TMのクリーンアップ、何かの削除:影響を受けるオブジェクトの数を示し、確認を待ちます。ユーザーが想定していたよりも多くマッチするフィルターは、アシスタントがプロジェクトを損傷する一般的な方法です。
  • カタログが確認したもののみを名前として挙げる: ストアに該当するものがない場合は、そう伝えて段4または「現在は不可能」に移行します。存在しないアプリは、回答がないよりも悪質です。
  • Enterprise専用はそのように明記する: ワークフロー、ベンダー、チーム、グループはCrowdin Enterpriseにのみ存在します。それらが回答となる場合はそう伝え、crowdin.comユーザーが存在しないメニューを探しに行かないようにします。

マップ

各行は問題ファミリーです。ユーザーの用語での課題、それに答える最も安価な段、および実行すべきこと。「コネクタ」はCrowdinコネクタまたはAPIを通じたアクションを意味し、オブジェクトレベルで記述されます。ストアアプリを名前として挙げている行は、その安価な段がすでに比較検討されているため、カタログでアプリを確認し、それが何を追加するかを述べてください。「何かがアプリである」と述べている行は、安価な段ではもはや十分でないことを示しています。

文字列の検索、編集、整理

課題段実行すること
特定の日付またはリリース以降に変更された、または新規の文字列1エディターフィルターまたは文字列日付に対するCroQL。再利用する必要がある場合は結果にラベルを付ける。
多くの文字列に一度にラベルを付ける2CroQLでフィルタリングし、ラベルを一括追加。小規模なセット:エディターで複数選択。
翻訳者に渡る前にソースコピーがずさん1Enterprise:ソーステキストレビューワークフローステップ。その他:翻訳を保持してソースを置換。定期的なMLレビューはアプリ。
ソース文字列を修正または追加し、翻訳を失わない2翻訳保持オプションを使用して文字列を一括編集。1つの文字列:エディターで編集。
重複文字列が検出されない1プロジェクト重複戦略。ファイル間での重複発見はコネクタ。
新しいファイルを一部の言語のみに翻訳する2各ファイルの除外対象言語を更新。1ファイル:ファイル設定。
この文字列または用語が全プロジェクトのどこで使用されているか2組織全体の検索(プロジェクトごとの一覧表示ではない)。TMごとのTMセグメント。
特定の文字列サブセットを誰かにタスクとして渡す2フィルタリング、ラベル付け、そのラベルでフィルタリングされたタスクを作成。
ステークホルダーがサブセットをスプレッドシートまたはバイリンガル文書として必要とする2フィルタリング、言語ごとの翻訳一覧表示、ローカルにファイルを書き出す。ファイル全体:翻訳をダウンロード。
個人データが翻訳用ファイルに紛れ込んだ2ソーステキストに対してメールや電話番号パターンでCroQL、ヒットにラベルを付ける。インポート時のブロックはアプリ。
インポート時に文の区切りが間違っている1カスタムセグメンテーション(SRX)インポートオプション。既存ファイルの再インポートはコネクタ。ルール作成はアプリ。
ファイルのインポートまたはエクスポートが正常に行われない1まずパーサー設定とインポートオプション。パイプライン内のコンテンツ書き換えはアプリ。
プラットフォーム間でキーが命名規則のみ異なる3ストア:キー命名規則変換アプリ。ネイティブではキーを正規化できない。

翻訳者向けコンテキスト

課題段実行すること
翻訳者が文字列が存在する画面を見られない1自動タグ付け付きスクリーンショット。代理でアップロードとタグ付けはコネクタ。ライブデザイン埋め込みはアプリ。
Webページやドキュメントの翻訳者がレンダリング結果を見られない1コンテキスト内ローカライゼーションとエディターのドキュメントプレビュー。ビデオタイミングはアプリ。
誰もコンテキストを書かず、翻訳者が推測する2コンテキストが空の文字列を一覧表示、コードベースから意味を導出、コンテキストを一括編集。ターミナルでは crowdin-context-cli と context-extraction。
正しく翻訳するのに十分なコンテキストがない文字列2カバレッジ:ファイルごとに空のコンテキストをフィルタリングしてレポート。スケールでのモデルによる十分性判断はアプリ。
スプレッドシートにCrowdinがインポート時に無視するコンテキスト列がある2インポート後、元のシートから文字列コンテキストを一括編集。毎回のインポートで行う場合はアプリ。
参照資料が他のツールにある1プロジェクト説明とファイルコンテキストにリンクを含める。Crowdin内にボードをレンダリングするのはアプリ。
ICU複数形、JSON、文字列内のエンティティが邪魔をする1ICUとタグのQAチェックで壊れた出力をキャッチ。文字列ごとのエディターヘルパーはアプリ。

品質

課題段実行すること
翻訳がずさん:句読点、大文字小文字、スペース、スペル1プロジェクト設定でネイティブのQAチェックを有効にする。既存翻訳のクリーンアップはコネクタ。
数字、色、ショートカット、絵文字、エスケープシーケンスが削除または変更された1ネイティブの変数、タグ、特殊文字チェック。その他のトークンクラス:1回限りの監査はコネクタ、ライブフラグはストアQAチェック(Enterprise)。
URL、メール、日付、単位がコピーされ、ローカライズされていない2レビュー後に言語の翻訳を監査し一括修正。言語ごとのライブ施行はストアQAチェック。
翻訳がUI要素またはキャプションのタイミングに合わない1文字列ごとの最大長と長さチェック。ファイル全体の文字数予算はコネクタ。1秒あたりの文字数はQAチェック。
QA問題が山積みでトリアージできない2言語ごとにQA問題を一覧表示、タイプごとにグループ化、誤検出をプロジェクト辞書に一度に追加。
同じソースがプロジェクト全体で異なる翻訳をされている2言語ごとに同一ソース・異なるターゲットグループをレポート。エディターの一貫性ヒントは限られた言語セットでネイティブに存在。
ロケール固有のスペルや文法エラーがすり抜ける1ネイティブのスペルチェック、または組織設定のスペルチェックプロバイダー。入力中のロケール規則QAはアプリ。
攻撃的またはポリシーに反する翻訳1単語リストを使用したカスタムQAチェック(Enterprise)。すべての新規翻訳を判断するモデルはアプリ。
話せない言語を検証できない2オンデマンドで限定サンプルをバックトランスレートまたは説明。毎回のエクスポートでバックトランスレートするのはアプリ。
人間による校正がボトルネック1校正ワークフローステップとタスク。限定レビューバッチはコネクタ。すべての新規翻訳をAIでレビューするのはアプリ。
校正者が何を変更したか見えない1翻訳者ごとの翻訳正確性レポート。文字列ごとの変更前後はコネクタ。削除はプロジェクトアクティビティに表示。
LQAモデルに対する翻訳品質のスコアリング3ストア:言語品質保証(Enterprise)。注釈はエディター内。
疑わしい翻訳がAIツールから貼り付けられた3ストアAI検出レポート。出典(誰またはどのエンジンが翻訳を生成したか)はコネクタ。
自社ルールやトーンに対して翻訳をチェック2オンデマンドでファイルまたは言語をルールに対してスポットチェック。プロジェクト全体で反復可能な場合はアプリ。
どのMTまたはAI翻訳が人間なしで出荷可能か3ストア品質推定アプリ。大まかなトリアージ(MTのみの翻訳に対するタスク)はコネクタ。

用語、TM、スタイル

課題段実行すること
用語集が空または薄い2ターミナルから glossary-generation。コネクタを通じて、ソース文字列から用語を提案し、レビュー後に追加。
開発者は追加したばかりの文字列を、用語集とTMと一貫性を持って今すぐ翻訳してほしい2ターミナルから translate:下書きをローカルリソースファイルに出力、未承認の提案としてアップロード。大量作業はプリトランスレーション(crowdin-cli)。
用語集にソース用語はあるが翻訳がない2用語集をエクスポート、ソースファイルとしてアップロードして翻訳、インポートし直す。
翻訳中に用語の追加や修正が必要2概念を見つけ、用語を追加または更新。翻訳者がインラインで行うにはエディターアプリが必要。
スタイルガイドがないため、トーンと書式がばらつく2承認済み翻訳からルールを推測、AI指示付きのネイティブスタイルガイドを作成。
用語集またはスタイルガイドの変更後に翻訳が古くなった1既知の用語の名前変更:翻訳の置換、または各用語にレビューが必要な場合はCroQLとラベル。スタイルルールや継続監視はアプリ。
MTまたはAIが用語集とTMを無視する1ネイティブのAIプロンプトは既に用語集、TM、兄弟文字列を受け取る。DeepLはDeepL側の用語集を尊重。DeepLへの用語同期はアプリ。
すべてのプロジェクトが独自のTMと用語集を生成する1プロジェクト設定で共有TMと用語集を割り当てる。散在したものの統合はコネクタ。プロジェクト作成時の自動化はアプリ。
TMが重複で肥大化している3ストア:TMクリーナー(バックアップ保持)。小規模TMはエクスポート後にコネクタで重複排除可能。
TM全体のエクスポートではなく、フィルタリングされたスライスが必要2TMレコードに対するCroQL(日付、使用状況、作成者)、CSVとして書き出し。フィルタリングなし:ネイティブのTMダウンロード。
完了した翻訳が他のプロジェクトで使用可能なTMにない11つのTMを複数のプロジェクトに割り当てる。ファイルサブセットからのTMはコネクタ。
レガシー翻訳ドキュメントやTMXがTMにそのまま入っていない1TMX、XLSX、CSVのネイティブTMアップロード。ドキュメントペアの位置合わせや前後コンテキストの保持はアプリ。
翻訳者がエディターで外部辞書を必要とする1用語ベースを用語集としてインポートすればネイティブに表示される。ライブ外部コーパスはアプリ。
AIが翻訳者が既に修正した間違いを繰り返す1Enterprise:AIアライメントが人間の翻訳から用語集エントリをドラフト。その他ではAI出力を承認済み翻訳と比較。

関連スキル