Research Companion 5分钟上手教程:Claude Code插件安装与首次研究Idea评估
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
这意味着你的研究思考会随时间沉淀,而不是每次从零开始。
七、快速上手清单与关键文件
上手清单
- ⏱️ 30 秒:
claude plugin marketplace add+claude plugin install - ⏱️ 2 分钟:描述一个 Idea,请求评估,读懂 7 维评分
- ⏱️ 15 分钟(可选):运行一次
/research-companion完整 6 阶段会话 - 📌 养成习惯:每 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!