Analyst runs before Coder: records each task in analytics/*.md (appending journal entries and revising only affected sections), updates README where necessary, and reports ANALYST_DONE. Orchestrator flow updated: task -> Analyst -> Coder -> Reviewer/Tester -> deploy -> report.
3.5 KiB
3.5 KiB
Агентская команда opencode
Одна сессия opencode в роли Orchestrator и четыре субагента — Analyst, Coder, Reviewer, Tester, которых Orchestrator вызывает через Task tool. Роли лежат в .opencode/agent/, Orchestrator назначен агентом по умолчанию в opencode.json.
Запуск и работа
В корне репозитория запусти opencode. Каждая новая сессия стартует Orchestrator'ом: задачу пиши обычным сообщением. Он сам:
- декомпозирует задачу и сначала отправляет её Analyst'у (фиксирует в
analytics/*.md), затем Coder'у через Task tool; - после Coder'а запускает Reviewer (только чтение) и Tester (проверка без правок) параллельно;
- возвращает Coder'у actionable findings; при существенном изменении скоупа перед follow-up просит Analyst'а дополнить аналитику (журнал), повторяет цикл, пока Critical/Major не закрыты;
- когда Critical/Major закрыты и проверки зелёные — без вопроса деплоит на тестовый сервис (
docker compose up -d --build, затемcurl http://localhost:8080/api/health); - отдаёт финальный отчёт уже после деплоя: что написано, просмотрено и протестировано, оставшиеся риски и просьба проверить в браузере с очисткой кэша (Ctrl+Shift+R).
Вручную писать субагентам не нужно — их вызывает только Orchestrator.
Роли
- Orchestrator (primary, агент по умолчанию) — единственный общается с пользователем; сам код не правит.
- Analyst (subagent) — перед Coder'ом фиксирует задание в
analytics/*.md, дополняет его по ходу работы (правки только затронутых секций, документ целиком не переписывается), при необходимости актуализируетREADME.md; отчитываетсяANALYST_DONE. - Coder (subagent) — единственный меняет код продукта; отчитывается
CODER_DONE. - Reviewer (subagent,
edit: deny) — read-only review; отчитываетсяREVIEW_DONE. - Tester (subagent,
edit: deny) — прогоняет проверки; может создавать игнорируемые артефакты, но не меняет отслеживаемые файлы; отчитываетсяTEST_DONE.
Файлы
.opencode/agent/{orchestrator,analyst,coder,reviewer,tester}.md— определения агентов команды;analytics/— аналитика задач агентской команды (по одному файлу на задачу; конвенция вanalytics/README.md);opencode.json—default_agent: orchestrator.
Конфиг и агенты читаются при старте opencode: после изменений перезапусти сессию.