globalize-now-account-setup

Globalize アカウントのセットアップ

Globalize CLI（@globalize-now/cli-client）を使うと、AI エージェントはGlobalizeプラットフォーム上の翻訳プロジェクト、言語、用語集、スタイルガイド、リポジトリ接続を管理できます。

このスキルでは、CLI をインストールしてアカウントを認証します。サインインしたら、globalize-now-project-setup を実行して翻訳プロジェクトを作成し、リポジトリを接続してください。

以下の手順を順番に実行してください。

---

セットアップモード

ステップ 1（検出）が問題なく完了したら、ユーザーに次のように尋ねます。

どのように進めますか？

1. ガイド付き — 各ステップの前後に説明します。
2. ガイドなし — 途中で止まらずにすべてのステップを実行し、最後に概要をまとめて表示します。

ガイド付きモードのルール

• 各ステップの前：何を行うのか、なぜ行うのかを簡潔に説明します。
• 各ステップの後：変更内容（インストールしたファイル、作成した設定、実行したコマンド）をまとめます。

ガイドなしモードのルール

• ステップごとの説明で中断せず、すべてのステップを実行します。
• ハードストップ（例：Node.js が見つからない場合）は引き続き実行を停止します。これらは省略できません。
• 最後に、概要を作成します。

## Account Setup Complete

### What was done
- [x] Step 1: Detect Environment — {Node version, existing auth yes/no}
- [x] Step 2: Install CLI — {npx or global}
- [x] Step 3: Authenticate — {auth method}
- [x] Step 4: Verify — {org name}

### Next steps
- Run `globalize-now-project-setup` to create a translation project and connect this repo.

---

ステップ 1：環境を検出する

続行する前に、以下を確認します。

シグナル	検出方法
Node.js	node --version が終了コード 0 で終了し、バージョンが 18 以上であること。CLI に必要です。
既存の認証	~/.globalize/config.json に apiKey フィールドがある、または GLOBALIZE_API_KEY 環境変数が設定されていること。

検出結果

Node.js が見つからない、またはバージョンが 18 未満の場合：ハードストップ — CLI には Node.js 18 以上が必要です。続行する前に Node.js をインストールまたはアップグレードするようユーザーに依頼してください。

認証がすでに設定されている場合（apiKey を含む ~/.globalize/config.json がある、または GLOBALIZE_API_KEY が設定されている場合）、ログインの手順を省略し、ステップ 4：検証に進んで認証情報が機能することを確認します。

問題が見つからなかった場合は、ステップ 2 に進む前にセットアップモードの選択を促します。

---

ステップ 2：インストール

グローバルインストールは不要です。npx を使ってコマンドを直接実行します。

npx @globalize-now/cli-client <command>

ユーザーが希望する場合は、グローバルにインストールすることもできます。

npm install -g @globalize-now/cli-client

バイナリ名は globalise-now-cli です。

---

ステップ 3：認証する

CLI は次の順序で認証情報を解決します。

1. GLOBALIZE_API_KEY 環境変数 — CI/CD に最適です
2. ~/.globalize/config.json 設定ファイル — ローカル開発に最適です
3. 対話型ログイン — ブラウザーを使ったデバイス認証フローです

すでに認証されている場合

次のコマンドで確認します。

npx @globalize-now/cli-client auth status --json

有効な source と key が返された場合、認証はすでに設定されています。ステップ 4 に進みます。

認証されていない場合

デバイス認証フローを、ブロックせずに開始します。

npx @globalize-now/cli-client auth login --no-wait --json

これにより、承認を待たずにデバイスコード情報が返されます。

{
  "data": {
    "user_code": "ABCD-1234",
    "verification_uri_complete": "https://...",
    "device_code": "...",
    "code_verifier": "...",
    "expires_in": 900,
    "interval": 5
  }
}

verification_uri_complete の URL と user_code をユーザーに提示し、ブラウザーで URL を開いて承認するよう依頼します。

ユーザーが承認したことを確認したら、認証を完了します。

npx @globalize-now/cli-client auth complete \
  --device-code <DEVICE_CODE> \
  --code-verifier <CODE_VERIFIER> \
  --json

成功すると、API キーが ~/.globalize/config.json に保存され、次の内容が返されます。

{
  "data": {
    "org": "...",
    "status": "authenticated"
  }
}

ユーザーがまだ承認していない場合、承認されるかコードの有効期限が切れるまでコマンドはポーリングを続けます。

注： 対話型ターミナルでは、auth login（--no-wait なし）を実行すると、ブラウザーを開き、承認を待ってキーを保存するまでの全フローが自動的に実行されます。エージェントとして実行する場合は、--no-wait と auth complete を使用してください。

---

ステップ 4：検証する

すべてが機能することを確認するため、両方のコマンドを実行します。

npx @globalize-now/cli-client auth status --json

これにより、source、key（プレフィックス）、api（URL）を含む JSON が返されます。

次に、API への接続を確認します。

npx @globalize-now/cli-client orgs list --json

これにより、ユーザーの組織が返されます。認証エラーが発生した場合は、ステップ 3 を再確認してください。

---

次のステップ

CLI がインストールされ、サインインしました。翻訳プロジェクトを作成し、このリポジトリを接続して、カタログファイルのパターンを設定するには、globalize-now-project-setup スキルを実行してください。