zhaoweiguo 的知识库

hec-ovi/research-skill

3分钟阅读

仓库：https://github.com/hec-ovi/research-skill Stars：13 | 许可：MIT | 版本：v0.4.2 本地路径：/Users/zhaoweiguo/6ai/opensources/research-skill

核心定位

为 Claude Code/Codex 提供项目级持久化调研知识库（<project>/.research/，默认 gitignore）：先查库再上网，渐进披露防止上下文污染。交付物是 4 份 SKILL.md（三份字节级一致 + Codex 变体），无运行时代码。

/research ：三阶段

  1. Retrieval——5 级加载：INDEX.md 调度表 → sed 提取 ## Summary → 全文 FINDINGS.md → raw → related；Summary 能答即停
  2. Investigation——后台 subagent（model:opus, run_in_background）走 6 认知阶段：Decompose → Gather → Validate → Contrarian pass → Insight extraction → Synthesize
  3. Storage——主 agent 独占写盘，test -s && grep -q 验证

quick（3-6 次搜索）/deep 两档，用户措辞可双向覆盖 triage，quick 条目可经 deep merge 升级。

关键机制

  1. contrarian pass 为强制规则：quick 档也须含 1 次反方搜索，结果存 ## Strongest objection
  2. source-independence：溯源一手来源、从单点来源分解开、枚举表逐行重建、禁止开头句把整体结论归给单一文献——规则直接来自 DeepResearch Bench II（DRB2）的 blocked-source 扣分项
  3. 冲突处理：旧结论移入 ## Discarded approaches 表 + Timeline；同法失败 ≥2 次高亮警告
  4. 四条铁律：subagent 零上下文、contrarian 强制、主 agent 独占写入、调研必须落盘

Benchmark 证据与局限

DRB2 仅取 132 题中最小 3 题（62/114/80），Run 3 用 Opus 4.8 judge：skill-Haiku 加权 64.2% vs baseline 56.2%；但权重 0.5/0.35/0.15 系自定、judge 异于官方榜（gemini-2.5-pro），README 自称”directional”。reports/scores/judge-raw 全量 vendored 且 check_skill.sh 防漂移。小模型 e2e 诚实记录失败：Haiku v0.3.5 全 FAIL → v0.3.6 通过；noob-cli + 本地 Qwen3.6-35B-A3B 冷启动 839s vs 热检索 33s（25 倍）。

局限：SKILL.md 32KB，激活约 7-8k tokens（roadmap 拟拆分但搁置）；小宿主上模糊 prompt 自动激活率仅 2/5。

安装

npx skills add hec-ovi/research-skill
# 或 Claude Code: /plugin marketplace add hec-ovi/research-skill + /plugin install research@research-skill
# 或 Codex: codex plugin marketplace add（.agents/plugins/marketplace.json）
# 或 git clone 到 ~/.claude/skills/research

资源

关系图谱

反向链接