AI-Ortedos Knowledge Base

Шпаргалка по агентным скиллам

Полный разбор 6 ключевых скиллов для Antigravity CLI & OpenAI Codex: архитектура, плюсы, минусы, фишки и готовые команды.

1. Foreman (Прораб) 2. Review Loop 3. Learn 4. AST Index 5. Last30Days 6. Playwriter (Chrome)
01

Foreman — Режим прораба

Архитектура оркестрации

Один ведущий агент (прораб) держит в фокусе цель пользователя, декомпозирует шаги и придирчиво принимает результат. Всю «грязную» работу руками делает один выделенный исполнитель (субагент/sub-thread). Прораб сам код не пишет и в браузер не лезет.

Плюсы
  • Ноль «глухого телефона»: контекст и грабли копятся у одного исполнителя, а не размазываются по 5 агентам.
  • Экономия контекста прораба: тонны логов, трейсов и промежуточных спайков остаются в субагенте.
  • Экономия бюджета: сильный прораб (Gemini Pro / Claude Opus) направляет дешёвого быстрого исполнителя (Flash / Sonnet / GPT-4o-mini).
Минусы и риски
  • Избыточен для минутных задач (поправить одну строчку).
  • Требует жёсткого контроля: если прораб поверит исполнителю на слово без проверки — вся схема сыпется.
Ключевые фишки и правила
  • Не делать руками: Руками прораб только читает diff, смотрит отчёт/скриншот и валидирует приёмку.
  • Прямые цитаты в брифе: Требования пользователя («максимально похоже», «без оверинжиниринга») копируются в бриф дословно, без пересказа своими словами.
  • Preflight-чек: Первое действие исполнителя — проверка доступов, прав и путей, чтобы не упереться в ошибку через 2 часа.
Как активировать в диалоге:
Работай в режиме прораба (foreman). Твоя задача — распланировать миграцию каталога, а руками всё делает один субагент-исполнитель. Принимай работу только по diff и проверке в БД.
02

Subagent Review Loop

Автономное код-ревью

Паттерн независимого «адвоката дьявола». Порождает изолированного субагента-ревьюера с чистым контекстом. Он разносит предложенный план или diff в пух и прах. Основной агент готовит исправления, и цикл крутится до получения бинарного вердикта: fully approved.

Плюсы
  • Чистый взгляд: ревьюер не видел твоих сомнений и оправданий, он видит только голый код/план.
  • Защита от лени: скилл запрещает принимать отмазки вроде «вроде норм» или «looks reasonable».
  • Устранение галлюцинаций: ловит забытые краевые случаи, регрессии и оверинжиниринг.
Минусы и риски
  • Жрёт токены на повторных итерациях обсуждения.
  • Ревьюер может быть излишне дотошным и требовать идеальности там, где нужен быстрый прототип.
Ключевые фишки
  • Бинарный гейт приёмки: Только fully approved или not approved со списком критичных блокеров.
  • Разделение проблем: Стилевые придирки и «nice-to-have» отсекаются, внимание только на баги, утечки и нарушение требований.
  • Один и тот же ревьюер: На все раунды ревью сохраняется один агент, пока цикл не завершён.
Как активировать:
Перед тем как коммитить этот класс, прогони его через subagent-review-loop. Пусть субагент докопается до ORM-запросов и транзакций.
03

Learn — Упаковка опыта сессии

Самообучение и память

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

Плюсы
  • Грабли больше не повторяются: обнаруженные баги инфраструктуры сразу становятся правилом.
  • Умеет парсить транскрипты компактных сессий (достаёт правду из логов transcript.jsonl).
  • Делит опыт на твердые правила (firm) и временные гипотезы (provisional).
Минусы и риски
  • Один успешный кейс — ещё не универсальный паттерн. Нельзя превращать любую мелочь в глобальное правило.
Ключевые фишки
  • Reconstruct the ideal path: агент пишет инструкцию так, будто всё получилось с первой попытки без мусора.
  • Target selection: автоматически выбирает, куда записать опыт: в глобальный AGENTS.md, локальный проект или новый скилл.
Как активировать:
/learn
(или: "Упакуй опыт этой сессии настройки сервиса через скилл learn в AGENTS.md")
04

ast-index — Молниеносный AST-поиск

Навигация по коду

Быстрый бинарный инструмент на Rust для семантического поиска по синтаксическому дереву (AST) 30 языков программирования (TypeScript, Python, Go, Rust, Java, Kotlin и др.). В 100–260 раз быстрее, чем перебор тысяч файлов через grep.

Плюсы
  • Точный семантический поиск: ищет объявления классов, функций, методов и интерфейсов, а не совпадения букв в комментариях.
  • Граф вызовов и зависимостей: мгновенно показывает, кто импортирует модуль и где вызывается символ.
  • Экономия токенов: агент запрашивает конкретный узел дерева вместо чтения файла целиком.
Минусы и риски
  • Требует фонового индекса базы при первом старте (ast-index update).
  • Идеален для JS/TS/Python/Go/Rust. Старый монолитный PHP без типов индексируется базово.
Полезные команды терминала
  • ast-index search "ClassName" — универсальный поиск сущности
  • ast-index usages "functionName" — найти все места вызова функции
  • ast-index refs "Symbol" — получить перекрёстные ссылки (def, imports, usages)
  • ast-index hierarchy "BaseClass" — построить дерево наследования классов
05

last30days — Разведка обсуждений за 30 дней

Актуальный ресерч

Скилл для среза реального пользовательского опыта за последний месяц. Агрегирует посты, баги, жалобы и обсуждения с Reddit, X (Twitter), YouTube, GitHub Issues и Hacker News в одну емкую выжимку.

Плюсы
  • Свежие данные здесь и сейчас: LLM знает информацию только до даты обучения, а этот скилл дает сводку за ноябрь 2026.
  • Честный фидбек людей: показывает реальные грабли новых версий библиотек, которые ещё не описаны в статьях.
  • Сводка в один экран: выжимка со ссылками на первоисточники без серфинга вручную.
Минусы и риски
  • Зависит от доступности публичных эндпоинтов соцсетей и API.
Сценарии применения
  • «Что люди говорят про свежий релиз Next.js / Laravel / Bitrix за последние 30 дней?»
  • «На какие баги жалуются пользователи новой версии Playwright в ноябре 2026?»
  • «Какое лучшее решение для локального STT обсуждают на Reddit прямо сейчас?»
Пример запуска:
Используй скилл last30days: узнай, какие основные баги и грабли обсуждают по Bun 1.2 за последние 30 дней.
06

playwriter.dev — Твой реальный Chrome

Браузерная автоматизация

Связка, которая позволяет агенту управлять твоим запущенным Google Chrome через Playwright API. Все твои сохранённые куки, авторизации в админках, расширения и сессии остаются на месте. Никакого "пустого" headless-браузера!

Плюсы
  • Обход капчи и Cloudflare: запросы идут из реального браузера с твоим фингерпринтом и куками.
  • Уже залогинен: не нужно скармливать агенту пароли от Битрикс-админки, Gitea или Telegram Web.
  • Изоляция сессий: вкладки группируются в именованные Tab Groups (--tab-group dev), не мешая твоей работе.
Минусы и риски
  • Требует запущенного расширения Playwriter Relay в твоем браузере.
  • Нельзя запускать от пользователя root (у нас действует строгое правило запуска от ortedos).
Шпаргалка команд CLI
  • playwriter session new --tab-group bitrix — создать изолированную сессию (вернет ID, напр. 1)
  • playwriter -s 1 -e "state.page = await context.newPage(); await state.page.goto('https://artron.ru/bitrix/admin/')" — открыть вкладку
  • playwriter -s 1 -e "console.log(await state.page.title())" — прочитать данные страницы
  • playwriter session list — посмотреть активные сессии и вкладки
Важно: Всегда передавай ID сессии через -s <id>, чтобы агент не перезаписывал чужие переменные в state.