用途:当任务需要可辩护、时效性强、多来源的研究时使用该技能,例如库/API 选型、依赖调查、发布或变更日志分析、GitHub issue 与源码考古、智能体提示研究、标准核查以及高风险的引用场景。
主要能力:采用双平面设计。Codex 原生平面可使用 web.search_query、web.open、web.find、GitHub 应用工具、Context7 MCP、Exa MCP 以及会话中的 $opensrc;CLI 平面通过 codex-research 提供 provider 路由、Context7 REST API、GitHub REST/gh 回退、Firecrawl 调用、直接抓取探测、SQLite/CAS 缓存、JSONL 台账、Markdown 报告、诊断与评测。搜索结果只有被水合为来源记录后才可作为依据,且断言需绑定来源 ID、时效与置信度。
来源路由默认顺序:原生 Codex web 用于当前事实、官方文档与快速确认;Context7 REST API 用于版本感知的库/API 文档;GitHub 用于仓库、代码、issue、PR、release 等证据;直接抓取用于文本/静态页面;Exa 用于广域语义发现;仅在预测为应用外壳、被阻止或重渲染页面时使用 agent-browser 或 Firecrawl;需要包实现源码时使用 $opensrc。可用 codex-research plan 查看调用预算,并用 run init/status 支持可回放运行;原生 Codex web 调用对 CLI 不可见,需手动 --provider codex-web 记账。
Firecrawl 策略:属于付费容量的回退通道,不作为第一来源;公开文档可缓存,最新关键页面用 --fresh,敏感公开页面用 --no-store-in-cache,私有/机密内容除非用户明确允许否则不发送。
GitHub 策略:Codex 会话优先用 GitHub 应用/插件;独立可回放调用使用 codex-research github,回退顺序为 GITHUB_TOKEN、GH_TOKEN、gh auth token、公开未认证模式;先定向生成窄查询分片,再水合完整文件、issue 线程、release 或 compare 范围后引用。
子智能体:遵循 $subspawn 严格会合行为,主会话派生专业研究员后立即等待整批完成再综合,研究子代理不得嵌套派生。可通过 python3 skills/deep-researcher/scripts/install_agents.py --target project 或 --target global 安装模板。
输出物:JSONL 台账、来源记录、路由/缓存统计以及带引用与精简断言的 Markdown 报告。常用命令包括 codex-research doctor、cache init、plan、run init、fetch probe、context7 search、github search-code、ledger init、ledger add-source、report 与 eval。
限制:来源冲突且无法确定当前权威、provider 限流或缺少凭据、仅有陈旧二手来源、私有材料需外部发送但无明确许可、GitHub 搜索不完整且水合无法验证断言时,应停止并标记为 UNVERIFIED。