tomevault-io Requesting gcloud/bq Auth Skill
目的
このスキルは、gcloudやbqコマンドの実行時に認証エラーを検出し、エージェントが勝手に認証コマンドを実行することを防ぎます。認証はブラウザ操作が必要なため、ユーザーに明示的に依頼します。
使用タイミング
以下のエラーパターンを検出した場合にこのスキルを発動してください：
パターン1: bqコマンドでの再認証要求
Reauthentication required.とPlease enter your password:が出力された場合
パターン2: gcloud認証でブラウザが開く
Your browser has been opened to visit:とaccounts.google.comURLが出力された場合
実行手順
即座に作業を中断: 認証エラーを検出したら、関連するgcloud/bqコマンドの実行を停止する
ユーザーに通知: 以下の内容をユーザーに伝える
- 認証が切れていること
- 推奨される認証コマンド（例:
gcloud auth application-default login） - 認証完了後に作業を再開できること
認証完了を待つ: ユーザーが認証を完了するまで、関連するコマンドを実行しない
エラーパターン例
パターン1: bqコマンドでの再認証要求
% bq ls
Reauthentication required.
Please enter your password:
対応:
認証が切れています。以下のコマンドで認証を完了してください：
gcloud auth application-default login
認証完了後、作業を再開します。
パターン2: gcloud認証でブラウザが開く
% gcloud auth application-default login
Your browser has been opened to visit:
https://accounts.google.com/o/oauth2/auth?response_type=code&client_id=XXX&redirect_uri=XXX&scope=XXX&state=XXX&access_type=offline&code_challenge=XXX&code_challenge_method=S256
対応:
ブラウザで認証フローが開始されました。
ブラウザで認証を完了してください。
認証完了後、作業を再開します。
重要な注意事項
✅ すべきこと:
- 認証エラーを検出したら即座に作業を中断する
- ユーザーに明確な指示を提供する（認証コマンド、手順）
- 認証完了を待つ
❌ してはいけないこと:
- 絶対に認証コマンドを自動実行しない（ブラウザ操作が必要なため）
- 認証が完了していない状態でgcloud/bqコマンドを実行しない
Converted and distributed by TomeVault — claim your Tome and manage your conversions.