Use this skill when a user wants a comprehensive research report on any topic with cited sources. Prefer this skill for requests like "research this topic", "give me a deep analysis of", "幫我研究", "深度分析", or when the user needs a well-sourced report for decision-making, presentations, or learning. This skill uses Gemini's Deep Research agent and takes several minutes to complete.
使用 Gemini Deep Research agent 針對任意主題產出結構完整、附引用來源的繁體中文研究報告。這是唯一使用 agent（而非 model）並以 background: true 搭配輪詢模式運作的 skill。
GEMINI_API_KEY 或 GOOGLE_API_KEYbun install && bun run build（產生 scripts/research.js）node .agents/skills/deep-researcher/scripts/research.js "AI 晶片市場趨勢"
echo "量子運算對密碼學的影響" | node .agents/skills/deep-researcher/scripts/research.js
TOPIC="台灣半導體產業供應鏈分析"
node .agents/skills/deep-researcher/scripts/research.js "$TOPIC" > report.md
設定 DEEP_RESEARCHER_DRY_RUN=1 可在不呼叫 API 的情況下預覽將送出的請求：
DEEP_RESEARCHER_DRY_RUN=1 node .agents/skills/deep-researcher/scripts/research.js "測試主題"
輸出為 JSON，包含 agent、background、prompt、topic 欄位。
stdout 輸出為 Markdown 格式的研究報告，包含：
stderr 輸出進度訊息（啟動、輪詢進度、完成）。
⚠️ skill 腳本位於 repo 根目錄。若 cwd 不在 repo root，先獨立執行 git rev-parse --show-toplevel 取得路徑，再 cd 到該路徑後執行。禁止使用 $(...) 語法。
node .agents/skills/deep-researcher/scripts/research.js "<主題>" 並將 stdout 導向檔案或直接呈現。DEEP_RESEARCHER_DRY_RUN=1 執行確認參數正確。.md 檔案或直接呈現給使用者。background: true 啟動後以輪詢方式取得結果，非即時串流。| 情境 | 行為 |
|---|---|
| 未提供主題 | stderr 顯示用法說明，exit code 1 |
| 未設定 API key | stderr 顯示錯誤訊息，exit code 1 |
| 研究任務失敗 | stderr 顯示失敗原因，exit code 1 |
| 超過 10 分鐘 | stderr 顯示逾時錯誤，exit code 1 |
| Dry-run 模式 | stdout 輸出 JSON 預覽，不呼叫 API |