research-skill

name	research-skill
description	外部研究整合（搜尋 + 擷取 + 統整，start/check）
allowed-tools	mcp__ching-tech-os__run_skill_script
metadata	{"ctos":{"requires_app":"file-manager","mcp_servers":"ching-tech-os"}}

【外部研究整合（start/check）】

當任務需要多來源搜尋、擷取內容並統整時，優先使用此 skill，避免在單一回合長時間同步呼叫 WebSearch/WebFetch 導致超時。

研究執行策略：

• 背景 worker 會先用 Claude（預設 claude-opus，可用 RESEARCH_CLAUDE_MODEL 覆寫）+ 內建 WebSearch/WebFetch 產生完整研究結果
• 若 Claude web tools 執行失敗，才降級到本地 provider fallback（Brave API → DuckDuckGo → Brave public）
• Claude research timeout 預設 300 秒（5 分鐘，可用 RESEARCH_CLAUDE_TIMEOUT_SEC 調整）
• Brave API 申請：https://brave.com/search/api/

可用 scripts：

1. start-research — 啟動研究任務（非同步，立即回傳 job ID）

   • run_skill_script(skill="research-skill", script="start-research", input='{"query":"主題關鍵字"}')
   • 可選參數：
     • urls：先驗證或優先擷取的 URL 陣列
     • max_results：搜尋最多來源數（1-10，預設 5）
     • max_fetch：實際擷取來源數（1-6，預設 4）
   • 立即回傳 job_id，背景程序持續執行。