任意のJiraチケットに「lingo」ラベルを追加するだけ。AIエージェントが課題を分析し、ISO 5060に沿って分類し、エンジン設定を確認したうえで、具体的な用語集項目、指示、ブランドボイスの変更を提案します。承認はワンクリックです。
Jira Cloud と Jira Service Management に対応しています。
課題#
ローカリゼーションを積極的に進めるプロダクトチームには、フィードバックが絶え間なく届きます。翻訳バグ、ロケール対応漏れ、書式の不備、文化的なミスマッチ。
トリアージ、つまり本当にローカリゼーションの問題なのか、どう対処すべきか、どのエンジンを更新すべきかを見極める工程は、修正そのもの以上に時間を奪います。
週100件以上のローカリゼーション関連チケットを処理するチームでは、分類と振り分けだけで15〜20時間かかることも珍しくありません。多くのチケットで必要なのは、用語集エントリの追加、指示の更新、またはブランドボイスの調整です。ダッシュボード上での反映は数秒でも、何を変えるべきかを見極めるには人の判断が数分単位で必要になります。
仕組み#
JiraプロジェクトをLingo.devの組織に接続します。誰かが任意のチケットに「lingo」ラベルを追加すると、自動的に次の5つが実行されます。
Webhookが起動
JiraがLingo.devに通知し、トリアージジョブがJobsダッシュボードに表示されます。
AIが課題を調査
エージェントがチケットの要約、説明、コメントを読み込みます。ISO 5060の翻訳品質フレームワークを参照し、ロケールごとの規範を確認したうえで、既存のエンジンの用語集、指示、ブランドボイスをレビューします。すでに存在する項目は提案しません。
構造化された判断
エージェントがエラーを分類し（カテゴリ + 重大度）、粒度の揃った提案を生成します。1つの提案につき、用語集項目は1つ、指示は1つです。チケットがローカリゼーション関連でない場合は、理由を説明するJiraコメントを付けて自動でクローズされます。
人によるレビュー
すべての提案が同時に表示されます。各提案には種類に応じたボタンがあります。たとえば「用語集項目を追加」「指示を追加」「タスクを作成」です。各提案は個別に承認または却下できます。承認内容をいったんまとめ、その後、承認済みの変更を一括で実行します。
自動実行
承認された提案はすぐに実行されます。専用エージェントが適切なエンジンを特定し、操作内容を検証して変更を適用します。用語集の提案は実際の用語集エントリに、指示の提案は実際のロケール指示になります。
Jiraコメントまで自動で完結#
トリアージが完了すると、判断理由、ジョブ詳細へのリンク、「Provided by Lingo.dev Localization Intelligence」という署名付きのコメントがJiraチケットに投稿されます。ラベルを追加した人は、ダッシュボードを開かなくてもJira上で直接結果を確認できます。
コメントの投稿者
コメントは、Jira連携を接続したユーザー名義で投稿されます（OAuthの制約によるものです）。中立的なアカウント名義で投稿したい場合は、共有のサービスアカウントでJiraを接続してください。
代表的なシナリオ#
翻訳漏れ#
チケット: 「チェックアウトページでスペイン語訳が表示されない - es-MXユーザーには『Place Order』ボタンが英語のまま表示される」
トリアージ結果: ISO 5060の正確性の問題、重大度はmajor。エージェントは本番エンジンを特定し、次を提案します。
- 用語集項目を追加: "Place Order" -> "Realizar pedido" (en -> es-MX)
- 用語集項目を追加: "Shipping Address" -> "Direccion de envio" (en -> es-MX)
どちらもワンクリック。用語集エントリがエンジンに作成されます。
ロケール書式の問題#
チケット: 「ダッシュボードで韓国語の日付形式がYYYY.MM.DDではなくMM/DDで表示される」
トリアージ結果: ISO 5060のロケール慣習、重大度はmajor。次を提案します。
- ko-KR向けの指示を追加: "日付はYYYY.MM.DD形式、時刻は24時間形式で表示する"
ローカリゼーション無関係のチケット#
チケット: 「ピーク時にAPIのレート制限で429エラーが返る」
トリアージ結果: ローカリゼーション関連ではありません。理由を説明するコメントが自動でJiraチケットに投稿されます。人によるレビューは不要です。
テキスト拡張 / レイアウトの問題#
チケット: 「ドイツ語の複合語がサイドバーのナビゲーションボタンからはみ出す」
トリアージ結果: ISO 5060のデザインとマークアップ。CSS修正用のJiraタスク（コード変更への対応は今後のバージョンで提供予定）に加え、ドイツ語の文字数制約への配慮に関する指示を提案します。
複数ロケールのチケット#
チケット: 「pt-BR、es-MX、ja-JPユーザー向けにダッシュボードが未翻訳」
トリアージ結果: エージェントは、言及された各ロケールごとに別々の用語集項目を提案します。各提案は独立しており、それぞれ個別にレビューできます。
AIにできること / できないこと#
| できること | まだできないこと |
|---|---|
| 翻訳付きの具体的な用語集項目を提案する | コードを修正したり翻訳ファイルを直接変更したりする |
| ロケールごとの指示を作成する | コード変更を含むプルリクエストを作成する |
| ブランドボイスのエントリを更新する | Jira課題のステータスを変更する |
| 開発者向け作業のJiraタスクを作成する | 承認なしで変更を自動マージする |
| ISO 5060を使って課題を分類する | |
| 重複を避けるために既存のエンジン設定を読み取る |
コードレベルの修正
コード変更が必要な課題（RTL CSS、新しいロケールファイル、エンコーディングなど）では、エージェントが詳細な説明付きのJiraタスクを作成します。プルリクエストによる直接的なコード修正は、今後のバージョンで提供予定です。
ライフサイクル管理#
このワークフローは、あらゆる状態変更を追跡します。
| イベント | 発生すること |
|---|---|
| ラベル追加 | ジョブが作成され、トリアージが実行され、提案が表示される |
| ラベル削除 | 進行中のジョブをキャンセルし、イベントを記録 |
| ラベルを再追加 | 同じジョブを完全な履歴付きで再オープンし、新たなトリアージを実行 |
| 課題をクローズ | 進行中のジョブをキャンセルし、イベントを記録 |
| 課題を削除 | 進行中のジョブをキャンセルし、イベントを記録 |
Jira課題ごとにジョブは1つ。完全な監査証跡が残ります。ラベルを削除して再追加すると、過去のイベントをすべて保持したまま同じジョブが再オープンし、その上で新たなトリアージが実行されます。
提案タイプ#
各提案は、1つの操作に対応します。
| 提案 | 内容 | ボタン |
|---|---|---|
| 用語集項目を追加 | 用語の対応を作成する | "用語集項目を追加" |
| 用語集項目を更新 | 既存の翻訳を変更する | "用語集項目を更新" |
| 用語集項目を削除 | 用語の対応を削除する | "用語集項目を削除" |
| 指示を追加 | ロケール指示を作成する | "指示を追加" |
| 指示を更新 | 既存の指示を変更する | "指示を更新" |
| ブランドボイスを追加 | ロケール用のブランドボイスを作成する | "ブランドボイスを追加" |
| ブランドボイスを更新 | 既存のブランドボイスを変更する | "ブランドボイスを更新" |
| Jiraタスクを作成 | 開発者向け作業のチケットを作成する | "タスクを作成" |
| 課題をクローズ | 理由を説明するコメントを投稿する | "課題をクローズ" |
エンジンの変更を優先
エージェントは、Jiraタスクよりもエンジン設定（用語集、指示、ブランドボイス）を優先します。タスクを提案するのは、RTL CSS修正、新しいロケールファイル、エンコーディングの問題など、開発者によるコード変更が必要な場合だけです。
ベストプラクティス#
迷ったらラベルを付ける。 ローカリゼーション関連かもしれないものには、まず「lingo」を追加してください。AIが無関係なチケットを自動で除外し、理由を説明するコメントを投稿します。誤検知のコストはありません。
ラベル付け前にコンテキストを足す。 チケットの説明やコメントが詳しいほど、トリアージの精度は上がります。影響を受けるロケール、期待される文言と実際の文言、UIのどこで問題が起きているかを記載してください。
各提案は個別にレビューする。 AIはコンテキストに基づいて具体的な翻訳を提案しますが、プロダクトの用語を最もよく理解しているのはあなたです。正しいものだけを承認し、適切でないものは却下してください。
まずエンジン設定を確認する。 エージェントは変更を提案する前に、既存の用語集と指示を読み取ります。特定のロケールに対してエンジンがすでに十分に整備されていれば、提案もより的確になります。
Jiraタスクは必要なときだけ作成する。 エージェントがJiraタスクを提案した場合は、承認前にドロップダウンから対象プロジェクトを選択します。関連チームが実際に作業するプロジェクトを選んでください。
セットアップ#
Jiraを接続
Settings に移動し、Jira（Atlassian App）の下にある Connect をクリックします。Atlassianで認証してください。
各Jiraサイトは、1つのLingo.dev組織にしか接続できません。「Jira site already connected」と表示された場合は、先に別のorgから切断してください。
ラベルを追加
任意のチケットに lingo ラベルを追加します。大文字小文字は区別されません。"Lingo"、"LINGO"、"lingo" はすべて有効です。トリアージは数秒以内に始まります。
ダッシュボードでレビュー
サイドバーで Jobs を開きます。トリアージジョブにはリアルタイムのステータスが表示されます。ジョブをクリックすると、完全なタイムラインと提案を確認できます。
Webhookのメンテナンス
JiraのWebhookは毎週自動更新されます。Webhookが発火しなくなった場合は、SettingsでJiraを再接続して再登録してください。
ISO 5060分類#
関連するチケットはすべて、ISO 5060:2024を使って分類されます。
| カテゴリ | 対象 |
|---|---|
| 用語 | 用語の不一致または誤り |
| 正確性 | 誤訳、欠落、未翻訳コンテンツ |
| 言語慣習 | 文法、スペル、句読点、エンコーディング |
| スタイル | 文体、言い回し、不一致 |
| ロケール慣習 | 日付、数値、通貨の書式 |
| 対象読者への適切性 | 文化的参照、インクルーシブ表現 |
| デザインとマークアップ | レイアウト、切り詰め、テキスト拡張、RTL |
重大度は3段階です。critical（使用不能）、major（理解に影響）、minor（見た目のみ）。
近日公開#
現在、Jiraトリアージの次期バージョンを開発中です。
- エンジン変更の自動適用 - 組織ごとに設定できます。有効にすると、用語集項目、指示、ブランドボイスの提案は、人による承認を待たずに自動実行されます。レビューは必須ではなく、任意になります。
- プルリクエスト作成 - コード変更が必要な課題では、エージェントがJiraタスクを作成する代わりに、接続済みのGitHubリポジトリへ直接PRを作成します。
- 一括トリアージ - 複数のチケットに一度にラベルを付け、すべての提案を1つのバッチビューでレビューできます。
