account-rotation

アカウントのローテーション — 認証情報アダプター

ホストとエージェントファミリーの両方に応じて認証情報ツールを選択し、明示的に指示されたアカウント切り替えのみを実行して、対応するランタイムが認識した ID を報告します。

対象のランタイムを通じて ID を確認するのが有効なのは、誰の認識が重要かを判断できるのがランタイムだけだからです。認証情報ファイルを完全に差し替えても、すでに実行中のプロセスでは以前のアカウントで認証されることがあります。

失敗モードの名称 — 古いプロセスの ID：稼働中のすべてのセッションが、以前のアカウントのトークンをメモリに保持したまま、ローテーションが完了したと宣言することです。

アンチパターン：認証情報ファイルのバイト列を差分比較して、切り替えを確認すること。 是正策：対応するランタイムに現在の ID を尋ね、その回答を有効にするために新しいプロセスが必要かどうかを報告します。

境界

• 呼び出し元が明示的に許可したアカウント切り替えのみを実行します。ローテーションはホストの認証情報の状態を変更するため、リポジトリへのアクセスによって暗黙に許可されることはありません。
• 認証情報ツールは、ホストとエージェントファミリーごとに呼び出し元またはオペレーターが選択します。以下の名前はこのオペレーターが使用する手段であり、すべてに適用される推奨ではありません。macOS で Claude の認証情報を使用する場合は claude-acct（Keychain による管理）を使用します。ファイルベースの Codex、Gemini、Linux、または WSL の認証情報には caam を使用します。macOS の Claude アカウント操作には、決して caam を使用しないでください。
• アカウント ID は対象のランタイムを通じて確認します。トークンのバイト列はアカウント ID ではありません。
• 選択した認証情報ツールもランタイムの ID 確認手段も利用できない場合は、その不在を明示的な事実として報告し、停止します。認証情報ファイルのバイト列を差分比較して、切り替えが完了したと宣言することは決してしないでください。
• 既存のプロセスは、すでにメモリに読み込んだ認証情報を保持します。ローテーションが反映されるのは新しいプロセスです。
• このスキルでは、作業の再起動、タスクの再開、ペインの選択、リポジトリの状態の移動、切り替え後の対応の決定は行いません。

ホスト、エージェントファミリー、選択したツール、要求されたアカウントまたはプロファイル、切り替え前後に確認した ID、稼働中のランタイムが以前のアカウントを保持しているかどうか（一部のみのローテーション）、コマンドの終了コード、新しい ID を有効にするために新しいプロセスが必要かどうかを返します。