Cursorでglobalize.now を使う
Cursorで構築したアプリから、コマンド1つで文字列を抽出してロケールファイルを生成できます。
Cursorは動作するUIを素早く生成しますが、通常は英語がJSXに直接ハードコードされます。globalize.now はそうしたハードコードされた文字列を抽出し、翻訳キーを生成してロケールファイルを作成することで、Cursorで構築したアプリを翻訳対応可能なコードベースに変えます。セットアップはコマンド1つで完了し、以降はGitへのプッシュのたびに同期されます。
前提条件
- Cursorで構築されたプロジェクト
- Gitリポジトリ
- Node.js 18以上
- 任意のJavaScript向けi18nライブラリ(i18nextやnext-intlなど)がインストールされていること。または、これから始める場合は不要です
Cursorでglobalize.now をセットアップする方法
Cursorプロジェクトを開き、Gitを確認する
Cursorでリポジトリを開き、コードベースがコミット済みでGitリモートにプッシュされていることを確認してください。これにより、以降のプッシュで同期がトリガーされるようになります。
プロジェクトのルートでスキルインストーラーを実行する
globalize.now でリポジトリを接続してアプリ内で変換するか、リポジトリのルートでターミナルからGlobalizeエージェントスキルをインストールし、アシスタントがi18nの足場を組んでツリーをスキャンできるようにします。
npx skills add globalize-now/globalize-skills --allエージェントにコードベースを解析させる
エージェントのプロンプトに従うことで、コンポーネントやルート全体からハードコードされたユーザー向け文字列を検出できます。
提案された翻訳キーの構成を確認する
ブランチにリファクタリングが反映される前に、提案されたキーの構造と命名を確認してください。
抽出とロケールファイルを確定する
変更を承認すると、キーが生成され、コンポーネントがリテラル文字列の代わりにランタイムのi18n APIを呼び出すようになり、ロケールファイルがリポジトリに書き込まれます。
コミットしてプッシュする
変更をコミットし、デフォルトブランチにプッシュしてください。これにより、globalize.now は以後のGitプッシュでも新しい文字列を確実に反映できます。
MCP経由で接続する(任意)
CursorからGlobalizeを操作したいですか? コードがi18n対応済みになったら、MCPを接続しましょう。
~/.cursor/mcp.json に追加
{"mcpServers":{"globalize":{"url":"https://api.globalize.now/mcp"}}}詳細: MCPを接続する →
よくある問題
Cursorが新しいハードコードされた文字列を追加し続ける
解決方法: globalize.now はGitへのプッシュのたびに実行されるため、新しいリテラル文字列は自動的に検出され、リリースの間に気づかないまま蓄積することがありません。
翻訳キーが既存のi18n設定と衝突する
解決方法: globalize.now は既存のi18nライブラリを検出し、その規約に従うため、新しいキーは既存のカタログと競合するのではなく、それを拡張する形になります。
よくある質問
globalize.now はCursorで生成されたどんなプロジェクトでも動作しますか?
はい、globalize.now がエージェントスキルを通じてサポートする技術スタック(Next.js、React、Vueといった主要なJavaScriptフレームワーク)であれば動作します。globalize.now は、どのエディタがJSXを生成したかではなく、ハードコードされたUI文字列を抽出してキーとロケールファイルを生成することに焦点を当てています。プロジェクトのルートで npx skills add globalize-now/globalize-skills を実行し、ガイドに沿って進めることで、エージェントがリポジトリをスキャンしてマージ可能な差分を作成できます。
Cursor特有のパターンを検出するために、globalize.now を設定する必要はありますか?
Cursor専用の連携設定は不要です。globalize.nowは、ファイルが手動で書かれたものかCursorによって生成されたものかに関わらず、同じ方法でリポジトリを解析します。スキルはユーザーに表示される文字列とルーティング構造を検出し、採用しているi18nライブラリに合ったキーを提案します。変更内容は他のコミットと同様にGit上でレビューできます。
すでに部分的にi18n対応済みのCursorプロジェクトでもglobalize.nowは使えますか？
はい。このツールは、既にキーやロケールファイルが存在する場合、それらを拡張するように設計されています。globalize.nowは使用中のランタイムライブラリを検出し、既存の作業を破棄することなく追加分のみを提案するため、段階的に文字列の移行を進められます。新しいUIを取りこぼさないよう、引き続きGitへのプッシュを行ってください。
Cursorプロジェクトにおいて、globalize.nowの出力はどのi18nライブラリに対応していますか？
globalize.nowは特定のライブラリに依存しません。i18next、next-intl、react-intl、Lingui、vue-i18nなど、一般的なランタイムに対応した構造化キーとロケールファイルを生成します。Cursorプロジェクトでは選択したスタックをそのまま使用でき、globalize.nowは抽出と同期のレイヤーを提供します。エージェントスキルは、フレームワークが必要とするプロバイダーやミドルウェアの設定もサポートします。
globalize.nowはCursorが生成したコンポーネントを変更しますか？
globalize.nowは、動作を変えることなく、文字列がi18n API（例えばt()やメッセージコンポーネントなど）を経由するように呼び出し箇所を書き換えます。他のCursor生成の変更と同様に、マージ前にGitで差分を確認できます。最初のマージ後は、個別のエクスポート作業なしに、以降のプッシュで新しい文字列が自動的に同期され続けます。
Cursor内でglobalize.nowはどこで実行すればよいですか？
必ずCursorの統合ターミナル（またはリポジトリのルートを指す任意のシェル）から、リポジトリのルートでnpx skills add globalize-now/globalize-skillsを実行してください。このスキルは現在のプロジェクトにスコープを絞り込み、ローカライゼーション用のスキルバンドルをインストールした上で、続きのプロンプト対応をエージェントに引き渡します。ルートで実行することで、CLIがツリーをスキャンする際のパス検出が正しく機能します。
Cursorでglobalize.nowを試す
プロジェクトのルートから開始してください：
npx skills add globalize-now/globalize-skills --all