Skip to content

快速上手

你真正要装的是什么

现在这套产品分成两个仓库:

  • 运行时产品:~/Claude/Harness/omr
  • 公共文档站:~/Claude/arch-site

真正跑自动化科研,只需要前者。

新电脑安装

前置条件:

  • Claude Code
  • Node.js 20+
  • Git
  • tmux
  • 可选:codex / gemini CLI(外部 worker)

推荐目录结构:

text
~/Claude/Harness/
  omr/        # 产品仓库
  shared/     # 私有基础设施/配置
  <projects>/ # 研究项目目录

安装命令:

bash
mkdir -p ~/Claude/Harness
cd ~/Claude/Harness
git clone git@github.com:JingxuanKang/ohmyresearch.git omr
cd ~/Claude/Harness/omr
./install.sh

安装后:

  1. 重启 Claude Code
  2. ~/Claude/Harness 下打开 Claude Code
  3. 如需显式刷新 hooks / agents / skills,运行一次 omr setup

验证:

bash
which omr
omr --help
cd ~ && omr --help   # 在 Harness 外应报错

核心命令

在 Claude Code 里,科研产品真正围绕这些命令运转:

命令作用
/research init &lt;name&gt; &lt;description&gt;在当前目录创建研究项目
/research status查看当前阶段和 gate 配置
``/research gate <stage> <humanauto
autopilot在研究阶段之间自动推进
ralph在当前阶段内循环直到完成
ultrawork并行执行独立科研任务
/handoff写出可恢复的交接文件

Gate 语义

当前运行时只保留三种 gate:

Gate含义
human等待人工审批
auto自动继续
default使用仓库定义的阶段默认值

推荐默认值:

  • ideation: human
  • baseline-digestion: auto
  • design: human
  • implementation: default
  • training: default
  • analysis: human
  • writing: human
  • review: human

典型流程

text
1. /research init
2. 描述研究方向
3. 运行 autopilot
4. 在 human gate 处审阅结果
5. 阶段内需要循环时用 ralph,需要并行时用 ultrawork
6. 结束前用 /handoff

更新

bash
cd ~/Claude/Harness/omr
git pull --ff-only origin main
npm install
npm run build
omr update-reconcile

下一步

AutoResearch — Multi-agent Deep Learning Research System