sonar-list-projects

SonarQube — プロジェクトの一覧表示

認証済みユーザーがアクセスできる SonarQube プロジェクトを一覧表示します。他のスキルを実行する前に、プロジェクトキーを確認するのに便利です。

使用方法

sonar-list-projects                      # list all accessible projects
sonar-list-projects my-project              # search by name or key

前提条件

このスキルでは sonarqube-cli コマンドを使用します。続行する前に、CLI をインストールして認証する必要があります。

続行する前に、sonar が PATH 上で利用可能で、認証済みであることを確認してください。利用できない場合は、代替コマンドを呼び出したり、代替手段を考案したりせず、ユーザーに次の内容を表示してください。

プロジェクトを一覧表示できません。

考えられる原因：

• sonarqube-cli がインストールされていない、または認証されていません — sonar-integrate スキルを呼び出してください

その後、今すぐ sonar-integrate スキルを実行するかどうかをユーザーに（はい／いいえで）尋ねてください。そのスキルで何を行うかを簡潔に説明してください。ユーザーのマシン上の SonarQube のセットアップを確認し、sonarqube-cli のインストールまたは更新と認証の検証を行い、SonarQube MCP サーバーやシークレットスキャンフックなど、このエージェント向けの連携を再設定します。ユーザーが承諾した場合は、自分で sonar-integrate スキルを呼び出し、このセッションで最後まで実行してから、再確認して続行してください。断った場合は、そこで停止してください。

手順

ステップ 1：ユーザーから提供された引数から任意の検索語を解析する

• ユーザーが検索語（フラグ以外）を指定した場合は、--query として渡します。

ステップ 2：引数を検証する

--query の検索語が指定されている場合は、^[a-zA-Z0-9_\-\. ]+$ に一致することを検証します。一致しない場合は停止して、何が拒否されたかをユーザーに伝えてください。コマンドは実行しないでください。

ステップ 3：sonar list projects を実行する

シェルコマンドを使用してコマンドを組み立て、実行します。

sonar list projects [--query <search-term>]

検索語が指定されている場合にのみ --query を含めてください。

ステップ 4：結果を整形する

プロジェクトが見つかった場合：

## SonarQube Projects

Found **8 project(s)**:

| Project key       | Name            |
| ----------------- | --------------- |
| my-org_backend    | Backend Service |
| my-org_frontend   | Frontend App    |
| my-org_shared-lib | Shared Library  |

プロジェクトが見つからなかった場合：

## SonarQube Projects

No projects found. If you expected results, check your authentication with `sonar auth status`.

結果がページ分割されている場合（500 プロジェクトが返された場合）は、次のように伝えてください。「最初の 500 件のプロジェクトを表示しています。検索語を指定して結果を絞り込んでください。」

ステップ 5：次の手順

• イシューを一覧表示するには、「プロジェクトキーを指定して sonar-list-issues スキルを呼び出すか、sonar.projectKey が sonar-project.properties に含まれていることを確認してください。CLI では常に -p が必要です。」
• Quality Gate を確認するには、「sonar-quality-gate スキルを呼び出してください。MCP 連携のデフォルトを使用しない場合にのみ、プロジェクトキーを追加してください。」