SuperAPI AI 工具集

effective-web-research

写作与研究

查看项目

更新于 10-15 21:47

技能介绍

用途:让 AI 智能体的每一次外部网页检索都有效可信,并把“深度研究”请求转化为可审计、含来源评估的报告。规则依据 CRAAP 与 Google E-E-A-T 两套框架。本技能只针对外部网页,不与内部代码搜索工具竞争。

适用与不适用:适用于智能体即将或需要从外部网页收集信息时,如官方文档站、第三方库文档、RFC、知名博客、论文、真实世界数据。不适用于读取工作区/仓库内文件(read、grep、ast-grep)、导航本地代码库(LSP、goto_definition、explore agent)、读取 node_modules / venv / site-packages 中已安装依赖,以及创建或编辑文档。

Step 0 分流:先判断是否该走外部。答案可能在仓库内(自身代码逻辑、AGENTS.md 约定、已有技能、代码注释、已安装依赖源码)时,先用 grep / read / LSP / explore,不发起网页搜索。涉及第三方库/框架/外部 API/工具行为或版本特性时走外部。真实世界信息(新闻、市场数据、人物、时事、论文)走外部。混合场景(外部概念+内部应用)先外部研究概念、再内部验证应用。静态层无法获取内容(需登录、JS 渲染、小红书/公众号等反爬平台)时,升级到 web-access 技能的 CDP 方案(运行时检查,缺失则中止并提示安装)。不确定时优先内部。

默认模式四条准则(对任务内每次搜索生效,不产出额外产物):一、权威优先,来源优先级为官方文档站 > 权威二手(MDN、官方博客、RFC/规范)> 知名社区(高赞 StackOverflow、官方仓库 issue/PR)> 一般网页。二、时效核查,快速变化主题先看发布/更新日期,超过约两年视为可能过时;无日期页面存疑;官方常青参考文档例外。三、交叉验证非平凡论断,影响决策的行为断言、性能数字、安全声明、兼容性、最佳实践需 ≥2 个独立来源,看似雷同的两站不算独立。四、跳过内容农场,识别聚合抓取站、AI 生成 SEO 站、纯复制内容、无作者无日期填充页。转述外部结论时附来源链接与日期。

严格模式:用户明确要求严格调研/深度调研/严谨查证或 strict research、deep research、fact-check 且目标为外部时触发,包含默认模式并增加结构化评估。7 个维度为 Authority、Expertise、Experience、Currency、Accuracy、Purpose/Bias、Relevance,各按 High/Med/Low 打分,综合判定 Trustworthy / Cautious / Unreliable。流程为拆解问题为可验证子论断、按四条准则搜索、评分来源、在论断层面综合、按模板输出报告、标注缺口与冲突。安全/安全关键结论需 ≥2 个独立一手来源在权威性与准确性上均为 High。

限制与注意事项:严格模式不适用于内部代码分析,应改用 explore / debug-workflow / code-review 等;官方不一定是厂商 .com,开源项目可能是 GitHub 仓库 README/docs 或 RFC;单页可能含多版本内容,注意版本选择器;高赞 StackOverflow 答案可能已过时;同源转载不算独立;AI 搜索摘要属二手,需回溯其引用的一手来源;同名包在不同生态(npm/cargo/go/pypi)需区分。默认模式是静默行为约束,不向用户逐条叙述。完整 7 维 High/Med/Low 评分细则、报告模板与示例见 reference.md。