Скиллы цикла: brief, feature, accept, release
Какие скиллы ведут цикл от брифа до релиза и когда агент вызывает каждый.
Скиллы цикла превращают обсуждение фичи в бриф, реализацию, приёмку и выпуск. Скилл — это текст, который учит агента порядку работы: что делать по шагам, где остановиться и спросить вас, а где идти дальше без вопросов. Журнал и политика проекта остаются главными: если политика требует больше, чем скилл, агент делает то, что требует политика.
Четыре этапа цикла
Путь от идеи до пользователей состоит из четырёх этапов. У каждого свой результат, а человек вмешивается в немногих местах: подтверждает намерение, отвечает на открытые вопросы архитектора и сам выкатывает.
| Этап | Что происходит | Результат | Где вы решаете |
|---|---|---|---|
| Бриф | Из обсуждения собирается короткое описание фичи: цель, что входит и не входит, критерии готовности | Фича с карточкой в облаке, критерии на доске | Вы говорите «ок» или правите |
| Реализация | Фича делится на 1–3 задачи, исполнитель их делает и сдаёт отчёты | Задачи в статусе «отчёт сдан — не проверено» | Без остановок |
| Приёмка | Отдельный проверяющий читает отчёт, смотрит изменения и сам гоняет проверки | Задачи «проверено и принято» | Без остановок, вердикт записан в журнал |
| Выпуск | Вы выкатываете принятое, агент записывает выпуск в журнал | Карточки «Выпущено», сообщение в Telegram, запись в ленте | Выкатываете вы, агент записывает |
Скилл feature ведёт этапы целиком, по шагам ниже. В пакет actari-mcp входят два скилла: actari (протокол журнала) и feature. Бриф, приёмка и выпуск в нём — этапы одного скилла, а не отдельные команды. Если вашей команде удобнее разнести их по отдельным чатам и командам, это можно сделать собственными скиллами поверх тех же инструментов: порядок и результаты те же.
Скилл actari: протокол журнала
Включается, когда работа записывается в журнал. Он рассказывает агенту:
- Сначала зарегистрировать проект (
resolve_project, затемregister_project): без этого журнал отказывает. - Задачу от человека вести через
draft_task,delegate,submit_report,accept. - Фичу из обсуждения публиковать через
publish_intent, а работу из облака брать черезinboxиtake. - Читать
get_policyперед первой задачей и помнить, чтоREPORTED— это заявка исполнителя, а не готовность.
Скилл feature: одна фича от начала до выкатки
Запускается фразой «Сделай через actari: добавить выгрузку отчёта в CSV» (на русском или английском, агент отвечает на вашем языке) или «Возьми из actari», если вы завели фичу в облаке. Слова «выкатил» или «shipped» запускают последний шаг. В Claude Code скилл называется actari:feature.
1. Проект. Агент находит или регистрирует проект по папке репозитория.
2. Намерение — единственная остановка до приёмки. Агент показывает несколько строк: что делаем, чего не делаем и 3–5 критериев готовности, каждый из которых проверяется командой или видимым результатом, а не словами «работает хорошо». Вы отвечаете «ок» или правите. После этого агент записывает намерение заметкой intent: <slug> и публикует его в облако вызовом publish_intent. Если облако недоступно, агент не останавливается, а работает локально и скажет об этом в итоге.
3. Из облака. Если вы завели фичу в облаке, агент берёт намерение вызовом inbox и take, а шаг 2 пропускает: вы уже всё написали.
4. Архитектура. Если пространство ведёт карту системы, агент вызывает architecture_review и учитывает действующие решения. Открытые вопросы архитектора — вторая и последняя остановка: агент не нарезает задачи, пока вы на них не ответили.
5. Задачи. Фича режется на 1–3 задачи, которые можно проверить по отдельности. Для каждой: поиск похожих (search_precedents), draft_task, delegate исполнителю (по умолчанию субагенту), работа, submit_report с доказательствами, запись расхода токенов (log_usage). Решение, которое дорого отменить (модель данных, библиотека, протокол), записывается отдельным ADR вызовом record_artifact с видом adr.
6. Приёмка. Работу автора проверяет другой: субагент без контекста автора, а если субагентов нет, вы. Подробности — на странице Приёмка. Принятое подтверждается вызовом accept с доказательством, а второй возврат или провал на одной задаче агент выносит к вам.
7. Документация. Фича, которая меняет видимое поведение, правит свои страницы документации и карточку «Возможностей», если она названа в брифе. Невидимое изменение этого шага не требует.
8. Итог. Агент коротко пишет: что готово, кто и какими командами это проверил, сколько токенов ушло, что осталось (каждая находка становится черновиком задачи, чтобы не потеряться) и где смотреть фичу. На этом он останавливается: пушить и выкатывать — решение человека.
9. Выпуск. Когда вы говорите «выкатил», агент записывает выпуск вызовом record_release с названием и фразой «что нового» для каждого пункта, затем вызывает sync, и облако рассылает уведомление. См. Выпуски.
Чем скилл не является
Скилл не заменяет политику: «что считать отчётом» и «когда можно принимать» задаёт проект. И он не гарантирует выполнение: это инструкция агенту, а гарантией служит сервер, который проверяет переходы статусов и требования политики.
Что дальше
- Какие правила можно задать: Политика проекта.
- Как установить скиллы: Установка.
- Как работает карточка фичи в облаке: Фича и намерение.