AI の返答に出てくる URL に「どのアカウントで開くか」を必ず書かせる Stop hook の作り方

何を解決するか

AI エージェント（Claude Code など）が管理画面や課金ページの URL を人に渡すとき、「どの Google / GitHub アカウントで開くか」が書かれていないと、受け取った人は既定のアカウントで開いて 404 やログイン画面に飛ばされ、別アカウントのまま操作して事故になる。実例: 課金ページの URL をアカウント名なしで渡し、受け取った人は別アカウントのブラウザで 11 回ログイン画面に戻された。

ルール文を書くだけでは守られない。返答を送る直前に機械で止める（Stop hook）。

完成形

• tools/url-account-gate.mjs: 返答本文を判定し、アカウントが要る URL にアカウント名が無ければブロック理由を返す
• 既存の Stop hook ランナーに 1 行登録（無ければ単体で Stop hook として登録）
• テスト（node:test）で「止まる文／通る文」を固定

判定ロジック（この順で実装する）

1. コードフェンス（…）内は判定しない。行の境界は保つ（フェンス内を空にするだけ）。
2. 逃がし弁: 本文に [URL-ACCOUNT-OK] があれば通す。
3. 全体宣言: 「以下の URL はすべて <メール> で開く」のような行（すべて|全部|いずれも と <メール> で開く）があれば、本文の全 URL を合格にする。
4. 対象 URL だけを抽出する:
   • ドメイン一致（サブドメイン含む）: aistudio.google.com, console.cloud.google.com, admin.google.com, mail.google.com, github.com, vercel.com, supabase.com, npmjs.com, x.com, discord.com, dash.cloudflare.com, platform.openai.com, console.anthropic.com, notion.so, slack.com, figma.com, canva.com など、自社で使う「ログインが要るサービス」を列挙する
   • パス一致: /admin /console /dashboard /settings /login /signin /account を含む URL
   • 常に対象外: localhost, 127.0.0.1, .local, raw.githubusercontent.com
   • Google Workspace（docs/drive/sheets/script）は、URL に authuser= か /a/<自社ドメイン>/ が含まれていれば「アカウントが URL に埋め込まれている」とみなして免除
5. 対象 URL ごとに「同じ行か前後 2 行」に次のどれかがあれば合格:
   • メールアドレス
   • で開く または アカウント を含み、かつ太字の名前 **…** がある（例: （**team@<自社ドメイン>** で開く））
   • 自社のブラウザ起動ヘルパー呼び出し（例: open-url-as.ps1 -Account）
6. 1 つでも不合格があれば { triggered: true, missing: [URL…] } を返す。

ブロック理由の文面（人が直せるように、直し方を含める）

[URL-ACCOUNT] 次の URL に「どのアカウントで開くか」が書かれていません。
形式: <URL>（**<アカウント名>** で開く）。既定アカウントと違うなら「シークレットウィンドウで開く」も併記。
本文の URL が全部同じアカウントなら「以下の URL はすべて **x@y** で開く」の 1 行でよい。例外は [URL-ACCOUNT-OK]。
<URL 1>
<URL 2>

実装の骨子（Node.js ESM・依存なし）

const accountDomains = ['aistudio.google.com', 'console.cloud.google.com', 'github.com', /* … */];
const workspaceDomains = ['docs.google.com', 'drive.google.com', 'sheets.google.com', 'script.google.com'];
const email = /[\w.+-]+@[\w-]+\.[\w.-]+/;
const matchesDomain = (host, d) => host === d || host.endsWith('.' + d);

function needsAccount(raw) {
  let url; try { url = new URL(raw); } catch { return false; }
  const host = url.hostname.toLowerCase();
  if (host === 'localhost' || host === '127.0.0.1' || host.endsWith('.local')) return false;
  if (matchesDomain(host, 'raw.githubusercontent.com')) return false;
  if (workspaceDomains.some(d => matchesDomain(host, d)))
    return !url.searchParams.has('authuser') && !url.pathname.includes('/a/<自社ドメイン>/');
  return accountDomains.some(d => matchesDomain(host, d))
    || /\/(?:admin|console|dashboard|settings|login|signin|account)/i.test(url.pathname);
}

export function judge(text) {
  const body = text.replace(/```[\s\S]*?```/g, b => b.replace(/[^\r\n]/g, ''));
  if (body.includes('[URL-ACCOUNT-OK]')) return { triggered: false, missing: [] };
  const lines = body.split(/\r?\n/);
  const found = [];
  lines.forEach((line, i) => {
    for (const m of line.matchAll(/https?:\/\/[^\s<>"'（）「」、。]+/g)) {
      const url = m[0].replace(/[.,;:!?]+$/, '');
      if (needsAccount(url)) found.push({ url, i });
    }
  });
  const global = lines.some(l => /(すべて|全部|いずれも)/.test(l) && /[\w.+-]+@[\w.-]+(\*\*)?\s*で開く/.test(l));
  if (global) return { triggered: true, missing: [] };
  const ok = i => lines.slice(Math.max(0, i - 2), i + 3).some(l =>
    email.test(l) || (/(で開く|アカウント)/.test(l) && /\*\*[^*\n]+\*\*/.test(l)) || /open-url-as\.ps1.*-Account/.test(l));
  const missing = [...new Set(found.filter(f => !ok(f.i)).map(f => f.url))];
  return { triggered: found.length > 0, missing };
}

Stop hook としての配線

• Claude Code の settings.json → hooks.Stop にこのスクリプトを登録する。stdin に JSON（transcript_path, stop_hook_active）が来るので、stop_hook_active が true なら何もしない（ループ防止）。
• 最新の assistant 発話を transcript から取り出して judge() に渡し、missing があれば理由を stderr に出して exit 2（ブロック）。
• 既に複数の gate を 1 本のランナーで回している場合は、ランナーの gate 配列に ['url-account-gate', () => …] を 1 行足すだけでよい。

テスト（最低限）

• 課金ページの URL にアカウント名なし → ブロック、missing にその URL
• 同じ文に （**team@<自社ドメイン>** で開く） → 通る
• 「以下の URL はすべて team@<自社ドメイン> で開く」+ GitHub の URL 複数 → 通る
• 出典リンク（公開ブログ・raw.githubusercontent.com）だけ → 発火しない
• docs.google.com/…?authuser=1 → 対象外／authuser なし → ブロック
• コードフェンス内の URL → 無視
• http://localhost:3000/admin → 対象外
• try { … } catch の中で assert を呼ばない（握りつぶして常に pass になる）

併せて作ると効くもの

• 「そのアカウントのブラウザプロファイルで URL を開く」ヘルパー（Chrome の Local State の profile.info_cache[*].user_name からメール→プロファイル名を引き、chrome.exe --profile-directory=<名前> <URL> で起動）。手で保守する対応表を持たない。
• 所有アカウントが分からないときは、各プロファイルの History（SQLite）をコピーして対象ドメインの訪問履歴を引く（last_visit_time は CAST(... AS TEXT) で読む。人に聞く前に自分で引ける）。

導入後に起きること

• アカウント名のない URL を含む返答は送信前に止まり、AI が自分で書き直す。人への手戻り（別アカウントで開いて 404）が消える。
• 誤検知は [URL-ACCOUNT-OK] で逃がせるが、逃がし弁を使った返答はレビューで目立つようにしておく。