快速上手
你真正要装的是什么
现在这套产品分成两个仓库:
- 运行时产品:
~/Claude/Harness/omr - 公共文档站:
~/Claude/arch-site
真正跑自动化科研,只需要前者。
新电脑安装
前置条件:
- Claude Code
- Node.js 20+
- Git
- tmux
- 可选:
codex/geminiCLI(外部 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安装后:
- 重启 Claude Code
- 在
~/Claude/Harness下打开 Claude Code - 如需显式刷新 hooks / agents / skills,运行一次
omr setup
验证:
bash
which omr
omr --help
cd ~ && omr --help # 在 Harness 外应报错核心命令
在 Claude Code 里,科研产品真正围绕这些命令运转:
| 命令 | 作用 |
|---|---|
/research init <name> <description> | 在当前目录创建研究项目 |
/research status | 查看当前阶段和 gate 配置 |
| ``/research gate <stage> <human | auto |
autopilot | 在研究阶段之间自动推进 |
ralph | 在当前阶段内循环直到完成 |
ultrawork | 并行执行独立科研任务 |
/handoff | 写出可恢复的交接文件 |
Gate 语义
当前运行时只保留三种 gate:
| Gate | 含义 |
|---|---|
human | 等待人工审批 |
auto | 自动继续 |
default | 使用仓库定义的阶段默认值 |
推荐默认值:
ideation:humanbaseline-digestion:autodesign:humanimplementation:defaulttraining:defaultanalysis:humanwriting:humanreview: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