qodo-setup について
qodo-setup は、Qodo CLI または接続済み QAR へのアクセスを確認するセットアップスキルです。確認済みの本人確認やツール利用可否と、未検証の権限を区別し、認証情報は扱いません。
主な機能
- 01QAR の読み取りアクセス確認
- 02Qodo CLI の導入と確認
- 03本人確認とツールカタログの確認
- 04アクセスエラーの安全な報告
活用シーン
- 01Qodo タスク前のアクセス確認
- 02必要に応じた CLI アクセス設定
MCP 対応
接続済み MCP の経路では、QAR ツールのスキーマを調べ、無害な読み取り専用ツールを1つ実行します。認証情報を求めずに MCP のアクセス問題を報告します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/qodo-setupを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/authentication.mdhost-recovery.mdruntime.mdskill-updates.md詳細
Qodo のセットアップ
説明
利用可能な Qodo の経路を確認します。スキルをインストールしても、アカウントやツールへのアクセスが確認されたことにはなりません。
前提条件
CLI のセットアップにはシェル、またはホストに接続された QAR MCP サーバーが必要です。認証情報は決して扱わないでください。
手順
接続済み MCP の経路
接続済みの QAR ツールのスキーマと注釈を調べます。無害な入力で読み取り専用ツールを 1 つ呼び出してください。カタログで確認できても、読み取りアクセスが確認されたことにはなりません。structuredContent より先に isError を確認してください。実行エラーがある場合は、準備完了とは見なせません。読み取りでは書き込み権限を確認できないため、ユーザーが承認した操作を行うまでは、書き込みは未確認として報告してください。テスト書き込みは決して行わないでください。MCP 認証はホストと QAR が管理します。ツールの不足、MT-AUTH-FORBIDDEN、接続エラーは MCP アクセスの問題として報告してください。API キーを求めてはいけません。MCP のみでセットアップする場合は、確認済みの範囲を報告して、ここで引き継いでください。以下の CLI 手順はすべて省略してください。ローカルでの情報収集に CLI アクセスが求められている、または必要な場合に限り、同じデプロイメントを使用して続行してください。
references/... リンクは、インストール済みのこの SKILL.md ディレクトリを基準に解決してください。
ランタイムやログインのセットアップは、エンタープライズ向けのインストールや保守を許可するものではありません。
エンタープライズ向けのインストールを依頼された場合は、承認を得る前にパッケージと保守について開示してください。
オプトアウト、編集内容、所有者、オプションパッケージの選択を保持してください。
1. ランタイムを見つける、またはインストールする
PowerShell では、まず runtime.md に従って、検証済みのネイティブ／Node 呼び出し方法を解決してください。以下の qodo はその呼び出し方法を表します。POSIX では、PATH を直接確認してください。
qodo --version
POSIX で見つからない場合は、"${QODO_HOME:-$HOME/.qodo}/bin/qodo" --version を試してください。
ランタイムが見つからない、古い、またはバージョンを解析できない場合は、リファレンスに従ってください。セットアップの依頼は、ホストの承認を条件としてインストールを含みますが、プラグインのインストールだけでは含まれません。選択したデプロイメントを保持してください。
実行ファイルは <qodo> として扱ってください。認証の前に、Qodo CLI が 2.0.0 以降であることを確認してください。
2. 接続する
次を実行してください。
<qodo> read whoami --json --skill qodo-setup --skill-version 1.0.11 --distribution skills-sh
正常に完了した ID 確認は再利用してください。失敗した場合は、ログイン方法を選ぶ前に authentication.md を読んでください。
Cloud の場合、サインアウト状態であれば <qodo> login を実行してください。顧客のデプロイメントでは、文書化されたログインエンドポイントを維持し、Cloud にフォールバックしてはいけません。ログインの完了を待ってから、ID を再確認してください。
成功した実行コンテキストを再利用し、必要なホスト承認をそれぞれ求めてください。診断に対する承認は包括的な許可ではありません。キャンセルされた場合や権限が拒否された場合は停止してください。
3. ツールを確認する
ID の確認に成功した後に限り、次を実行してください。
<qodo> tools --refresh --json --skill qodo-setup --skill-version 1.0.11 --distribution skills-sh
利用可能なカタログと、タスクに必要な機能の両方を確認してください。無関係なツールがあってもアクセスが確認されたことにはなりません。
更新に失敗した場合は、サインインには成功したもののツールを利用できないことを、正確なエラーと再試行用の <qodo> tools --refresh とともに報告してください。カタログのエラーに対して再度ログインしてはいけません。
設定
認証情報、トランスポート、ランタイムの更新は CLI が管理し、スキルの更新はパッケージのライフサイクル所有者が行います。QODO_NOTICE の更新や Kiro で読み取り承認が繰り返し求められる場合は、その事象が発生したときに限り host-recovery.md を読んでください。
エラー処理
実際のエラーと次に行う操作を 1 つ伝えてください。ID の確認に失敗した場合、ログインがキャンセルされた場合、またはカタログが利用できない場合は、準備完了と報告してはいけません。セットアップを完了させるために、キーチェーンを無効にしたり、認証情報をコピーしたり、ホストの権限ファイルを変更したり、制限のないコマンド承認を提案したりしてはいけません。
4. 引き継ぐ
Qodo の接続と関連ツールの準備状況を確認し、承認済みのタスクに戻ってください。準備完了であっても、後続のツール呼び出しが成功する保証はありません。オプションの Standards はインストールしないでください。