Communitygithub.com

ASoudy/AGS 深度研究技能

此技能應在使用 OpenAI Deep Research API 對任何主題進行全面研究時使用。它能透過互動式釐清問題自動強化提示詞、儲存研究參數,並執行具備網路搜尋功能的深度研究。

AGS 深度研究技能 是什麼?

此技能專為需要進行深入、全面性網路研究的開發者與 AI 代理設計。它利用 OpenAI 的 Deep Research API (o4-mini-deep-research 模型) 來執行任務,並內建提示詞強化機制,透過智慧提問將簡短或模糊的研究請求轉化為結構化、可重現的查詢參數。技能支援同步執行,避免傳統輪詢方式浪費大量 token,研究完成後自動產出含有來源引用的 Markdown 報告。該技能主要作為命令列腳本使用,支援自訂模型、逾時時間與輸出目錄。其核心優勢在於提升研究效率與結果品質,同時確保研究過程的完全可追溯性。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/claude_skills_libraries/landing-page-mastery/skills/deep-research

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

深度研究技能

目的

此技能使用 OpenAI 的 Deep Research API (o4-mini-deep-research 模型),實現對任何主題進行全面、具備網際網路搜尋能力的研究。它能透過互動式釐清問題,智慧地強化使用者的研究提示詞,確保研究參數可儲存以利重現,並利用完整的網路搜尋功能執行深度研究。

何時使用此技能

在以下情況觸發此技能:

  • 使用者要求研究特定主題
  • 使用者要求分析、調查或全面收集資訊
  • 使用者希望透過網路搜尋和推理來探索某個主題
  • 使用者提供了一個可以進一步完善的簡短研究查詢
  • 使用者想要了解某一領域的當前狀態、趨勢或比較

使用者請求範例:

  • "研究最高效的開源 RAG 解決方案,且具備高基準測試成績"
  • "2025 年 AI 的最新發展是什麼?"
  • "我需要對分散式資料庫系統進行全面分析"
  • "尋找實施向量搜尋的最佳實務"
  • "調查 AI 如何影響軟體工程產業"

工作流程概述

使用者輸入
    ↓
評估:提示詞過於簡短?
    ↓
是 → 提出強化問題 → 收集答案
    ↓                               ↓
    └───────→ 建立強化後的提示詞 ←──┘
                    ↓
            儲存至帶時間戳記的檔案
                    ↓
            執行 deep_research.py
                    ↓
            輸出報告 + 來源
                    ↓
            呈現給使用者

Claude 應如何使用此技能

關於 Token 效率的重要說明: 深度研究需要 10-20 分鐘才能完成。此技能設計為同步執行(阻塞模式),不進行中間狀態檢查。這種方法可在等待期間最大程度地減少 token 使用量。Claude 應:

  1. 開始研究
  2. 等待完成(子程序會自動阻塞)
  3. 完成後呈現最終結果

執行期間無需進行定期輪詢或狀態更新。

步驟 1:接受研究請求

接收使用者的研究提示詞。範圍可以從簡短("最新 AI 趨勢")到高度詳細("語言模型對開發人員生產力的影響,重點關注 2024-2025")。

步驟 2:執行協調腳本

使用使用者的研究提示詞執行技能的主要協調腳本:

python3 scripts/run_deep_research.py "您的研究提示詞"

該腳本位於技能安裝目錄中的 scripts/run_deep_research.py。

步驟 3:腳本執行流程

腳本會自動:

  1. 評估提示詞完整性:檢查提示詞是否過於簡短或籠統(少於 15 個字詞,或開頭為 "什麼是"、"如何" 等)

  2. 提出釐清問題(如有需要):

    • 根據研究類型提供 2-3 個重點問題
    • 根據關鍵字檢測研究是技術性還是通用性
    • 允許使用者從預定義選項(1-4)中選擇或提供自訂文字
    • 問題涵蓋:範圍/時間框架、深度級別、重點領域
  3. 強化提示詞:將原始提示詞與使用者的答案組合成結構化的研究參數

  4. 儲存提示詞檔案:將強化後的提示詞寫入 research_prompt_YYYYMMDD_HHMMSS.txt 以確保可重現性

  5. 執行深度研究:運行核心的 deep_research.py 腳本,使用:

    • 模型:o4-mini-deep-research(可透過 --model 配置)
    • 超時:1800 秒 / 30 分鐘(可透過 --timeout 配置)
    • 工具:預設啟用網路搜尋

步驟 4:向使用者呈現結果

腳本會自動:

  • 儲存 Markdown 檔案:將包含來源的研究報告儲存為 research_report_YYYYMMDD_HHMMSS.md
  • 輸出至終端機:使用 Markdown 格式列印完整的研究報告
  • 列出網路來源:研究中引用的編號 URL
  • 確認完成:研究檔案儲存的路徑

Token 效率說明:深度研究需要 10-20 分鐘。腳本以同步模式(阻塞)運行,不進行中間輪詢,從而在等待期間最大化減少 token 使用。

捆綁資源

腳本

scripts/run_deep_research.py(主要進入點)

協調腳本,負責處理:

  • 提示詞品質評估
  • 互動式強化問題(具備技術性與通用性研究的智慧檢測)
  • 提示詞儲存與時間戳記
  • 執行核心深度研究

主要特色:

  • 智慧強化:僅在提示詞簡短或籠統時才提問
  • 基於模板的問題:針對技術性與通用性研究提供不同的問題集
  • 靈活的輸入:編號選項 + 自訂文字輸入
  • 錯誤處理:若找不到 deep_research.py 則提供有用訊息

可用選項:

python3 run_deep_research.py <提示詞> [選項]
  --no-enhance              跳過強化問題
  --model <模型>            要使用的模型(預設:o4-mini-deep-research)
  --timeout <秒數>          超時秒數(預設:1800)
  --output-dir <路徑>       提示詞檔案的儲存位置

assets/deep_research.py

與 OpenAI Deep Research API 介接的核心腳本。負責處理:

  • 透過 OPENAI_API_KEY 進行 API 驗證
  • 請求建立與執行
  • 自動 Markdown 儲存:預設儲存帶時間戳記的報告檔案
  • 輸出格式化(包含中繼資料的報告與來源)
  • 錯誤處理與重試

新增的命令列選項:

--output-file <路徑>       自訂輸出檔案路徑
--no-save                  停用自動 Markdown 儲存

參考文件

references/workflow.md

詳細的工作流程文件,涵蓋:

  • 完整的技能工作流程與範例
  • 提示詞強化策略
  • 研究參數說明
  • Claude 的整合指南
  • 命令列介面參考
  • 錯誤處理與故障排除
  • 有效研究的技巧

關鍵行為

智慧提示詞強化

此技能能智慧地判斷是否需要強化:

  • 觸發強化:針對少於 15 個字詞或開頭籠統的提示詞
  • 跳過強化:針對詳細、具體的提示詞
  • 允許使用者使用 --no-enhance 標誌停用
  • 模板感知:針對技術性與通用性研究使用不同的問題

研究參數

強化後的提示詞包含:

  • 帶有完整上下文的原始使用者查詢
  • 領域與時間偏好
  • 期望的深度層級(摘要、技術、實作、比較)
  • 特定的重點領域(效能、成本、安全性等)

這些參數有助於深度研究模型提供更具針對性、更相關的結果。

可重現性

每次研究執行:

  • 將使用的確切提示詞儲存到帶時間戳記的檔案中
  • 能夠追溯研究決策
  • 允許使用相同/修改後的提示詞進行後續研究
  • 維護研究參數的稽核軌跡

範例

簡短提示詞搭配強化

使用者: "研究最高效的開源 RAG 解決方案"

腳本行為:

  1. 檢測到簡短提示詞(12 個字詞)+ 技術關鍵字("開源"、"RAG")
  2. 提出技術性研究問題:
    • 技術範圍:僅限開源?(使用者:是)
    • 關鍵指標:效能/基準測試?(使用者:速度和準確度)
    • 使用案例:生產環境部署?(使用者:多方面)
  3. 使用參數強化為詳細提示詞
  4. 儲存並執行深度研究
  5. 返回包含比較基準測試和來源 URL 的全面報告

詳細提示詞(無需強化)

使用者: "分析大型語言模型對軟體開發人員生產力的影響,時間範圍 2024-2025,重點關注程式碼生成工具、結對程式設計和生產力指標。"

腳本行為:

  1. 檢測到詳細提示詞(24 個字詞),具有特定範圍/重點
  2. 跳過強化問題
  3. 立即儲存並執行深度研究
  4. 返回符合使用者規格的重點分析

需求

  • Python 3.7+
  • OpenAI API 金鑰(透過 OPENAI_API_KEY 環境變數或 .env 檔案設定)
  • 網路連線(用於網路搜尋)
  • 研究完成時間 30 分鐘以上(可配置超時時間)

Token 高效工作流程

長時間任務最佳化

深度研究查詢通常需要 10-20 分鐘 才能完成。此技能已針對長時間等待期間最小化 token 使用量進行最佳化:

運作方式:

  1. 同步執行:腳本以阻塞子程序運行(無背景輪詢)
  2. 無中間檢查:Claude 在等待期間保持靜默,不發送狀態更新
  3. 單一輸出:結果僅在最後一次呈現
  4. 自動儲存:Markdown 檔案會自動儲存,無需手動干預

Token 節省:

  • 傳統方法:每 30 秒檢查一次狀態 = 約 40 次檢查 × 500 tokens = 浪費約 20,000 tokens
  • 此方法:單次等待 = 總計約 1,000 tokens

自動檔案管理

此技能會自動產生與儲存檔案:

產生的檔案:

  • research_prompt_YYYYMMDD_HHMMSS.txt - 帶參數的強化研究提示詞
  • research_report_YYYYMMDD_HHMMSS.md - 完整的 Markdown 報告,包含:
    • 研究章節(歷史、認知、文化等)
    • 編號的來源引用
    • 中繼資料頁尾(日期、模型)

自訂選項:

# 自訂輸出位置
python3 deep_research.py --prompt-file prompt.txt --output-file my_research.md

# 停用自動儲存(僅終端機輸出)
python3 deep_research.py --prompt-file prompt.txt --no-save

故障排除

缺少 OPENAI_API_KEY

錯誤: "缺少 OPENAI_API_KEY"

解決方案:

  • 設定環境變數:export OPENAI_API_KEY="您的金鑰"
  • 或在工作目錄中建立 .env 檔案,內容為 OPENAI_API_KEY=您的金鑰

找不到 deep_research.py

錯誤: "找不到 deep_research.py"

解決方案:

  • 確保技能已正確安裝資產檔案
  • 腳本搜尋順序為:技能資產資料夾 → 目前目錄 → 父目錄

研究超時

錯誤: 請求在 30 分鐘後超時

解決方案:

  • 增加超時時間:--timeout 5400(90 分鐘)
  • 簡化提示詞以減少研究範圍
  • 在非尖峰時段執行以獲得更快的 API 回應

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

相關技能