🔬 Autoresearch Skill

Автономная, целенаправленная итерация для Claude Code

Вдохновлено autoresearch Андрея Карпатого — расширено до универсального рабочего процесса на основе бенчмарков с реальными данными для любой инженерной задачи.

✨ Что это такое?

Autoresearch — это Claude Code скилл, который превращает произвольно сформулированную цель вида

в автономный, самокорректирующийся цикл оптимизации, который:

1. 🧠 Разбирает цель на семь машиночитаемых слотов
2. 📦 Загружает реальные данные (отказывается от синтетических корпусов)
3. 🛠️ Строит однофайловый бенчмарк-харнесс
4. 📐 Фиксирует baseline + количество регрессионных тестов
5. 🔁 Итерирует — по одному атомарному изменению за раз
6. ✅ Сохраняет улучшения, 🗑️ автоматически откатывает регрессии, логирует всё
7. 🏁 Останавливается, когда целевая метрика достигнута

Без подсказок. Без «продолжать?». Только механическая итерация до достижения цели.

🌟 Зачем использовать?

🎯 Механически, не субъективно

Каждая итерация оценивается единственной числовой метрикой, извлечённой из команды. «Выглядит лучше» — запрещено.

🛡️ Защита от регрессий

Жёсткий шлюз откатывает любое изменение, которое ломает ранее проходившие тесты — независимо от величины улучшения.

📊 Только реальные данные

Харнесс отказывается от синтетических корпусов. Если данные нельзя собрать, экспортировать или получить из реальной системы — цикл не запустится.

♻️ Атомарно и обратимо

Одно изменение за итерацию, зафиксированное в git до верификации. Неудачный эксперимент всегда отменяется через git reset --hard HEAD~1.

🧩 Не зависит от домена

Задержка бэкенда, покрытие тестами, размер бандла, нестабильность тестов, LOC, время сборки, lighthouse-оценки — один и тот же цикл, разные метрики.

🌐 Глобальный Claude Code скилл

Установите один раз в ~/.claude/skills/autoresearch/ и вызывайте /autoresearch <цель> из любого проекта.

🚀 Быстрый старт

1. Установка (глобальный скилл)

# Клонируйте в директорию скиллов Claude Code
git clone https://github.com/Muminur/autoresearch-skill-Andrej-Karpathy.git \
  ~/.claude/skills/autoresearch

Для Windows:

git clone https://github.com/Muminur/autoresearch-skill-Andrej-Karpathy.git `
  "$env:USERPROFILE\.claude\skills\autoresearch"

2. Вызов

Откройте Claude Code в любом проекте и введите:

Claude выведет дамп разобранных слотов, пройдёт пять фаз построения харнесса, затем запустит автономный цикл.

3. Наблюдайте за работой

Результаты добавляются в autoresearch/results.tsv в вашем проекте:

commit    metric     avg_latency_ms  status      description
953b71d   1.000000   2008.9          baseline    77-case corpus, 10 signals executed
953b71d   1.000000   646.4           keep        parallelize _place_exits with asyncio.gather
953b71d   1.000000   592.1           keep        add 30s TTL cache on account()
953b71d   1.000000   488.8           keep        prewarm account+connection pool, serialize signals

🔌 Использование с другими AI-ассистентами для кода

Скилл представляет собой обычный Markdown — добавьте его в любой агент, поддерживающий пользовательские промпты, правила или инструкции. Клонируйте репозиторий один раз во временную директорию, затем создайте симлинк или скопируйте файлы в путь конфигурации нужного инструмента:

git clone https://github.com/Muminur/autoresearch-skill-Andrej-Karpathy.git ~/autoresearch-skill

Для Windows замените ~/autoresearch-skill на %USERPROFILE%\autoresearch-skill в командах ниже.

🧠 OpenAI Codex CLI

Codex CLI загружает пользовательские промпты из ~/.codex/prompts/.

mkdir -p ~/.codex/prompts
cp    ~/autoresearch-skill/SKILL.md  ~/.codex/prompts/autoresearch.md
cp -r ~/autoresearch-skill/references ~/.codex/prompts/

Вызов в чате Codex: /autoresearch reduce API p95 to 200ms.

💡 Совет — добавьте @file ~/.codex/prompts/autoresearch.md в ~/.codex/AGENTS.md, чтобы рубрика загружалась автоматически в каждой сессии.

🤖 GitHub Copilot (VS Code и JetBrains)

Copilot Chat поддерживает файлы промптов (*.prompt.md) и файлы инструкций (*.instructions.md).

Уровень проекта (добавляется в репозиторий):

mkdir -p .github/prompts
cp    ~/autoresearch-skill/SKILL.md  .github/prompts/autoresearch.prompt.md
cp -r ~/autoresearch-skill/references .github/prompts/

Уровень пользователя (доступно во всех проектах):

Включите файлы промптов в settings.json VS Code:

Вызов: /autoresearch <цель> в Copilot Chat.

🪐 OpenCode

OpenCode хранит пользовательские команды в ~/.config/opencode/command/.

mkdir -p ~/.config/opencode/command
cp    ~/autoresearch-skill/SKILL.md  ~/.config/opencode/command/autoresearch.md
cp -r ~/autoresearch-skill/references ~/.config/opencode/command/

Вызов: /autoresearch <цель> в OpenCode.

⚡ Cursor

Cursor загружает правила проекта из .cursor/rules/ и глобальные правила пользователя из ~/.cursor/rules/.

# Уровень проекта
mkdir -p .cursor/rules
cp    ~/autoresearch-skill/SKILL.md  .cursor/rules/autoresearch.mdc
cp -r ~/autoresearch-skill/references .cursor/rules/

# Уровень пользователя (глобально)
mkdir -p ~/.cursor/rules
cp    ~/autoresearch-skill/SKILL.md  ~/.cursor/rules/autoresearch.mdc
cp -r ~/autoresearch-skill/references ~/.cursor/rules/

Вызов: упомяните /autoresearch <цель> в чате Cursor или добавьте его в системный промпт.

📁 Структура репозитория

🤝 Участие в разработке

Pull request'ы приветствуются. Для крупных изменений сначала откройте issue для обсуждения.

📄 Лицензия

MIT — подробности в файле LICENSE.

Вдохновлено autoresearch Андрея Карпатого