autoresearch

扔个问题给它，全网资料自动整理成报告

开源 🏷️定价信息待确认 ✅ 目前可打开智能体 🍴 复刻 492 🐛 待处理 1 👀 关注 24

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 6813

维护状态较活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

autoresearch 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队uditgoenka

官网地址https://udit.co/projects/autoresearch

GitHubhttps://github.com/uditgoenka/autoresearch

定价模式🏷️定价信息待确认

价格说明官网为个人项目页，未提供定价信息，需进一步确认。

访问状态✅ 目前可打开

是否开源是

开源协议MIT

主要语言Shell

技术栈/模型ai,autonomous-agent,autoresearch,claude,claude-code,iteration,karpathy,productivity,skill

GitHub 星标★ 6813

上线时间2026-03-13 00:00:00

代码更新2026-10-31

仓库体积1.0 MB

本站数据更新2026-11-08

维护状态较活跃

收录时间2026-08-09

浏览次数12

项目介绍

Claude Autoresearch 技能：为 Claude Code 实现自主目标驱动迭代，受 Karpathy 的 autoresearch 启发，遵循“修改→验证→保留/丢弃→循环”模式，让智能体持续自动优化。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6813

技术标签

ai autonomous-agent autoresearch claude claude-code

使用教程

难度：入门约 10 分钟部署方式：命令行工具 5 步

环境要求

已安装 Git（用于克隆仓库）
已安装并配置好 Claude Code、OpenCode 或 OpenAI Codex 其中之一
终端可执行 shell 脚本（install.sh 为 Shell 脚本）
本地项目需提前定义可机械度量的指标与验证命令

安装与启动步骤

1克隆仓库

从 GitHub 拉取 autoresearch 源码到本地，后续安装脚本与技能文件都在此目录中。
```
git clone https://github.com/uditgoenka/autoresearch.git
```
2安装到 OpenCode

进入仓库目录，运行引导式安装脚本，--global 表示安装到全局配置以便任意项目使用。
```
cd autoresearch
./scripts/install.sh --opencode --global
```
3安装到 Codex

若使用 OpenAI Codex，改用 --codex 参数执行同一安装脚本，同样支持全局安装。
```
cd autoresearch
./scripts/install.sh --codex --global
```

4手动复制（备选）

不想用安装脚本时，可手动把 OpenCode 的技能与命令目录复制到项目本地 .opencode 下。

git clone https://github.com/uditgoenka/autoresearch.git
cp -r autoresearch/.opencode/skills/autoresearch .opencode/skills/autoresearch
cp autoresearch/.opencode/commands/autoresearch*.md .opencode/commands/

5运行自主循环

用 /autoresearch 触发，补全 Goal、Scope、Metric、Verify、Iterations，代理会先建基线再迭代。

/autoresearch
Goal: Increase test coverage from 72% to 90%
Scope: src/**/*.test.ts, src/**/*.ts
Metric: coverage % (higher is better)
Verify: npm test -- --coverage | grep "All files"
Iterations: 25

关键配置

配置项	必填	说明	示例
`Goal`	是	本次自主迭代要达成的目标描述	`Increase test coverage from 72% to 90%`
`Scope`	否	限定可被修改与只读的文件范围	`src/*/.test.ts, src/*/.ts`
`Metric`	是	机械可度量的评价指标及优化方向	`coverage % (higher is better)`
`Verify`	是	每轮迭代后执行的验证命令，输出作为判定依据	`npm test -- --coverage \| grep "All files"`
`Iterations`	否	循环最大迭代次数，达到后自动停止	`25`

如何确认成功

在 OpenCode 或 Codex 中输入 /autoresearch 或 $autoresearch，能看到技能响应并进入 setup 阶段即安装成功。

常见问题

Q：支持哪些 AI 编码工具？

A：核心技能、运行时、安装与验证同时支持 Claude Code、OpenCode 和 OpenAI Codex；但 Hook 防护只有 Claude Code 可用。

Q：Codex 里怎么调用？

A：使用 $autoresearch 提及语法，子命令以关键字形式给出，例如 $autoresearch plan、$autoresearch debug、$autoresearch evals。

Q：OpenCode 有哪些子命令？

A：共 14 个命令，如 /autoresearch_debug、/autoresearch_fix、/autoresearch_improve 等。

Q：循环什么时候结束？

A：运行指定次数（如 Iterations: 25）后自动停止，或由你手动中断；失败的改动会自动回滚，改进则被保留。

注意事项

所有 hooks 默认开启，仅在排查问题时才单独关闭。
运行前代理会先读取上下文、定义目标与范围，并在当前状态跑一次基线（iteration #0）。
v2.2.0 起 Orchestrator 支持直接输入自然语言目标，先分类目标并推导 Success 谓词，确认后自动串联子命令。
Codex 安装包内含打包好的 orchestrator 与 regression helpers，位于 plugins/autoresearch/skills/autoresearch/ 和 .agents/skills/autoresearch/。