Run a disciplined, multi-source research investigation for a high-stakes question or decision — fan-out web search across many channels, parallel sub-agents, so
复制下面这句话,粘贴给 Claude Code、Codex、Cursor 等 AI 编程工具,它会读取安装说明并在你确认后完成安装。
请阅读 https://ai.atlankj.com/install/asset/gh-deep-research-cb964f0dbcb4 ,按照其中的说明把「deep-research」安装到你(当前 AI 工具)中。执行前先告诉我将运行的命令和写入的位置,等我确认。
查看 AI 将读取的安装说明正在读取 GitHub 原文…
内容来自 GitHub 原始文件,由原作者维护。在 GitHub 查看
Turn "research this topic" into an auditable, reusable investigation instead of a one-shot wall of text. The output is a folder you can return to in a month: every claim traces to a specific source file, the plan documents why each choice was made, and a refresh protocol lets you update it later without re-running everything.
This is the heavy, methodical end of research. It is not a fast overview — it is the workflow you reach for when getting the answer wrong costs more than the tokens spent getting it right.
A router-style research skill (keyword-classify → delegate → short sequential search → markdown brief) is optimal when you need an answer fast and the decision risk is low. deep-research is the opposite trade: it pays for rigor. Use it when the answer feeds a strategy, an irreversible decision, a published artifact, or a hypothesis you need to actually test — situations where a shallow fallback would be a liability.
Concretely, deep-research adds what a fast overview does not: falsifiable hypotheses up front, parallel sub-agent fan-out across many channels, triangulation with explicit source-type diversity, a mandatory adversarial pass, per-source files with verbatim quotes, and a refresh_targets.md for delta-updates later.
Depth scales with the task — shallow runs the core phases inline; medium/deep add capability discovery, verification, and refresh targets.
| # | Phase | What it does |
|---|---|---|
| 1 | Reframe | Rewrite the question, fix the underlying decision, state 2–4 falsifiable hypotheses |
| 2 | Genre & blocks | Pick the report genre (qa / explainer / decision / landscape / validation / custom) and its building blocks |
| 3 | Plan | Write plan.md: scope, structure, sourcing strategy, opposition queries, risk register, stop-criteria |
| 3.5 | Capability discovery | Audit available API keys/channels in the environment; map subtopics to sources; fall back to HTML where needed |
| 4 | Search (loop) | Dispatch sources → launch sub-agents in parallel → fetch & dedup → save each to sources/NN.md; re-evaluate between rounds |
| 5 | Score & triangulate | Rate every source on Credibility / Recency / Bias; require ≥3 independent, differently-typed sources per thesis |
| 6 | Synthesize + adversarial | Assemble the report from blocks, run 4 self-critique questions, add steel-manned counter-arguments |
| 6.5 | Verify | Lightweight citation check before closing |
| 7 | Refresh targets | Extract entities / numbers / hypotheses into refresh_targets.md — the entry point for future updates |
These are what separate a documented investigation from a confident guess:
sources/NN_slug.md with metadata, verbatim quotes, and scores. No dangling claim — every assertion links back to a specific file. An empty fetch produces an empty claim, never a fabricated citation.refresh_targets.md; an update <slug> run produces a delta (new entrants, entity changes, refreshed numbers, adversarial triggers) instead of replaying the whole investigation.findings/FN.md plus a sources.csv index — research compounds across questions instead of starting from zero each time.<root>/<slug>/
├── plan.md # scope, sourcing strategy, risk register, changelog
├── sources.csv # index of every source with scores
├── sources/
│ ├── 01_<slug>.md # one file = one source (metadata + verbatim quotes)
│ └── ...
├── findings/ # atomic, reusable theses (larger investigations)
│ └── F1_<short>.md
├── refresh_targets.md # what to watch on update (medium/deep)
├── diffs/
│ └── YYYY-MM-DD_delta.md # delta from an `update <slug>` run
└── YYYY-MM-DD_<genre>.md # final report
sources/ into one file. Per-source files are what make findings searchable and reusable across investigations.deep-research is the heavyweight alternative when rigor matters more than speed.