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

ВведениеЕсли вы уже слышали, как люди говорят о «Loop Engineering», но всё ещё не уверены, с чего начать, это руководство даст вам практическую отправную точку.Вместо того чтобы снова и снова писать промпты и вручную проверять каждый шаг, цикл позволяет AI-агенту работать над небольшой целью по расписанию. Система может назначить задачу, прочитать текущее состояние, запустить агента, проверить результат и снова подключить человека, когда требуется суждение.В исходном отчёте был представлен open-source-фреймворк Loop Engineering от Cobus Greyling. На момент публикации отчёта проект набрал около 4,5 тыс. звёзд на GitHub. Сейчас репозиторий может показывать другое количество звёзд, поскольку проект продолжил расти.Кратко: цель больше не только в том, чтобы писать лучшие промпты. Цель в том, чтобы спроектировать надёжный цикл, который может формировать промпты, проверять результат и итеративно улучшать работу в чётко заданных границах.![На изображении показан текст в стиле кода на тёмном фоне. Текст гласит: «Stop prompting. Design the loop. Get a score.», при этом фраза «Get a score.» выделена зелёным. Ниже приведены выражения в стиле кода: «loop

• init → loop
• audit» и «10 → 70 → 100». Изображение связано с описанием Loop Engineering выше и подчёркивает процесс перехода от прекращения простого написания промптов к проектированию цикла и получению оценки. Оно наглядно показывает этапы проектирования цикла и изменение оценки, помогая понять ключевую идею loop engineering.](https://we0-cms.oss-cn-beijing.aliyuncs.com/cms-assets/image/2026/07/c3d22bdf-e875-4a83-8285-9762a5a1d64e-03-72083769-3a19-4a9a-8930-8cffb4299a3d.gif)## Что такое 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-проекта.> Примечание: в некоторых перепечатанных версиях исходной статьи флаги командной строки отображаются с длинным тире. В настоящем терминале используйте стандартный двойной дефис --, как показано ниже.```Bash
  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-проекта.Bash npx @cobusgreyling/loop-init . --pattern daily-triage --tool claude Вы можете заменить имя инструмента, если используете другого AI-агента для кодинга.Bash 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: Оцените стоимость токеновВысокочастотные циклы могут потреблять много токенов, особенно если они используют субагентов, длинный контекст или повторную проверку. Оцените стоимость, прежде чем запускать цикл слишком часто.```Bash
npx @cobusgreyling/loop-cost --pattern daily-triage --level L1

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

npx @cobusgreyling/loop-audit . --suggest
Если ваш проект не готов, сначала исправьте недостающие элементы. Частые пробелы включают отсутствие файла состояния, отсутствие шага проверки, неясную область действия, отсутствующие бюджетные лимиты или слабые правила передачи человеку.Если проект достиг хорошего уровня готовности, вы также можете сгенерировать бейдж Loop Ready для README.Bash
npx @cobusgreyling/loop-audit . --badge
### Шаг 5: Начните в режиме только отчетовНе позволяйте циклу изменять production-код в первый день. Начните с режима только отчетов, затем вручную проверьте результат.Для команды цикла в стиле Grok первый запуск может выглядеть так:Plaintext
/loop 1d Run loop-triage. Update STATE.md. No auto-fix in week one.

```Это указывает циклу выполнить triage, записать состояние и избегать автоматических исправлений в течение первой недели.### Шаг 6: Прочитайте результатОткройте STATE.md и проверьте, что нашел цикл. Этот файл работает как память вне беседы. Он должен показывать, что цикл увидел, что сделал, что пропустил и что требует внимания человека.Если результат шумный или неверный, настройте цикл, прежде чем повышать автономность. Полезный цикл должен становиться скучным, предсказуемым и проверяемым.## Зрелость цикла: от L1 до L3Loop 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. Создайте каркас цикла, оцените стоимость в токенах, проведите аудит готовности и оставьте первую неделю в режиме «только отчёт».Главный вывод не в том, что люди исчезают из разработки. Агенты могут быстрее двигаться внутри циклов, но продуктовые решения, границы безопасности и определение «готово» по-прежнему зависят от людей.Лучший первый цикл — не самый автономный. Это тот, который вы можете проверять, которому можете доверять и который можете улучшать.