Looper — проектирование циклов агента
Looper
Скилл и команда /looper для Claude Code: через интервью строит цикл агента с проверкой, независимым рецензентом и стоп-условиями до запуска
- 713 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Установщик запускается из интернета через curl и bash и создает окружение в папке скилла
- Совет рецензентов отправляет контекст проекта в CLI моделей других поставщиков, а скрытие секретов второго слоя работает не на всех форматах
- Сгенерированный цикл меняет файлы и запускает команды в вашем проекте, пока не сработают ворота или пределы
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/looperОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Установщик запускается из интернета через curl и bash и создает окружение в папке скилла
- Совет рецензентов отправляет контекст проекта в CLI моделей других поставщиков, а скрытие секретов второго слоя работает не на всех форматах
- Сгенерированный цикл меняет файлы и запускает команды в вашем проекте, пока не сработают ворота или пределы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Looper проектирует цикл агента раньше, чем тот начнет менять файлы. Команда `/looper` ведет интервью из семи шагов: цель, проверка, главная модель, совет рецензентов, ворота и ограничения, показ схемы цикла в виде ASCII и выпуск файлов. На каждом шаге скилл критикует ответ: слабую цель подтягивает к результату, объему и признаку готовности, а проверку сначала просит сделать программной, затем с оценкой судьи и только в конце с подписью человека. Рецензент пишет замечания, судья выносит структурированный вердикт, и Looper по умолчанию рекомендует для них другое семейство моделей, чем у главной. Без стоп-условий скилл цикл не выпускает: нужны предел итераций, предел правок на каждых воротах, остановка при отсутствии прогресса и бюджет либо явная точка остановки человеком. На выходе скилл создает в папке `looper-output` файлы `RUN_IN_SESSION.md`, `loop.yaml`, `loop.resolved.json`, `LOOP.md` и скрипт `run-loop.py`, пустую рабочую папку и README цикла. Цикл можно сразу запустить в текущей сессии по `RUN_IN_SESSION.md` либо позже снаружи командой `python3 ./looper-output/run-loop.py`. Вместо пустого интервью доступны пять шаблонов: `security-scan`, `code-review`, `bug-hunt`, `docs-sync` и `research-synthesis`.
Для кого. Для разработчиков, которые запускают в Claude Code повторяющиеся циклы вроде /goal или /loop и хотят заранее договориться, как проверять результат и когда останавливаться.
Подходит, если
- Вы собираетесь запустить длинный автономный цикл и хотите, чтобы у него были проверка результата, лимиты итераций и бюджет
- Нужен второй взгляд от модели другого семейства на план и на готовую работу, например от Codex или Gemini
- Требуется воспроизводимый цикл в файле `loop.yaml`, который можно хранить в репозитории и запускать позже
- Команда хочет проверять спецификации циклов в CI так же, как проверяет код, через `python scripts/looper.py lint loop.yaml`
- Нужен готовый старт для сканирования секретов, ревью ветки, поиска бага, сверки документации с кодом или синтеза источников
Не подходит, если
- Нужно просто повторять одну команду по расписанию: для этого достаточно встроенных `/loop` и `/schedule`
- Нужен разовый скрипт без разбора цели и проверок: Looper сначала проводит интервью из семи шагов, и для короткого задания это лишняя церемония
- Контекст проекта нельзя отправлять другому поставщику моделей: совет рецензентов передает его в CLI другой модели, а полностью локальный вариант возможен только на локальной модели вроде ollama
- Цель сводится к разовой правке одного файла, для которой цикл с воротами лишний
Пример запроса к агенту
/looper review-loop --template code-reviewОграничения
Looper остается слоем проектирования. Он не планирует задания по cron, не сохраняет повторные попытки шагов при перезапуске процесса, не управляет жизнью субагентов, не ограничивает параллельность и не ведет рабочий журнал для производства. Если нужны такие гарантии, спецификацию надо передать оркестратору, рассчитанному на долгие прогоны.
Предел по времени обеспечивает только внешний запуск через `run-loop.py`, в сессии Claude Code его выдерживать нечем. Скрытие секретов работает в два слоя: файлы под глобами скрытия не попадают в промпты. Их содержимое, всплывшее в другом месте, вычищается перед каждой отправкой. Второй слой работает по возможности: переформатированный текст и очень короткие значения могут уцелеть, поэтому для чувствительных путей автор советует локальную модель.
Установщик создает в папке скилла виртуальное окружение с PyYAML, без него `loop.yaml` не прочитать. Скилл помечен как не вызываемый моделью самостоятельно, поэтому его запускают командой `/looper`.
Как отключить. Удалите папку `~/.claude/skills/looper` и файл `~/.claude/commands/looper.md`. Ранее созданные циклы лежат в папках, которые вы указали при запуске, и остаются на месте.
Частые вопросы
Как установить Looper в Claude Code?
На macOS и Linux выполните `curl -fsSL https://raw.githubusercontent.com/ksimback/looper/main/install.sh | bash`, на Windows есть `install.ps1`. Скрипт клонирует репозиторий в `~/.claude/skills/looper` и копирует команду в `~/.claude/commands`. Ручной вариант — два шага с `git clone` и `cp`.
Чем Looper отличается от встроенных /goal и /loop?
Они запускают работу: `/goal` держит цель сессии, `/loop` повторяет задачу по расписанию. Looper стоит перед ними и проектирует цикл, проверяет формулировку цели, типы проверок и стоп-условия, а потом выдает спецификацию, которую запускает любой из них.
Как использовать готовые шаблоны?
Укажите имя после `--template`, например `/looper my-review --template code-review`. В шаблоне остается несколько полей `{{PLACEHOLDER}}`, мастер спрашивает только про них и все равно проводит полную критику, проверку приватности и показ схемы.
Что уходит другой модели при использовании совета рецензентов?
Контекст проекта передается в CLI выбранной модели. Looper показывает, что уйдет, какие глобы скрытия применены, и спрашивает согласие до первой отправки. Если важно ничего не отдавать наружу, используйте локальную модель через ollama.
Можно ли проверять файл loop.yaml в CI?
Да, команда `python scripts/looper.py lint path/to/loop.yaml` проверяет его на антипаттерны: циклы без программной проверки, судью из того же семейства, что главная модель, незаявленную отправку данных вендору и пропущенные пределы. Ошибки дают код выхода 1, предупреждения при `--strict` тоже.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыLoopy
Loopy (Loop Library)
Скилл и библиотека готовых циклов работы агента: найти, разобрать, починить, собрать и запустить повторяемый воркфлоу
Скилл от Anthropic для Claude Code: проверяет мультиагентную систему и по замерам сводит подагентов к одному циклу со скиллами.
Локальный control plane для долгих задач агентов: цели, решения и статус сохраняются между сессиями Codex и Claude Code
33 боевых скилла и минимальный каркас .claude для любого агента. Установка скриптом, npx skills или клонированием
Скиллы для перекрестной работы Claude Code и Codex: один агент готовит план, второй его разбирает, затем идет сборка и независимая проверка кода
Один агент запускает других в фоне: Claude Code, Codex, Copilot CLI, Grok Build и Pi, с выбором модели под каждый этап.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Looper — проектирование циклов агента (эта карточка) | нет | 713 | ||
| Ralph Orchestrator | нет | не нужна | 3 194 | прогоняет агентов по циклу до готовности задачи, схему цикла вы пишете сами |
| Zeroshot | нет | 2 116 | запускает граф исполнителя и независимых проверяющих, схему которого вы описываете сами |
Коротко о README
Сравнительная таблица показывает, где Looper стоит рядом со встроенными `/goal`, `/loop` и `/schedule`: те исполняют, он проектирует. Раздел о здоровом цикле перечисляет цель, контекст, действия, обратную связь, состояние и условия остановки. Схема примера разбирает план, ворота плана, поставку и ворота поставки.
Бейдж для README
Исходный SKILL.md
--- name: looper description: > Scaffold a well-designed agent loop with best-practice coaching and a cross-model review council. Use when the user wants to design, build, or set up an agent loop, iterative agent workflow, self-review loop, LLM-as-judge loop, multi-model council, reviewer/judge gate, or /goal-style looping process. Start from a named pattern template (security-scan, code-review, bug-hunt, docs-sync, research-synthesis) or from a blank interview. Guide goal refinement, typed verification criteria, reviewer and judge selection, privacy boundaries, termination guards, no-progress stops, and lightweight observability, then emit a RUN_IN_SESSION.md handoff prompt plus portable loop.yaml, loop.resolved.json, LOOP.md, and run-loop.py. disable-model-invocation: true argument-hint: "[target-dir] [--template <name>]" allowed-tools: Read, Write, Bash --- # Looper Use Looper as a loop design coach and scaffolder. During design, interview, critique, validate, and write files. After emission, offer to run the loop in the current session using `RUN_IN_SESSION.md`; keep `run-loop.py` as the advanced external runner. ## Workflow 1. Resolve the target path and optional `--template <name>` from the `/looper` arguments. If no target is given, use `./looper-output`. If the target contains an existing `loop.yaml`, treat the task as an edit/resume instead of a fresh scaffold. If a template was requested, follow Template Mode below instead of the blank-slate interview in step 3. 2. Load the relevant rubric only when entering that stage: - Goal stage: `references/goal-rubric.md`. - Verification stage: `references/verification-rubric.md`. - Council stage: `references/council-rubric.md`. - Control stage: `references/control-rubric.md`. - Model detection or privacy details: `references/model-detection.md`. 3. Interview in seven stages: goal, verification, host model, council, gates/control, confirmation flow preview, emit/run option. In the control stage, cover execution boundary, isolation, no-progress signals, state, and run logging. 4. Critique each stage before accepting it. Prefer concrete alternatives over vague warnings. Push weak goals toward outcome, scope, context, and done state. Push weak verification toward programmatic checks first, then judge rubrics, then human signoff. 5. Keep reviewer and judge roles distinct. A reviewer writes notes. A judge returns a structured verdict. `revise_until_clean` must name a judge member or `human` as `verdict_source`. 6. Require multiple termination guards: `max_iterations`, a revision cap on each gate, a no-progress stop, and either a budget cap or an explicit human stop point. 7. Before any cross-vendor council member is selected, state what context will leave the user's machine, which CLI receives it, which redaction globs apply, and that both execution paths require first-send consent.