Autoresearch
Скилл автономной итерации для агента: правка, проверка, откат неудачных изменений и повтор цикла к заданной метрике
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Автономно правит код в цикле, делает коммиты и откаты через git
- Выполняет команды оболочки для проверки тестами и бенчмарками
- Без хуков-ограждений может выполнять произвольные действия в проекте
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/uditgoenka-autoresearchОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
Выполните в терминале в папке проекта
npx skills add uditgoenka/autoresearch --skill autoresearch autoresearch autoresearch autoresearch autoresearch -a claude-code -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 050e30d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .claude/skills
cp -R "$tmp/.agents/skills/autoresearch" .claude/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .claude/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .claude/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .claude/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .claude/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add uditgoenka/autoresearch --skill autoresearch autoresearch autoresearch autoresearch autoresearch -a cursor -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 050e30d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .agents/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add uditgoenka/autoresearch --skill autoresearch autoresearch autoresearch autoresearch autoresearch -a github-copilot -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 050e30d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .github/skills
cp -R "$tmp/.agents/skills/autoresearch" .github/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .github/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .github/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .github/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .github/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add uditgoenka/autoresearch --skill autoresearch autoresearch autoresearch autoresearch autoresearch -a codex -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 050e30d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .agents/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add uditgoenka/autoresearch --skill autoresearch autoresearch autoresearch autoresearch autoresearch -a gemini-cli -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 050e30d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .agents/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .devin/skills
cp -R "$tmp/.agents/skills/autoresearch" .devin/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .devin/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .devin/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .devin/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .devin/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Бывший Windsurf.
Выполните в терминале в папке проекта
npx skills add uditgoenka/autoresearch --skill autoresearch autoresearch autoresearch autoresearch autoresearch -a cline -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 050e30d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .cline/skills
cp -R "$tmp/.agents/skills/autoresearch" .cline/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .cline/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .cline/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .cline/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .cline/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
npx skills add uditgoenka/autoresearch --skill autoresearch autoresearch autoresearch autoresearch autoresearch -a roo -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 050e30d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .roo/skills
cp -R "$tmp/.agents/skills/autoresearch" .roo/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .roo/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .roo/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .roo/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .roo/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Форк Roo Code, папки .roo те же.
Выполните в терминале в папке проекта
npx skills add uditgoenka/autoresearch --skill autoresearch autoresearch autoresearch autoresearch autoresearch -a opencode -yУтилита skills ставит текущую версию из репозитория. Чтобы скилл работал во всех проектах, добавьте флаг -g.
Без сторонних утилит, из коммита 050e30d
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .agents/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .agents/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Выполните в терминале в папке проекта
tmp=$(mktemp -d)
git clone --filter=blob:none --no-checkout https://github.com/uditgoenka/autoresearch.git "$tmp"
git -C "$tmp" sparse-checkout set --no-cone /.agents/skills/autoresearch/ /.claude/skills/autoresearch/ /claude-plugin/skills/autoresearch/ /.opencode/skills/autoresearch/ /plugins/autoresearch/skills/autoresearch/
git -C "$tmp" checkout 050e30dc4ba0974b03f2873111b9901ec3211390
mkdir -p .agents/skills
cp -R "$tmp/.agents/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.claude/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/claude-plugin/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/.opencode/skills/autoresearch" .agents/skills/autoresearch
cp -R "$tmp/plugins/autoresearch/skills/autoresearch" .agents/skills/autoresearchКоманды для macOS и Linux, на Windows выполните их в Git Bash.
Установи скилл: npx skills add uditgoenka/autoresearch. В Claude Code можно через плагин: /plugin marketplace add uditgoenka/autoresearch, затем /plugin install autoresearch@autoresearch. После установки начни новую сессию.
Другие способы из описания автора
npx skills add uditgoenka/autoresearchПосле установки перезапустите сессию агента.
Проверка безопасности
Как мы проверяемВысокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
- Автономно правит код в цикле, делает коммиты и откаты через git
- Выполняет команды оболочки для проверки тестами и бенчмарками
- Без хуков-ограждений может выполнять произвольные действия в проекте
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Autoresearch превращает агента в цикл непрерывного улучшения по мотивам autoresearch Карпатого. Пользователь задает цель и механическую метрику, а агент повторяет шаги: читает состояние и историю git, делает одно сфокусированное изменение, коммитит, запускает проверку тестами или бенчмарками и оставляет изменение, если стало лучше, или откатывает его. Кроме основного цикла есть отдельные команды: план, отладка, устранение ошибок до нуля, аудит безопасности по STRIDE и OWASP, генерация краевых случаев, разбор требований, оценка результатов и проверка на регрессии. В версии с оркестратором можно задать цель обычным текстом, и агент сам подбирает нужные команды и крутит цикл до выполнения условия. Для Claude Code есть хуки-ограждения, которые блокируют опасные команды и чтение секретов.
Для кого. Для разработчиков и инженеров качества, которым нужно, чтобы агент сам итеративно улучшал код или другой измеримый результат.
Подходит, если
- Есть цель и число, которое можно измерить: тесты, бенчмарк, оценка
- Нужно довести количество ошибок до нуля через повторяющиеся правки
- Нужен автономный цикл улучшений с автоматическим откатом неудач
- Нужен аудит безопасности или проверка на регрессии перед выпуском
Не подходит, если
- Нет механической метрики, а качество можно оценить только на глаз
- Нельзя давать агенту автономно менять и коммитить код
Пример запроса к агенту
Гоняй цикл улучшений, пока все тесты не станут зелеными, каждое неудачное изменение откатывайОграничения
Цикл работает только там, где есть проверяемая метрика и способ ее запустить, для субъективных задач он не подходит. Хуки-ограждения доступны только в Claude Code, в OpenCode и Codex ставится основной скилл без них, поэтому там защиту нужно продумывать отдельно. Агент самостоятельно правит код, делает коммиты и откаты, поэтому запускать его стоит на репозитории с рабочим git.
Как отключить. Удалите плагин autoresearch через /plugin или уберите папки скилла и команд из каталога агента. Отдельные хуки можно отключить переменными окружения вида AR_DISABLE_*.
Частые вопросы
Что нужно задать перед запуском?
Цель, механическую метрику и область правки. Агент проводит разовую настройку, снимает базовый уровень и только потом запускает цикл.
Хуки безопасности работают везде?
Нет, полный набор хуков есть только в Claude Code. В OpenCode и Codex ставится основной скилл и команды без хуков.
Похожие
СкиллыНабор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything
Коротко о README
README описывает Autoresearch как автономный цикл улучшений для Claude Code, OpenCode и Codex, обобщающий подход Карпатого на любую область с измеримой метрикой. Основной цикл делает одно изменение за итерацию, коммитит до проверки, запускает механическую проверку и откатывает то, что не улучшило результат, а git служит памятью экспериментов. Кроме итерации есть четырнадцать команд: план, отладка, устранение ошибок, безопасность, выпуск, краевые случаи, разбор требований и другие, а оркестратор сам собирает нужный конвейер под цель на естественном языке. Описаны хуки-ограждения Claude Code, которые блокируют опасные команды, чтение секретов и раздувание контекста. Установка идет через npx skills, плагин или ручное копирование, а архитектура разбита на тонкий файл маршрутизации и отдельные команды ради экономии контекста.
SKILL.md
--- name: autoresearch description: "Autonomous iteration loop: modify, verify, keep/discard against any metric" version: 2.2.2 --- # Autoresearch — Autonomous Goal-directed Iteration ## Safety Invariants (all subcommands) LOOP (N iterations or until done): 1. Review current state + git history + results log 2. Pick the next change (based on what worked, what failed, what's untried) 3. Make ONE focused change 4. Git commit (before verification) 5. Run mechanical verification (tests, benchmarks, scores) 6. If improved keep. If worse git revert. If crashed fix or skip. 7. Log the result 8. Repeat until N iterations complete or goal is met.