SuperAPI AI 工具集

deep-article-research

写作与研究

查看项目

更新于 10-16 06:37

技能介绍

用途

Deep Article Research 用于对指定 URL 的文章进行深度研究与事实核查。它先抓取文章内容,提取其中的核心论点、证据、逻辑链与隐含假设,再借助 Gemini Deep Research 进行网络深度研究,对每个论点进行验证、反驳和补充,最终生成一份专业的中文分析报告。

主要能力

  • 抓取文章内容:使用 agent-browser 获取包含标题、作者、日期和完整正文的文章文本;若不可用则回退到 WebFetch。
  • 论点提取:按照 references/article-analysis-framework.md 的框架,识别主题领域,提取核心论点、证据、逻辑链和隐含假设,输出结构化分析。
  • Gemini 深度验证:通过 scripts/gemini_deep_research.py 脚本,结合 prompts/deep-verification-prompt.md 提示词,对每个论点进行网络深度研究,输出完整分析报告。
  • 报告格式化:按照 references/markdown-formatter-rules.md 的规则格式化报告并保存最终版本。

使用方式

前置要求:

  • GEMINI_API_KEY:环境变量,Gemini Deep Research 必需。
  • agent-browser:用于抓取 JS 渲染的文章内容(备选:WebFetch)。

工作流程:

  1. 抓取文章内容: agent-browser --url "<article_url>" --action "extract the complete article text content including title, author, date, and full body text" 将原始内容保存到 tmp/article-deep-research/{slug}/article-raw.txt。 若 agent-browser 不可用,使用 WebFetch 工具抓取。 若文章有付费墙或无法访问,请用户直接粘贴文章文本。 生成 {slug}:从文章标题生成一个简短的英文标识符(例如 china-ai-policy、fed-rate-decision),使用小写字母和连字符,最多 4 个单词。

  2. 提取论点(LLM 自行执行): 按照 references/article-analysis-framework.md 阅读并分析文章:识别主题领域;提取核心论点、证据、逻辑链和隐含假设;输出结构化分析。 保存到:tmp/article-deep-research/{slug}/argument-extraction-YYYY-MM-DD.md

  3. Gemini 深度验证: python3.11 scripts/gemini_deep_research.py
    --input <argument-extraction file path>
    --prompt prompts/deep-verification-prompt.md
    --output-dir tmp/article-deep-research/<slug>
    --slug <slug>
    --topic "<article topic keywords>" 脚本路径相对于本技能目录。调用时使用绝对路径: --prompt: <skill_dir>/prompts/deep-verification-prompt.md 脚本: <skill_dir>/scripts/gemini_deep_research.py 其中 <skill_dir> 是包含此 SKILL.md 文件的目录。 Gemini 将进行网络深度研究,对每个论点进行验证、反驳和补充,输出完整分析报告。 输出:tmp/article-deep-research/{slug}/{slug}-Analysis-Report-YYYY-MM-DD.md

  4. 格式化并保存: 按照 references/markdown-formatter-rules.md 格式化报告,然后保存最终版本。

输出位置:

tmp/article-deep-research/ +-- {slug}/ +-- article-raw.txt # 原始文章内容 +-- argument-extraction-YYYY-MM-DD.md # LLM 论点提取 +-- {slug}-Analysis-Report-YYYY-MM-DD.md # 最终分析报告

参考文档

  • article-analysis-framework.md:论点提取框架(LLM 自行执行)
  • markdown-formatter-rules.md:报告格式化规则
  • prompts/deep-verification-prompt.md:Gemini 深度验证提示词

错误处理

  • 付费墙 / 文章无法访问:请用户直接粘贴文章文本。
  • agent-browser 未安装:回退到 WebFetch。
  • GEMINI_API_KEY 未设置:提示用户“请设置 GEMINI_API_KEY 环境变量”。
  • 文章过短:仍运行完整工作流(提取 + 验证)。

适用场景

适用于需要对某篇文章进行事实核查、论点验证和深度分析的场景,例如评估新闻报道、政策解读、研究报告等内容的准确性与完整性。

限制

  • 依赖 GEMINI_API_KEY 环境变量,未设置时无法进行 Gemini 深度验证。
  • 推荐使用 agent-browser 抓取 JS 渲染内容,未安装时回退到 WebFetch,可能影响抓取效果。
  • 遇到付费墙或无法访问的文章,需要用户手动粘贴文本。
  • 关于收费、价格、平台支持范围等信息,资料中暂未提供。