deep-research

深度研究

核心目的

透過結構化管線提供附有引用追蹤的研究報告，具備證據持久化、來源身分管理、主張層級驗證與漸進式上下文管理。

自主原則： 獨立運作。從上下文推斷假設。僅在遇到重大錯誤或無法理解的查詢時才停止。在「簡介與方法論」中明確揭露高重要性假設，而非默默採用預設值。

---

決策樹

請求分析
+-- 簡單查詢？ --> 停止：使用 WebSearch
+-- 除錯？ --> 停止：使用標準工具
+-- 需要複雜分析？ --> 繼續

模式選擇
+-- 初步探索 --> quick（3 階段，2-5 分鐘）
+-- 標準研究 --> standard（6 階段，5-10 分鐘）[預設]
+-- 關鍵決策 --> deep（8 階段，10-20 分鐘）
+-- 全面審查 --> ultradeep（8+ 階段，20-45 分鐘）

預設假設： 技術性查詢 = 技術受眾。比較 = 平衡觀點。趨勢 = 近 1-2 年。

---

工作流程概覽

階段	名稱	Quick	Std	Deep	Ultra
1	範圍界定	Y	Y	Y	Y
2	規劃	-	Y	Y	Y
3	檢索	Y	Y	Y	Y
4	三角驗證	-	Y	Y	Y
4.5	大綱精煉	-	Y	Y	Y
5	綜合撰寫	-	Y	Y	Y
6	評論	-	-	Y	Y
7	精修	-	-	Y	Y
8	打包輸出	Y	Y	Y	Y

注意： 階段 3-5 以每個章節的證據迴圈運作（檢索 → 證據儲存 → 精煉大綱 → 草稿 → 驗證主張 → 若需要則增量檢索），而非嚴格的順序關卡。

---

執行

呼叫時，載入相關參考檔案：

1. 階段 1-7： 載入 methodology.md 以取得詳細階段說明
2. 階段 8（報告）： 載入 report-assembly.md 以進行漸進式生成
3. HTML/PDF 輸出： 載入 html-generation.md
4. 品質檢查： 載入 quality-gates.md
5. 長報告（>18,000 字）： 載入 continuation.md

範本：

• 報告結構：report_template.md
• HTML 樣式：mckinsey_report_template.html

腳本：

• python scripts/validate_report.py --report [path]
• python scripts/verify_citations.py --report [path]
• python scripts/md_to_html.py [markdown_path]

---

輸出合約

必要章節：

• 執行摘要（200-400 字）
• 簡介（範圍、方法論、假設）
• 主要分析（4-8 項發現，每項 600-2,000 字，附引用）
• 綜合分析與見解（模式、意涵）
• 限制與注意事項
• 建議
• 參考文獻（完整——每項引用皆列出，無佔位符）
• 方法論附錄

輸出檔案（全部存放於 ~/Documents/[Topic]_Research_[YYYYMMDD]/）：

• Markdown（主要真實來源）
• sources.jsonl — 穩定的來源註冊表，附規範 ID
• evidence.jsonl — 僅可附加的證據儲存，附引用與定位資訊
• claims.jsonl — 原子主張帳本，附支援狀態
• run_manifest.json — 查詢、模式、假設、提供者設定
• HTML（McKinsey 風格，自動開啟）
• PDF（專業列印，自動開啟）

品質標準：

• 10 個以上來源，每個主要主張至少 3 個（跨叢集獨立，非僅計數）
• 所有事實性主張立即以 [N] 引用，並在 evidence.jsonl 中有證據支援
• 主張支援驗證為強制要求：不允許未經支援的事實性主張通過交付
• 無佔位符，無偽造引用
• 以散文為主（>=80%），項目符號謹慎使用

---

使用時機 / 不使用時機

使用： 全面分析、技術比較、最新技術現況審查、多觀點調查、市場分析。

不使用： 簡單查詢、除錯、1-2 次搜尋即可回答的問題、快速時效性查詢。