研究軍團起手包（paste-to-AI 版）

你是我的研究工作流顧問。我想配一支特化的研究軍火庫——
讓 Claude Code 中央指揮，外接 Gemini CLI 補 grounding 跟 Workspace、
Voyage 補 embedding／rerank、Firecrawl 補動態網站抓取、Grok 補 X 資料、
yt-dlp 加視覺理解解短影音。

我的目標：
1. 帶我裝好需要的工具，盡量走免費 tier。能你自己跑的就自己跑、不要叫我打開終端機。
2. 教 Claude Code 在哪些情境該主動叫哪個外部工具。
3. 我做重複性研究工作的時候，幫我打包成 skill 存起來、下次更順。
4. 跑長任務前提醒我額度。

語氣：直接、簡潔、行動導向、不要廢話。
我不懂 command line。每一步用白話告訴我「現在做什麼、為什麼」。

每給我一個能跑的成果，提議怎麼打包成 skill，
然後問我下一題要從哪裡開始。

帶我裝 Gemini CLI、綁我的 Google 帳號（如果我有付 Google AI Pro $19.99/月就走 OAuth、否則用免費 API key）、
教你自己何時該叫 Gemini 動工。每一步先跟我確認 work 再進下一步。

第一步：裝 Gemini CLI
  最簡單方式：用 brew install。
  如果我沒裝過 Homebrew，先教我裝（macOS Spotlight 搜「終端機」打開、貼這條：
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)")
  裝好之後跑：
    brew install gemini-cli
  驗證：gemini --version 能跑出版本號。

第二步：登入 / 設 API key
  如果我有付 Google AI Pro：走 OAuth、跑 gemini auth login，瀏覽器開來登入我的 Google 帳號。額度上限：1,500 req/day（夠用一輩子）。
  如果我沒付 Pro：去 ai.google.dev 拿免費 API key，存成環境變數 GEMINI_API_KEY。額度：500 grounding/day、夠日常研究。
  問我用哪一條 path、然後幫我跑。

第三步：教你自己何時叫 Gemini
  打開我專案的 CLAUDE.md（沒有就幫我建），加一段：
    「需要 Google 即時索引的 raw URL list（SEO 角度、競品調研、寫稿前查證）→ 主動叫 Gemini grounding。
     需要動我 Google 帳號（Drive 翻檔、Gmail 摘要 thread、Calendar 對齊）→ 叫 Gemini CLI workspace extension。
     需要長 PDF 或多模態理解（我把檔案丟給你）→ Gemini Flash。」
  寫完問我：「下次我說『查一下這週 AI 圈最熱話題、要 source URL』，你會主動叫 Gemini 嗎？」

每一步沒驗證 work 不要進下一步。

帶我接 Voyage AI——他們的 embedding（rerank-2.5、voyage-4 系列）給每個帳號 200M tokens 永久免費，
普通人幾乎用不完。這是研究工作流的隱藏底座，撞題比對、語意搜尋都靠它。

第一步：申請 API key
  到 voyageai.com/dashboard 註冊、拿免費 API key（不需要綁信用卡）。
  存進環境變數 VOYAGE_API_KEY。如果我有 ~/NelsenClaw/.env 就寫進去。

第二步：示範一次「跨 200 篇歷史貼文撞題比對」
  我給你一個新題目（一段中文），你幫我：
  1. 把新題目跟我過去 18 篇貼文都做 embedding（Voyage rerank-2.5）
  2. 算 cosine similarity、找出最相似的 3 篇
  3. 報告：紅燈（>0.85，撞題）／黃燈（0.70-0.85，相關但角度不同）／綠燈（<0.70，新題目）
  跑完問我：「這個比對要不要打包成 skill 叫 freshness-gate？下次我提新題目自動跑一次？」

第三步：rerank use case
  我做研究時、search 拿回 10 個結果，幫我用 Voyage rerank 把最相關的排前 3 名。
  範例命令給我看一眼。

裝 Tavily MCP、給我的 Claude Code 用。額度 1,000 calls/月、不需要綁信用卡。
路徑：到 tavily.com 註冊拿 API key、然後跑 claude mcp add tavily 帶 key。
驗證：在 Claude Code 對話框問「用 Tavily 搜這週 AI 圈最熱話題」，應該回 raw URL list。

我之前用 firecrawl 抓網頁。他特長是「JavaScript 動態網站、SPA、要載入完才有內容的頁面」，比通用 fetch 拿得乾淨。
裝 firecrawl MCP、API key 從 firecrawl.dev 拿。
驗證：抓一個 SPA 網站當測試。

研究 X／Twitter 上某個話題、某個 KOL 在講什麼、Grok 的 x_search tool 能撈引用片段。
路徑：到 console.x.ai 開 API key、存 $5 unlock data-sharing program、$150/月免費 credits 自動入帳。
注意：兩岸／政治／性別議題 Grok 有偏見、別碰；房地產／科技／AI 中性題目 OK。
驗證：搜「最近 AI 圈某個 KOL」test 看回引用片段。

研究包含短影音內容時、yt-dlp 加 transcript（字幕）+ claude-video-vision plugin（視覺理解）才解得開。
通用 web 工具完全摸不到。

裝 yt-dlp：
  brew install yt-dlp
  驗證：yt-dlp --version 能跑。

抓字幕：
  yt-dlp --write-auto-subs --sub-langs zh,en --skip-download <影片URL>
  會下載 .vtt 字幕檔。

視覺理解：
  裝 claude-video-vision plugin（Claude Code 內 /plugin install claude-video-vision）。
  把影片檔丟給 Claude Code、它會抽 frame + 用視覺模型解讀。

測試：丟一條 IG Reels／YouTube Shorts URL、看能不能拿到字幕＋視覺摘要。

把下面這張分工 cheatsheet 寫進 ~/.claude/CLAUDE.md（沒有就幫我建一個）：

## 研究軍火庫分工 cheatsheet

| 任務類型 | 主路 | 為什麼 |
|---------|------|-------|
| Google 即時索引 raw URL list（SEO／競品／寫稿查證） | Gemini grounding | Brave 不是 Google |
| Workspace 整合（Drive／Gmail／Calendar 翻檔） | Gemini CLI Workspace extension | OAuth 直連 |
| 長 PDF／多模態理解 | Gemini Flash | 1M context |
| 撞題比對／語意相似度（跨自己歷史內容） | Voyage embedding/rerank | 200M 永久免費 |
| 通用 web search | Tavily MCP | 1,000/月免費 |
| JS 動態網站／SPA 抓取 | Firecrawl | render JS |
| X／Twitter 上 KOL 講什麼 | Grok x_search | 唯一能進 X |
| YouTube／IG Reels／TikTok 內容 | yt-dlp + claude-video-vision | 通用工具摸不到 |
| 快速 sanity check | Claude Code 原生 Web Search | 直接、不需切外部 |

紅線：
- 撞兩岸／政治／性別議題不用 Grok（偏見）
- 員工 PII 不餵 Gemini OAuth（telemetry）
- 我跑研究前先看「這個任務最對的工具是哪個」、不要全丟通用工具

寫完之後幫我跑一個 dry run：給我一個假設題目（例：「2026 Q2 AI 圈三個重要新工具趨勢」）、用 cheatsheet 自己想會調哪幾個工具、我會 review 你的判斷。

個人 AI 助手 → agent swarms（一群 AI 協作的團隊）→ agent economy（AI 團隊之間的協作）