Руководство по Loop Engineering для начинающих: запустите свой первый цикл AI-агента одной командой

Введение

Если вы уже слышали, как люди говорят о «Loop Engineering», но всё ещё не уверены, с чего начать, это руководство даст вам практическую отправную точку.

Вместо того чтобы снова и снова писать промпты и вручную проверять каждый шаг, цикл позволяет AI-агенту работать над небольшой целью по расписанию. Система может назначить задачу, прочитать текущее состояние, запустить агента, проверить результат и снова подключить человека, когда требуется суждение.

В исходном отчёте был представлен open-source-фреймворк Loop Engineering от Cobus Greyling. На момент публикации отчёта проект набрал около 4,5 тыс. звёзд на GitHub. Сейчас репозиторий может показывать другое количество звёзд, поскольку проект продолжил расти.

Кратко: цель больше не только в том, чтобы писать лучшие промпты. Цель в том, чтобы спроектировать надёжный цикл, который может формировать промпты, проверять результат и итеративно улучшать работу в чётко заданных границах.

Что такое Loop Engineering?

Loop Engineering — это способ проектирования повторяемых рабочих процессов для AI-агентов. Цикл — это не просто один промпт. Это небольшая операционная система вокруг агента: она определяет, когда агент запускается, какой контекст он читает, что ему разрешено изменять, как проверяется результат и когда человеку нужно просмотреть итог.

Типичный цикл можно использовать для таких задач, как:

• ежедневная сортировка задач проекта;
• отслеживание pull request’ов;
• устранение сбоев CI;
• сканирование зависимостей;
• сортировка issues;
• очистка после merge;
• подготовка черновиков changelog’ов.

Эти задачи не всегда сложные, но они повторяющиеся. Они требуют внимания, контекста и единых стандартов. Именно в такой работе хорошо спроектированный цикл может быть полезен.

Почему этот фреймворк привлекает внимание

Open-source-фреймворк, описанный в исходной статье, объединяет практические шаблоны циклов, стартовые шаблоны и инструменты командной строки. Он разработан для AI-агентов, работающих с кодом, и поддерживает рабочие процессы вокруг таких инструментов, как Claude Code, Codex, Grok и OpenCode.

Фреймворк включает:

• семь готовых к использованию шаблонов циклов;
• стартовые шаблоны для распространённых сценариев;
• loop-init для создания структуры цикла;
• loop-cost для оценки стоимости в токенах;
• loop-audit для проверки готовности цикла;
• файлы состояния и бюджета для более длительных рабочих процессов;
• поддержку более безопасной проверки человеком и поэтапного внедрения.

Главная мысль проста:

Перестаньте просто писать промпты. Проектируйте цикл.

Это не значит, что промпты исчезают. Это значит, что промпты становятся частью более крупной системы, которая может повторять работу, отслеживать состояние и проверять результаты.

Быстрый старт: одна команда

Самый быстрый способ начать — запустить loop-init внутри Git-проекта.

Примечание: в некоторых перепечатанных версиях исходной статьи флаги командной строки отображаются с длинным тире. В настоящем терминале используйте стандартный двойной дефис --, как показано ниже.

npx @cobusgreyling/loop-init . --pattern daily-triage --tool claude

Эта команда создаёт структуру цикла в вашем текущем проекте. Вы можете заменить claude на другой поддерживаемый инструмент, например grok, codex или opencode, в зависимости от рабочего процесса, который хотите протестировать.

Шаблон daily-triage — хорошая отправная точка для начинающих, потому что он менее рискован, чем высокочастотная автоматизация. Он сосредоточен на сканировании текущего состояния проекта и создании отчёта до разрешения каких-либо автоматических изменений.

Руководство по Loop Engineering для начинающих

Сначала Loop Engineering может показаться абстрактным, но фреймворк разбивает его на несколько конкретных строительных блоков.

Пять строительных блоков плюс память

На базовом уровне цикл строится из пяти основных частей, а также памяти и состояния.

Строительный блок	Что он делает в цикле
Автоматизация / планирование	Запускает цикл с заданной периодичностью, например ежедневно, ежечасно или каждые несколько минут.
Worktrees	Создаёт изолированные рабочие среды, чтобы несколько агентов не перезаписывали работу друг друга.
Навыки	Хранят переиспользуемые знания о проекте, правила и инструкции по задачам.
Плагины и коннекторы	Подключают цикл к реальным инструментам через такие системы, как MCP, GitHub, Linear или Slack.
Субагенты	Разделяют роль исполнителя и роль проверяющего, чтобы один и тот же агент не утверждал собственную работу.
Память / состояние	Сохраняет долговременный контекст вне цикла.

чат, обычно через файлы вроде STATE.md. |

Такая структура делает цикл более понятным. Вы не просите модель «просто разобраться со всем». Вы задаете ей определенную среду, расписание, файл состояния, путь проверки и правило передачи человеку.

Семь готовых производственных шаблонов

Фреймворк также включает семь шаблонов, ориентированных на production. У каждого шаблона свой ритм, уровень риска и оптимальный сценарий применения.

Шаблон	Типичный сценарий применения	Рекомендуемый стартовый режим
Daily Triage	Сканирование состояния проекта, задач, CI и коммитов.	L1 report-only
PR Babysitter	Сопровождение pull request’ов на этапах ревью, CI, rebase и merge.	L1 watch
CI Sweeper	Отслеживание падающих проверок и предложение или применение небольших исправлений.	L2 cautious
Dependency Sweeper	Проверка устаревших зависимостей и обновлений безопасности.	L2 patch-only
Issue Triage	Дедупликация, оценка и маркировка входящих задач.	L1 propose-only
Post-Merge Cleanup	Очистка TODO, небольшого технического долга и последующих работ после merge.	L1 off-peak
Changelog Drafter	Подготовка черновика заметок к релизу на основе коммитов и слитых изменений.	L1 draft

Практический совет — начать с цикла с низким риском. Daily triage обычно проще доверять, потому что он не требует немедленного изменения кода.

Интерактивный выбор шаблона

Проект также предоставляет интерактивный выбор шаблона. Вместо ручного выбора шаблона можно начать с проблемной точки, например: «PR постоянно застревают», «CI постоянно падает» или «в задачах слишком много шума».

Затем инструмент выбора рекомендует шаблон цикла и дает стартовую команду. Это полезно, когда вы знаете проблему, но не уверены, какой цикл должен с ней работать.

Запустите свой первый цикл

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

Шаг 1: Выберите шаблон

Начните с daily-triage, если делаете это впервые. Это шаблон с низким риском и хороший способ понять, как цикл читает состояние проекта, записывает заметки и подготавливает работу для человека.

Шаг 2: Создайте каркас цикла

Запустите команду инициализации в корневом каталоге вашего Git-проекта.

npx @cobusgreyling/loop-init . --pattern daily-triage --tool claude

Вы можете заменить имя инструмента, если используете другого AI-агента для кодинга.

npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
npx @cobusgreyling/loop-init . --pattern daily-triage --tool codex
npx @cobusgreyling/loop-init . --pattern daily-triage --tool opencode

Вы также можете заменить daily-triage на другой поддерживаемый шаблон, когда поймете базовый процесс.

Шаг 3: Оцените стоимость токенов

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

npx @cobusgreyling/loop-cost --pattern daily-triage --level L1

Для раннего тестирования оставьте цикл на уровне L1 и избегайте агрессивных расписаний.

Шаг 4: Проверьте готовность цикла

Перед тем как доверять циклу, выполните аудит. Аудит присваивает проекту оценку готовности от 0 до 100 и предлагает улучшения.

npx @cobusgreyling/loop-audit . --suggest

Если ваш проект не готов, сначала исправьте недостающие элементы. Частые пробелы включают отсутствие файла состояния, отсутствие шага проверки, неясную область действия, отсутствующие бюджетные лимиты или слабые правила передачи человеку.

Если проект достиг хорошего уровня готовности, вы также можете сгенерировать бейдж Loop Ready для README.

npx @cobusgreyling/loop-audit . --badge

Шаг 5: Начните в режиме только отчетов

Не позволяйте циклу изменять production-код в первый день. Начните с режима только отчетов, затем вручную проверьте результат.

Для команды цикла в стиле Grok первый запуск может выглядеть так:

/loop 1d Run loop-triage. Update STATE.md. No auto-fix in week one.

Это указывает циклу выполнить triage, записать состояние и избегать автоматических исправлений в течение первой недели.

Шаг 6: Прочитайте результат

Откройте STATE.md и проверьте, что нашел цикл. Этот файл работает как память вне беседы. Он должен показывать, что цикл увидел, что сделал, что пропустил и что требует внимания человека.

Если результат шумный или неверный, настройте цикл, прежде чем повышать автономность. Полезный цикл должен становиться скучным, предсказуемым и проверяемым.

Зрелость цикла: от L1 до L3

Loop Engineering следует внедрять постепенно. Уровни зрелости помогают не давать слишком много свободы слишком рано.

Уровень	Значение	Рекомендуемое использование
L1	Цикл сообщает о находках и обновляет состояние, но не изменяет код.	Лучше всего подходит для первых запусков и внедрения с низким риском.
L2	Цикл может вносить небольшие изменения с верификатором и ревью человеком.	Полезно после того, как команда начала доверять результатам цикла.
L3	Цикл может работать более длительные периоды с ограниченным выполнением без присмотра.	Подходит только тогда, когда область действия, безопасность, стоимость и проверка уже зрелые.

Хорошая первая цель — не полная автономность. Хорошая первая цель — надежный цикл L1, который дает вам полезную информацию без

создавая дополнительную работу по очистке.

Стандартный процесс цикла

У полноценного цикла есть четкая последовательность. В оригинальной статье он описывался как процесс из восьми шагов:

1. запуск по расписанию;
2. сортировка задач;
3. чтение текущего состояния;
4. создание изолированного рабочего пространства;
5. запуск выполнения агентом;
6. выполнение проверок верификатора;
7. подключение к Git или системам тикетов;
8. запрос подтверждения у человека при необходимости.

В этом главное отличие случайного промпта от настоящего цикла. Агент не просто «что-то делает». Он работает внутри контролируемого процесса с состоянием, изоляцией, проверками и передачей результата.

Эндрю Ын: для разработки продукта нужны три цикла

Оригинальная статья также связывала Loop Engineering с обсуждением разработки продуктов Эндрю Ыном. Ключевая мысль заключается в том, что создание программного обеспечения с помощью ИИ — это не один-единственный цикл. Для реального продукта существует несколько циклов, движущихся с разной скоростью.

1. Агентный цикл кодирования

Самый внутренний цикл — это цикл кодирования. Человек дает агенту спецификацию продукта и критерии оценки. Агент пишет код, тестирует его, исправляет проблемы и продолжает итерации.

Этот цикл может быть быстрым. В некоторых случаях он способен выпускать новую версию каждые несколько минут.

2. Цикл обратной связи от разработчика

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

Этот цикл медленнее. Он может запускаться каждые несколько десятков минут или каждые несколько часов — в зависимости от продукта и сложности изменений.

3. Внешний цикл обратной связи

Внешний слой — это цикл обратной связи от пользователей. Когда продукт попадает к друзьям, альфа-тестировщикам или реальным пользователям, команда начинает учиться на основе отзывов, данных об использовании и экспериментов.

Этот цикл еще медленнее. Он может занимать часы, дни или недели.

Вместе эти три цикла создают практическую цепочку создания продукта: агент помогает быстро выпускать версии, разработчик решает, каким должен стать продукт, а пользователи подтверждают, стоит ли продолжать выбранное направление.

Почему человеческий вкус по-прежнему важен

Loop Engineering не устраняет людей из разработки программного обеспечения. Он меняет роль человека.

Агент может брать на себя повторяющееся выполнение, но ему все равно нужны четкие границы, надежная проверка и продуктовая оценка. Человек по-прежнему понимает контекст: что нужно пользователям, какие компромиссы важны, что не следует автоматизировать и что на самом деле означает «достаточно хорошо».

Именно поэтому цикл можно установить одной командой, но определение «готово» по-прежнему принадлежит людям, создающим продукт.

Примечание об источнике

Оригинальный источник: статья BAAI Hub, перепечатанная с QbitAI / WeChat. В статье также упоминались репозиторий Loop Engineering на GitHub и публичная публикация Эндрю Ына в X.

Примечание об изображениях: начальное мем-изображение и финальный рекламный баннер с QR-кодом/контактами со страницы источника были исключены, поскольку они не нужны для понимания руководства. Остальные изображения включены только там, где они поддерживают техническое объяснение.

FAQ

Что такое Loop Engineering?

Loop Engineering — это способ проектирования повторяемых рабочих процессов для ИИ-агентов. Вместо того чтобы вручную давать агенту промпт для каждой небольшой задачи, вы определяете цикл с расписанием, состоянием, инструментами, проверкой и передачей человеку.

Как начать проект Loop Engineering?

Самый быстрый способ начать — выполнить npx @cobusgreyling/loop-init . --pattern daily-triage --tool claude внутри Git-проекта. Для новичков daily-triage обычно безопаснее, чем высокочастотные циклы, потому что он может начать работу в режиме только отчетов.

Почему Loop Engineering использует STATE.md?

STATE.md дает циклу устойчивую память вне чат-сессии. Он помогает циклу помнить предыдущие находки, последние действия, нерешенные вопросы и переопределения, сделанные человеком.

Что такое оценка Loop Ready?

Оценка Loop Ready — это результат аудита, создаваемый loop-audit. Он проверяет, достаточно ли в проекте структуры, состояния, проверки, ограничений затрат и механизмов безопасности, чтобы ответственно запускать цикл.

Может ли цикл ИИ-агента работать без присмотра?

Это

может, но начинать с этого не стоит. Более безопасный путь — сначала L1 в режиме «только отчёт», затем L2 с исправлениями при участии человека и проверкой, и только позже L3 с автономными запусками, когда область применения, безопасность и контроль затрат уже достаточно зрелые.

Почему стоит оценивать стоимость в токенах до запуска цикла?

Циклы могут стать дорогими, если они запускаются часто, используют длинный контекст или создают несколько субагентов. loop-cost помогает оценить использование заранее, прежде чем высокочастотный рабочий процесс израсходует бюджет.

Как это связано с идеей трёх циклов Эндрю Ына?

Инженерный цикл помогает агентам быстро создавать и дорабатывать программное обеспечение. Обратная связь от разработчиков и пользователей — более медленные циклы, которые определяют, полезен ли продукт, удобен ли он и стоит ли продолжать его развивать.

Связанные инструменты

• Loop Engineering: Открытые шаблоны, стартовые заготовки и CLI-инструменты для проектирования циклов ИИ-агентов.
• Loop Engineering Showcase: Интерактивный обзор с шаблонами, примитивами и симулятором готовности.
• Node.js: Среда выполнения, необходимая для использования CLI-инструментов на базе npx.
• npm: Экосистема пакетов, используемая для запуска команд Loop Engineering CLI через npx.
• Git: Система контроля версий, используемая для репозиториев и изолированного выполнения на основе worktree.
• GitHub Actions: Платформа автоматизации, которая может поддерживать запланированные проверки и рабочие процессы валидации циклов.
• Model Context Protocol: Протокол для подключения ИИ-систем к внешним инструментам и источникам данных.

Связанные ссылки

• Оригинальная статья BAAI Hub: Исходная статья, представляющая учебное руководство по Loop Engineering для начинающих.
• Репозиторий Loop Engineering на GitHub: Основной репозиторий с шаблонами, стартовыми заготовками, документацией и CLI-инструментами.
• Loop Engineering Showcase: Официальная интерактивная страница для изучения фреймворка.
• Five Primitives + Memory: Официальное объяснение основных строительных блоков циклов.
• Loop Design Checklist: Чек-лист для определения готовности цикла к использованию в продакшене.
• Loop Safety Guide: Заметки по безопасности автоматизации, путям из denylist, проверке человеком и управлению рисками.
• Operating Loops: Заметки о стоимости, логировании, истории запусков и операционной дисциплине.
• Loop Patterns README: Обзор доступных шаблонов производственных циклов.

Резюме

Это руководство объясняет, как Loop Engineering превращает разовые промпты для ИИ в повторяемые агентные рабочие процессы. Базовая идея заключается в том, чтобы определить расписание, состояние, инструменты, проверку и процесс человеческого контроля до того, как доверять агенту повторяющиеся действия.

Для первого запуска самым безопасным стартом будет daily-triage. Создайте каркас цикла, оцените стоимость в токенах, проведите аудит готовности и оставьте первую неделю в режиме «только отчёт».

Главный вывод не в том, что люди исчезают из разработки. Агенты могут быстрее двигаться внутри циклов, но продуктовые решения, границы безопасности и определение «готово» по-прежнему зависят от людей.

Лучший первый цикл — не самый автономный. Это тот, который вы можете проверять, которому можете доверять и который можете улучшать.