Teamwork Graph CLI の一般的な問題を修正する

現在、このエクスペリエンスはベータ版です。

Teamwork Graph (TWG) CLI のセットアップが期待どおりに機能しない場合は、このガイドを使用して一般的な問題を診断し、修正してください。各セクションで特定の問題とそれを解決する手順について説明しているため、すぐにアトラシアン ツールでの作業に戻ることができます。

一般的な課題

インストール後に「Command not found: twg (コマンドが見つかりません: twg)」と表示される

シェルで TWG CLI バイナリが見つかりません。これは通常、インストール ディレクトリが PATH に含まれていないことを意味します。

修正するには:

  1. ls ~/.local/bin/twg を実行して、TWG CLI がインストールされたことを確認します。

  2. ファイルが存在する場合は、~/.local/bin を PATH に追加します。追加する正確な行は、インストーラーに表示されたものです。

  3. ターミナルを再起動し、twg --version を実行して動作を確認します。

認証が失敗するか、「Unauthorized」エラーが発生する

このエラーにはいくつかの理由が考えられます。

API トークンのタイプが間違っている: スコープ付きトークンではなく、クラシック (スコープなし) API トークンを使用する必要があります。「TWG CLI の利用を開始する」をご覧ください。

トークンが期限切れになったか、取り消された: id.atlassian.com で新しいトークンを作成し、twg login を再度実行してください。

サイト名が間違っている: サイト名はサブドメインのみにする必要があります (例: mycompany.atlassian.net ではなく mycompany)。

メール アドレスが間違っている: メール アドレスが Atlassian アカウントと一致していることをご確認ください。

エージェントで TWG CLI のスキルが使用されない

TWG CLI がインストールされているにもかかわらず、エージェントがアトラシアンのデータをクエリしていません。

修正するには:

  1. twg skills install を実行して、スキルがインストールされていることを確認します。

  2. スキルがプロジェクト フォルダー (.agents/skills/twg/) にインストールされたことを確認します。一部のエージェントは、プロジェクト レベルのフォルダーからのみスキルを取得します。

  3. インストール後、エージェントまたはエディターのセッションを再起動します。

インストール中に Windows SmartScreen の警告が表示される

インストーラーを実行すると、Windows で SmartScreen の警告が表示される場合があります。

続行するには: [詳細情報] > [実行] の順に選択します。

Bitbucket コマンドがエラーを返す

Bitbucket 固有のプロンプトが失敗するが、Jira と Confluence が機能している場合は、Bitbucket アプリのパスワードを設定していない可能性があります。

修正するには: twg login を再度実行し、プロンプトに従って Bitbucket アプリのパスワードを入力します。完了したら、Bitbucket コマンドを再試行して、正常に動作するかをご確認ください。

twg doctor でセットアップを確認する

TWG CLI には、セットアップが正しく機能しているかどうかをチェックする組み込みの診断コマンドが含まれています。

チェックを実行する

 

twg doctor

各チェックは、短いメッセージとともに pass または fail として表示されます。

twg doctor のチェック項目

チェックマーク

意味

ビルド情報

TWG CLI がインストールされていることを確認し、現在のバージョンを表示します。

認証

アトラシアンの認証情報が保存され、読み取り可能であることを確認します。

API 接続

TWG CLI が認証情報を使用して Atlassian API に到達できるかどうかをテストします。

インストール済みスキル

プロジェクトにエージェント スキルがインストールされているかどうかを確認します。

チェックに失敗した場合

ビルド情報: TWG CLI を再インストールします。「TWG CLI の利用を開始する」を参照してください。完了後、確認のために再度 twg doctor を実行してください。

認証: twg login を再度実行します。「TWG CLI の利用を開始する」を参照してください。完了後、確認のために再度 twg doctor を実行してください。

API 接続: ネットワーク接続を確認し、API トークンが有効であることを確認してください。VPN を使用している場合は、アトラシアンのドメインにアクセスできることを確認してください。完了後、確認のために再度 twg doctor を実行してください。

スキルのインストール: twg skills install を実行します。「TWG CLI の利用を開始する」を参照してください。完了後、確認のために再度 twg doctor を実行してください。

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。