basecamp-doctor

Basecamp Doctor

構造化された診断を実行します。

basecamp doctor --json

各チェックをステータス別に解釈します。

• pass：正常に動作しています。
• warn：使用できますが、追加の対応を推奨します。
• skip：認証されていないか、該当しないため実行されていません。
• fail：問題があり、対応が必要です。

失敗と警告は、それぞれの hint フィールドとともに報告してください。また、トップレベルの breadcrumbs 配列も確認し、構造化された cmd の次の手順を保持してください。パンくずリストには、チェックのヒントより具体的なアクションが示されている場合があります。該当する場合は、次の一般的な修正方法を使用してください。

• Basecamp の認証：basecamp auth login。別のユーザーとしてブラウザーにサインインしている場合に、そのアカウントがプロファイルになるのを防ぐため、ログインを置き換える際は --expect-identity <id> で対象を指定してください。対話形式でサインインしてはならないボットや CI のプロファイルには、代わりに個人アクセストークンをインポートします。 op read "op://<vault>/<item>/credential" | basecamp auth login --with-token -P <profile> --account <id> --expect-identity <id>

  いずれかを提案する前に oauth_type を確認してください。 basecamp auth status --json で確認でき、agent はそのプロファイルが Basecamp エージェントであることを示します。これは背後に個人がいないプリンシパルで、サインインではなく OAuth クライアントを使って認証します。上記のいずれのコマンドも、PERSON の認証情報をそのプロファイルに保存し、エージェントを黙って置き換えてしまいます。その場合の修正方法は、クライアントシークレットをパイプで渡して専用のログインを行うことです。 op read "op://<vault>/<item>/credential" | basecamp auth login --with-client-credentials --client-id <id> -P <profile> --account <id> エージェントの認証情報に関する CLI 独自の hint には、クライアント ID が入力済みのこのコマンドが記載されています。コマンドを再構成するより、そのまま使うことを優先してください。また、oauth_type がない場合は自分で判断せず、必ずヒントに従ってください。

• エージェントプラグインのインストールまたはバージョン：basecamp setup agents（BASECAMP_SETUP_AGENT を尊重します）

• Codex プラグイン固有：basecamp setup codex

• Claude Code プラグイン固有：basecamp setup claude

• Grok スキル固有：basecamp setup grok（スキルのみ。Grok は共有スキル ~/.agents/skills/basecamp を読み取ります）

上記の修正方法はすべて、ターミナルを使わずに実行できます。引数なしの basecamp setup は、人が初回にセットアップするためのフローであり、これらの修正方法には含まれません。ブラウザー OAuth を開くほか、機械出力モードの場合、または stdin、stdout、stderr のすべてがターミナルでない場合は、使用法エラーで終了します。basecamp setup --customize では、さらに各既定値をユーザーに選択してもらいます。ターミナルを使っている人には、必要に応じてどちらかを提案してもかまいませんが、自分で実行してはいけません。上記のサブコマンドを使用してください。

認証情報ファイルを読み取ったり、表示したり、要求したりしないでください。すべてのチェックに合格した場合は、Basecamp とそのエージェント統合の準備が整っていると伝えてください。