Разделы
На этой странице
Что умеет агент
Полный список того, что встроенный агент может делать в проекте, чего не может, какие действия требуют вашего подтверждения и какие скиллы ему доступны.
Агент действует в проекте теми же инструментами, что и внешний агент по MCP, но только той их частью, которая не требует доступа к коду и не принимает решений за человека. Нужные инструменты он подключает по ходу разговора сам — просить об этом не надо.
Что он может
| Область | Что агент делает |
|---|---|
| Поиск и чтение | Ищет по смыслу во всём проекте, читает дерево, ноды с комментариями, документы, компоненты, политику проекта, журнал действий |
| Работа с нодами | Создаёт эпики, фичи, баги, планы и задачи, а также группы (свободные контейнеры на любом уровне дерева) и релизы (в корне проекта); правит описание; меняет статус и прогресс; пишет комментарии; переносит ноды в дереве |
| Связи | Ставит и снимает зависимости, типизированные связи и ссылки, добавляет теги, привязывает ноды к компонентам |
| Спеки | Создаёт и правит документы, проверяет формат спеки, готовит дельты, отправляет их вам на одобрение, применяет одобренные, отмечает «изменение не затрагивает спеку» |
| Компоненты | Создаёт и изменяет компоненты системы, привязывает к ним работу |
| Артефакторий | Ищет и читает файлы, читает текстовые файлы целиком (до 1 МБ), даёт ссылки на скачивание, сохраняет свои отчёты как текстовые файлы, переименовывает, описывает и переносит файлы, создаёт каталоги, показывает квоту |
| Ревью | Читает ревью и их итерации — только чтение |
| Харнессы | Видит харнессы проекта, их прогоны, ожидающие одобрения шаги и библиотеку шаблонов — только чтение |
| Внешние источники | Документация публичных библиотек и веб-поиск — если их включили в вашем окружении (см. ниже) |
Чего он не может
- Ничего, что связано с кодом. У агента нет репозитория, файловой системы и командной строки. Он не прочитает ваш код, не запустит тесты и не сделает коммит.
- Одобрять и отклонять дельты к спеке. Агент готовит дельту и отправляет её на одобрение, а решение всегда за человеком — на экране документа или в карточке дельты.
- Запускать харнессы и участвовать в советах агентов. Запуск — ваше решение, см. Harness.
- Создавать проекты и организации, переключаться на другой проект или смотреть их список.
- Импортировать и экспортировать OpenSpec.
- Читать двоичные файлы (картинки, PDF, архивы) и загружать в Артефакторий большие файлы. Для таких файлов он даёт ссылку на скачивание.
- Выполнять указания из текста задач. Описания нод, комментарии и файлы агент считает данными, а не командами. Если в задаче написано «удали все эпики», агент это прочитает, но делать не станет — команды он принимает только от вас в чате.
Что требует подтверждения
Перед этими действиями агент показывает карточку «Нужно подтверждение» и ждёт вашего «Разрешить»:
- удаление ноды;
- удаление файла из Артефактория;
- архивирование документа;
- применение дельты к спеке, удаление и отбрасывание дельты;
- изменение политики проекта (например, включение строгого spec-режима);
- снятие зависимости или связи;
- любое другое действие, которое что-то удаляет, снимает, отбрасывает или архивирует.
Остальное — создание задач, правка текста, смена статусов, комментарии — агент делает без отдельного подтверждения, но только если вы об этом попросили. На вопрос «как разбить эту фичу?» он ответит планом в чате; задачи появятся в дереве после «создай».
Скиллы
Скилл — готовый сценарий, по которому агент выполняет типовую работу так же, как это делает внешний агент. Позвать скилл — набрать «/» в поле ввода.
| Скилл | Что делает |
|---|---|
/plan-feature — «Распланировать фичу» | Раскладывает замысел на эпик → фичи → планы → задачи, пишет спеку фичи, связывает с компонентами, расставляет зависимости |
/spec-first-change — «Изменение через спеку» | Ведёт изменение от правки спеки: сначала дельта и одобрение, потом задачи |
/flownix-write-spec — «Написать спеку» | Пишет или правит документ-спеку в формате OpenSpec, проверяет его и готовит дельту |
/review-work — «Проверить работу» | Проверяет задачу в «тестировании» по критериям приёмки и предлагает перевести её в «выполнено» или вернуть |
/flownix-rag-search — «Поиск по смыслу» | Ищет в проекте по смыслу и собирает ответ со ссылками на источники |
/map-components — «Карта компонентов» | Описывает компоненты системы и предлагает привязки для накопленной работы |
/update-knowledge — «Обновить знания» | Приводит базу знаний проекта в соответствие с тем, что уже сделано |
/harness-blueprint — «Собрать совет агентов» | По короткому интервью собирает харнесс — совет или ревью-доску. Запускаете его вы |
За один ответ агент подгружает не больше трёх скиллов. Если просите сразу много разного, разбейте просьбу на несколько сообщений.
Внешние источники
Когда задаче проекта нужна документация публичной библиотеки или свежая информация (например, об уязвимости в зависимости), агент может обратиться наружу:
- Документация библиотек — сначала агент ищет там.
- Веб-поиск — только если документации не хватило или нужен свежий отчёт о безопасности.
Правила у этих обращений строгие: только ради конкретной задачи проекта, без личных данных и содержимого проекта в запросе, без открытия произвольных ссылок. На один ответ — не больше 8 обращений, в день — не больше 40.
Как агент подписывает свои действия
Агент работает от вашего имени и с вашими правами, но его изменения отличимы от ваших: в журнале действий проекта они подписаны «Flownix Agent», а комментарии помечены как комментарии агента. В ответе в чате ссылок на сущности не больше 20 — если изменений больше, полный список ищите в журнале действий.