Research Companion 5分钟上手教程:Claude Code插件安装与首次研究Idea评估

原创2026-11-01 14:06:312,213 阅读

Research Companion 5分钟上手教程:Claude Code插件安装与首次研究Idea评估

Research Companion 是一款面向 Claude Code 的研究策略插件(Claude Code 插件),内置 3 个研究思考 Agent,帮你完成研究 Idea 评估、项目取舍决策和结构化头脑风暴——它不帮你写论文,而是帮你决定"该写哪篇论文"。本教程带你在 5 分钟内完成插件安装,并跑通第一次研究 Idea 评估。

一、Research Companion 是什么?为什么需要它?

大多数 AI 写作工具帮你"写"论文,而 Research Companion 帮你决定"写什么"。它像一位直言不讳的同行:

  • 💡 在你投入 6 个月之前,告诉你某个 Idea 不值得做
  • 🔍 追问"还有谁在做这个?你的不公平优势是什么?"
  • ✂️ 挑战你用一句话讲清楚核心洞察(Nugget Test)

它的设计灵感来自 Nicholas Carlini 的文章《How to Win a Best Paper Award》:好的研究始于品味、战略性的选题选择和诚实的自我评估。

三个核心 Agent 一览

Agent 作用 源码位置
Idea Critic 从 7 个维度压力测试研究 Idea,给出 Pursue / Refine / Kill 结论 agents/idea-critic.md
Research Strategist 项目级战略思考:继续/转向/放弃(triage)、竞品分析、被 scoop 风险评估 agents/research-strategist.md
Brainstormer 强化版头脑风暴:跨领域连接、挑战学科惯性假设 agents/brainstormer.md

此外,插件还提供 8 条研究策略原则(RS1–RS8)作为所有评估的理论底座,详见 principles/research-strategy.md。

二、3步安装 Research Companion Claude Code 插件

前置条件:已安装并登录 Claude Code(可通过终端 claude 命令启动)。

第 1 步:添加插件市场

在终端执行:

claude plugin marketplace add https://gitcode.com/gh_mirrors/re/research-companion

第 2 步:安装 Research Companion 插件

claude plugin install research-companion@andrehuang-research-companion

第 3 步:验证安装

启动 Claude Code,输入以下命令测试(/research-companion 是插件注册的 Skill):

/research-companion 我感兴趣的方向是程序合成与科学发现的交叉

如果启动了一个分阶段的头脑风暴会话,说明安装成功 ✅

💡 Codex 用户:本项目同样支持 OpenAI Codex。完整安装步骤(repo marketplace 安装、个人本地 marketplace 手动安装)见官方文档 docs/codex-installation.md。在 Codex 中通过 @research-companion 或 $research-companion 调用,Skill 定义位于 codex-skills/research-companion/SKILL.md。

三、首次研究 Idea 评估:只需一句话

这是 Research Companion 最常用、最简单的用法——描述你的 Idea,然后请求评估,Idea Critic 会自动接管。

示例:评估一个 LLM 代码安全方向

在 Claude Code 中输入:

我在考虑研究 LLM 生成代码中那些能骗过标准代码审查的
隐蔽安全漏洞。请帮我评估这个 Idea。

几分钟后,你会收到一份结构化评估报告,包含:

  • Nugget:对核心洞察的一句话提炼(提炼不出来说明 Idea 还不够清晰)
  • 7 维评分表:每个维度的信号等级 + 一两句点评
  • 最强支持理由 / 最强反对理由
  • Verdict:PURSUE / REFINE / KILL 三选一结论
  • The One Question to Resolve Next:下一步要解决的关键问题(且必须是可测试的,例如"跑实验 X"而不是"再想想")

7 个评估维度详解

# 维度 关键问题
1 Novelty 新颖性 如果你不做,别人多久后会做出来?(周/月/年)
2 Impact 影响力 不干活,你现在能写出一段有说服力的结论吗?
3 Timing 时机 领域准备好了吗?太早?太挤?
4 Feasibility 可行性 最危险的那个假设是什么?一周内能验证吗?
5 Competition 竞争格局 谁在做这件事?你的不公平优势是什么?
6 The Nugget 核心洞察 能用一句话说清楚关键洞见吗?
7 Narrative 叙事潜力 能否讲一个让怀疑者读下去的故事?

完整定义见 agents/idea-critic.md。

读懂 Verdict:三种结论

结论 含义 建议动作
✅ PURSUE Idea 值得投入,有真实优势 先验证最危险的假设(RS4: Fail Fast)
🔧 REFINE 方向不错但框架/切入角需调整 按反馈修改后重新评估
✂️ KILL 不值得投入时间 保存学习结论,果断止损

注意:Agent 被刻意设计得"有观点、直接"。如果 Idea 该杀,它会直说并解释原因——它宁可帮你省下 3 个月,也不哄你开心。

四、完整头脑风暴:6 阶段引导式 Idea 生成

没有现成 Idea?用 /research-companion 启动一次完整的结构化会话。编排逻辑定义在 skills/research-companion/SKILL.md:

/research-companion 我感兴趣的方向是程序合成与科学发现的交叉

整个会话按 Seed → Diverge → Evaluate → Deepen → Frame → Decide 六个阶段推进:

阶段 做什么 负责的 Agent
1. Seed 快速访谈:你的问题域、痛点、背景、约束(3-5 个问题) Research Companion
2. Diverge 生成一批 Idea,强调跨领域连接与反直觉框架 Brainstormer
3. Evaluate 从你的 Idea 中挑 2-3 个,并行压力测试,输出对比表 Idea Critic
4. Deepen 对幸存者做现实检验:竞品、scoop 风险、时机 Research Strategist
5. Frame 结论先行测试:现在就写出摘要和结论,写不出来说明 Idea 不成熟 Research Companion
6. Decide 最终裁决 + 1-2 周内可完成的第一步 Research Companion

其中第 5 阶段的"结论先行测试"(Carlini's conclusion-first test)是整个会话最有价值也最容易被跳过的一步:如果你还没开始做研究就写不出有说服力的结论,这个 Idea 就还没准备好。

完整会话通常在 15-20 分钟内完成,结束时你会得到每个 Idea 的:结论(PURSUE / PARK / KILL)、Nugget、最强论据、最大风险、以及"先验证什么"的具体下一步。

五、项目 Triager:进行中的研究该继续还是放弃?

做项目 3 个月,结果只是 incremental,还有两篇预印本同时出现——Research Strategist 的 Project Triage 模式就是为这种时刻设计的:

我做了 3 个月多模态模型的对抗攻击,有一些结果但比较增量。
同方向刚出现了两篇预印本。我应该继续吗?

它会综合结果状态、竞争格局、影响力预测、剩余工作量和你的动力水平,从一张结构化决策表(见 agents/research-strategist.md)出发,给出 Continue / Pivot / Kill 建议:

  • 建议 Pivot 时,会明确告诉你转向什么,而不是"也许换个角度"
  • 建议 Kill 时,会告诉你哪些资产值得救(workshop 论文、博客、数据集)
  • 还会附带一份 Watch List:需要监控的检索词、关键研究者、目标会议和复查频率

六、评估结果会自动保存(v1.1 新特性)

评估结论会持久化到磁盘,跨会话累积:

  • 每次会话后,结论写入 research-evaluations/YYYY-MM-DD-<topic>.md
  • 下次评估相似话题前,系统会先检查历史评估,避免重复评估已 KILL 的 Idea
  • 被 PARK 的 Idea 会附带"重访条件"——什么情况改变后值得重新考虑
  • 文件结构规范见 skills/research-companion/SKILL.md

这意味着你的研究思考会随时间沉淀,而不是每次从零开始。

七、快速上手清单与关键文件

上手清单

  1. ⏱️ 30 秒:claude plugin marketplace add + claude plugin install
  2. ⏱️ 2 分钟:描述一个 Idea,请求评估,读懂 7 维评分
  3. ⏱️ 15 分钟(可选):运行一次 /research-companion 完整 6 阶段会话
  4. 📌 养成习惯:每 4-6 周对进行中的项目做一次 Project Triage

关键文件速查

内容 路径
项目总览与安装说明 README.md
Idea 评估 Agent agents/idea-critic.md
战略顾问 Agent agents/research-strategist.md
头脑风暴 Agent agents/brainstormer.md
6 阶段会话编排 skills/research-companion/SKILL.md
8 大研究策略原则 principles/research-strategy.md
Codex 安装指南 docs/codex-installation.md
插件市场定义 marketplace.json

最后的话

Research Companion 不会帮你产出更多论文,但会帮你产出更好的论文——诚实地判断哪些 Idea 配得上你有限的时间,并在投入数月之前,把想法压力测试一遍。祝你的下一个 Idea 拿到 PURSUE!

登录后查看全文
research-companion