release: v0.20 Codex-ready skill-driven core
This commit is contained in:
kai
@@ -138,7 +138,32 @@ dr-reporter 从 sources.jsonl 生成参考文献列表时，按以下格式：
|
||||
|
||||
---
|
||||
|
||||
## 五、引用完整性检查（dr-chief-editor 用）
|
||||
## 五、脚注使用边界
|
||||
|
||||
脚注不是行内引用的替代品，也不用于重复输入材料中已经被正文自然承载的事实。脚注只在以下场景使用：
|
||||
|
||||
- **法规原文或条款定位**：正文需要引用法规要求，但完整条款会打断叙事时，脚注写明法规名称、章节/条款和关键原文。
|
||||
- **关键资料原文**：原文措辞本身会影响判断强度，且正文只保留管理结论时，脚注可放短摘录。
|
||||
- **补充背景或术语解释**：正文读者可能需要额外背景，但展开会破坏行文节奏。
|
||||
- **版权或使用限制说明**：图表、第三方材料、内部材料使用边界需要单独说明时。
|
||||
|
||||
禁止事项：
|
||||
|
||||
- 不要把“某份输入材料说过什么”机械搬到脚注；这类事实应通过正文和数字引用解决。
|
||||
- 不要为每个本地材料引用都加脚注；脚注应少而精，优先服务关键判断。
|
||||
- 不要用脚注堆砌证据，核心证据仍应进入正文或证据表。
|
||||
|
||||
推荐格式：
|
||||
|
||||
```markdown
|
||||
正文关键判断<sup>[12]</sup>。[^1]
|
||||
|
||||
[^1]: ICH Q10《Pharmaceutical Quality System》第 4.1 节要求管理评审输入覆盖“results of regulatory inspections and findings, audits and commitments”，并纳入 CAPA、变更以及上次管理评审行动。
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、引用完整性检查（dr-chief-editor 用）
|
||||
|
||||
审校时检查：
|
||||
1. 正文中所有 [src_xxx] 都在 sources.jsonl 里有对应记录
|
||||
|
||||
@@ -0,0 +1,62 @@
|
||||
---
|
||||
name: search-gateway
|
||||
description: Use when Deep Research agents or subagents need web, scholar, patent, news, regulatory, or source-discovery search without using platform MCP tools or browser search directly.
|
||||
---
|
||||
|
||||
# Search Gateway
|
||||
|
||||
## Rule
|
||||
|
||||
Use the project Python search gateway as the only default search interface. Do not call Tavily MCP, browser MCP, generic web tools, or platform-native search from a subagent unless the user explicitly asks for that escape hatch.
|
||||
|
||||
## Commands
|
||||
|
||||
Run searches from the repository root:
|
||||
|
||||
```bash
|
||||
uv run python scripts/search.py "<query>" --route general --json --trace
|
||||
uv run python scripts/search.py "<query>" --route evidence --json --trace
|
||||
uv run python scripts/search.py "<query>" --route scholar --year-low 2020 --json --trace
|
||||
uv run python scripts/search.py "<query>" --route news --time-range y --json --trace
|
||||
uv run python scripts/search.py "<query>" --route patents --json --trace
|
||||
uv run python scripts/search.py "<query>" --profile biomed_literature --json --trace
|
||||
```
|
||||
|
||||
If `uv` cannot use the user cache in a sandbox, set a local cache:
|
||||
|
||||
```bash
|
||||
UV_CACHE_DIR=/private/tmp/deep_research_uv_cache uv run python scripts/search.py "<query>" --route general --json --trace
|
||||
```
|
||||
|
||||
## Routing
|
||||
|
||||
- `general`: Tavily first, Exa fallback, Brave fallback; use for broad discovery and gap filling.
|
||||
- `evidence`: Exa highlights first, Tavily fallback, Brave fallback; use when a task card needs concise, source-level candidate evidence for an evidence packet.
|
||||
- `scholar`: Serper Scholar first; use for papers, reviews, technical literature, and academic validation only.
|
||||
- `news`: Serper News first; use for recent industry/current information.
|
||||
- `patents`: Serper Google Patents first.
|
||||
- `biomed_literature`: scholar plus general discovery.
|
||||
|
||||
Serper is not the default general web search source. Keep it mainly for Scholar, Google Patents, News, and targeted `site:` searches where Google coverage matters.
|
||||
|
||||
Tavily Research is a phase-level scan tool, not a packet-writing shortcut. Use it for Phase 1 initial landscape scans, Phase 2 gap-fill after a chapter is thin, or Phase 3回炉补证据；its output must be saved, source-scored, deduplicated, and converted into candidate evidence before citation.
|
||||
|
||||
Exa is the preferred controlled evidence discovery route for agents because it can return short highlights/text per URL. Treat Exa hits as candidate sources unless the URL itself is an original Tier 1-2 source.
|
||||
|
||||
API keys are loaded from `secrets.env` by `scripts/search.py`; do not ask the user to authorize MCP calls when the env keys are available.
|
||||
|
||||
## Subagent Protocol
|
||||
|
||||
For evidence packets:
|
||||
|
||||
1. Search through `scripts/search.py`, save or summarize the returned JSON in the packet’s `raw_quotes_or_notes`.
|
||||
2. Use search hits only as candidate sources; whenever possible, cite the original regulator, guideline, paper, or official document.
|
||||
3. Put every used source in `sources` with `id`, `title`, `url`, `tier`, and `score`.
|
||||
4. Do not write a final chapter during search; produce structured evidence only.
|
||||
5. For repeatedly used Tier 1-2 sources, run `uv run python scripts/dr.py sources cache <project>` so later phases can cite a local Markdown snapshot rather than only a URL.
|
||||
|
||||
For chapter assembly:
|
||||
|
||||
1. Do not search. Use only `phase2/chapter_briefs`, `phase2/packets`, `phase2/sources.jsonl`, `phase0/extracted`, and `phase1/framework.md`.
|
||||
2. Do not create new `source_id`.
|
||||
3. If evidence is thin, mark the chapter as needing Phase 2 enrichment instead of filling with generic prose.
|
||||
@@ -75,10 +75,12 @@ description: 生物医药深度研究的统一检索策略。规定信源优先
|
||||
- 例：研究"GLP-1 成为减重首选"→ 反方要搜 "GLP-1 limitations" "semaglutide side effects" "discontinuation rate"
|
||||
- 至少 3-5 条反方证据
|
||||
|
||||
### 第 4 轮：Tavily/Brave/Exa 补漏
|
||||
### 第 4 轮：Exa/Tavily/Brave 补漏
|
||||
- 仅用于发现前 3 轮遗漏的 URL
|
||||
- 发现后**必须**回溯到原始 Tier 1-2 来源（论文 DOI、监管公告原文）
|
||||
- 不得直接引用搜索返回的二次报道
|
||||
- 章节级 evidence packet 优先用 `scripts/search.py --route evidence`，让 Exa highlights 进入 source-quality 和 evidence-table。
|
||||
- Tavily Research 只用于 Phase 1 初扫、薄弱章节补证据和 Phase 3 回炉；输出必须存盘、评分、去重后再转成 candidate evidence。
|
||||
|
||||
---
|
||||
|
||||
@@ -88,6 +90,7 @@ description: 生物医药深度研究的统一检索策略。规定信源优先
|
||||
|
||||
```bash
|
||||
uv run python scripts/search.py "<query>" --route scholar --num-results 10 --year-low 2023
|
||||
uv run python scripts/search.py "<query>" --route evidence --num-results 10 --json --trace
|
||||
uv run python scripts/search.py "<query>" --route patents --num-results 10
|
||||
uv run python scripts/search.py "<query>" --route news --num-results 10 --time-range m
|
||||
uv run python scripts/search.py "<query>" --route general --num-results 10
|
||||
@@ -107,7 +110,7 @@ uv run python scripts/search.py "<query>" --profile patent_heavy --num-results 1
|
||||
- `--route patents` 固定优先 Serper + Google Patents，避免专利检索被 Tavily 普通网页结果替代。
|
||||
- `--route scholar` 固定优先 Serper Scholar，避免论文检索只停留在通用网页摘要。
|
||||
- 专用 route（scholar/patents/news）默认 `--strict-specialized`，Serper 异常时应显式失败，不允许静默降级。
|
||||
- Tavily / Exa / Brave 只作为 gap-fill 或 MCP 兜底，不作为文献/专利主路径。
|
||||
- Exa evidence route 是 packet 候选证据发现主路径；Tavily / Brave 只作为 gap-fill 或 MCP 兜底，不作为文献/专利主路径。
|
||||
|
||||
每个检索小结必须写明实际使用过的 route，例如：
|
||||
|
||||
|
||||
Reference in New Issue
Block a user