Три команды по три человека собирают рабочий ассистент поверх реальных данных
продуктов: ответ с цитатами, навигация по базе знаний, данные → вывод → график.
Скрин заполненной доски Miro или ВК с комментариями каждого участника, ТЗ команды,
репозиторий, smoke-тест ключа
2
23–29.11
Решают задачу: каркас, данные, рабочий прототип, метрики качества, отчёт.
Демо «вопрос → ответ с источником», отчёт с числами, PR в ветку
Защита
30.11
Демонстрация решения по шаблону, запись видео и презентация для итоговой аттестации.
Структура из 10 пунктов, порог 5 из 10 баллов
Структура защиты
Проблема и введение: суть задачи и её практический интерес.
Цель: одна чёткая формулировка.
Задачи: 2–3 шага к цели, коротко, глаголами.
Практическая значимость: где и как применить результат.
Ожидаемый эффект: что хотели получить и кому это полезно.
Стек: 2–3 ключевых инструмента или технологии.
Ход работы: основные этапы реализации.
Результаты: таблицы, графики, визуализации.
Выводы: 2–3 ключевых итога.
Перспективы: интеграция проекта или его компонентов.
Ритм
Задачи недели — в чат с дедлайном, например пятница 10:00.
Среда — онлайн-встреча: вопросы и предварительные результаты.
Понедельник — задачи следующего спринта и итоги прошлой недели.
Подтверждение встречи команды — скрин доски Miro или ВК.
Архитектура: SDD, скиллы и бандлы
Порядок один: описание задачи → умение агента (скилл) → набор умений (бандл) → агент.
Сначала фиксируем, что должно получиться, потом собираем умение, потом подключаем его к агенту.
Слой
Что это
Артефакт
Спецификация (SDD)
Задача, вход, выход и критерии приёмки. Без такого описания
агент сам придумывает объём работы.
описание задачи, критерий приёмки, метрика
Скилл
Одно умение с инструкцией и скриптами: как проверить, что исправить,
чем проверить результат.
SKILL.md + scripts/
Бандл
Набор скиллов под роль или этап, подключается целиком.
bundle.json
Агент
Исполнитель: читает описания скиллов и вызывает нужный, а не весь
код подряд.
сессия, контекст, лимит
spec.md ──▶ SKILL.md ──▶ bundle.json ──▶ агент
│ │ │
│ │ └── набор под роль: core / design / project
│ └── front-matter: name, version, inputs, outputs, commands
└── критерий приёмки: что считается «сделано»
Скилл
Скилл — папка с SKILL.md: шапка (имя, описание, версия, входы и выходы, команды),
инструкция и при необходимости скрипты и ассеты. Описание в шапке — это то, что видит агент,
когда решает, подключать скилл или нет.
Бандлы
Бандл
Для чего
Что внутри
core
Понять, записать, отчитаться
исследование, документ, разбор кода,
обсуждение, отчёт, журнал проекта
design
Макеты и прототипы
интерфейсные моки, правила настроек,
вектор, 3D
skl_project
Папки и документация
структура проекта, дистилляты,
журналы
skl_collector
Сбор данных
парсинг, скачивание, каталогизация
Зачем это на практике. Каждая задача — спецификация с критерием приёмки.
Скилл фиксирует повторяемый шаг, чтобы команда не пересказывала его заново. Бандл задаёт
минимальный набор инструментов под роль: меньше контекста — дешевле токены и понятнее проверка.
Чем работать: AI-клиенты
AI-клиенты делятся на три класса: чаты (ChatGPT, Claude Desktop) — хорошо объясняют, но не видят
репозиторий; плагины в IDE (Copilot, Continue, Cline) — видят файлы, но ограничены редактором;
терминальные агенты — читают проект, запускают команды и правят код. Для задач практики нужен третий
класс с возможностью подключить свой провайдер по baseURL: ключи у команды свои, а модель
должна работать в репозитории. Отсюда выбор — OpenCode: открытый, ставится локально, работает
с Desktop и CLI, понимает любой OpenAI-совместимый ключ, настраивается JSON-конфигом, поддерживает
плагины и MCP-серверы.
Решение: OpenCode. Один клиент на команду, один ключ, один конфиг в репозитории.
Дальше — установка за шесть шагов.
OpenCode: установка за шесть шагов
Два варианта: короткий путь и настройка для тех, кто уже работал с терминалом.
0 / 6
1
Скачать клиент
opencode.ai → Download for Windows
(или macOS / Linux). Два варианта: Desktop — окно с вкладками и диффами, CLI — работа в терминале.
Для практики подходит любой.
Кнопки скачивания: Desktop, Terminal (Install), Mobile
opencode.ai/console →
Get started → вход через GitHub или почту. Аккаунт нужен для ключей OpenCode, подписки Go
и истории расходов. Для практики достаточно бесплатного.
Консоль: регистрация, ключи, модели и цены за миллион токенов
3
Ключи: создать в консоли и добавить в клиент
В консоли: раздел с ключами → Create key → скопировать. Ключ показывается один раз,
второй раз посмотреть нельзя — только перевыпустить.
В клиенте ключ добавляется командой /connect (выбрать провайдера, вставить ключ)
или из терминала — opencode auth login. После подключения модель выбирается
командой /models.
Документация: /connect в TUI и opencode auth loginСвой провайдер: baseURL, env, модели
Ключ BMITECH на время практики. Команда получает один ключ и адрес
https://<BASE_URL>/v1. Он добавляется как свой провайдер: в opencode.json
описывается baseURL и модель, ключ берётся из переменной окружения. Второй путь —
/connect → Other → вставить адрес и ключ. Ключ живёт только в .env
и в git не попадает.
4
Прочитать про модели и расход токенов
Что почитать до первого большого прогона:
opencode.ai/docs/models
— модели, лимиты контекста, стоимость за миллион токенов, кэш промпта.
Models: выбор модели на сессию, дефолты, варианты, кэш
5
Дисклеймеры
Бесплатные модели требуют карту. У большинства провайдеров «free» включается только после
привязки банковской карты — проверка платёжеспособности. Карта может не списываться, но без неё
модель недоступна.
Многие модели и плагины ставятся глобально. Нужны Node.js 20+, права администратора и
корректный PATH. Без глобальной установки часть моделей, MCP-серверов и функций
не заработает.
Ключ — расходуемый ресурс. Лимит у команды один; утечка ключа — чужие траты и блокировка.
Ключ не попадает в git, чат, скриншоты и презентацию.
Бесплатные модели могут хранить запросы. Часть провайдеров использует переписку для обучения.
Персональные данные, медицинские сведения и сырые выгрузки продуктов туда не отправляем.
VPN и прокси ломают доступ. Провайдер может блокировать выходные узлы и менять лимиты без
предупреждения — на демо держите резервную модель (локальная Ollama).
Ответ модели — не факт. Цифры, цитаты и ссылки проверяются по источнику; поэтому в задачах
требуется ссылка на файл и строку.
6
Проверить, что всё работает
Клиент установлен.opencode --version печатает номер версии, а не «command not found».
Ключ принят. В клиенте /models показывает модель команды; при выборе нет ошибки
авторизации.
Ответ по делу. Запрос «какие файлы в этой папке?» — агент читает репозиторий и перечисляет
реальные файлы.
Ключ живой на уровне API. Ответ 200 и JSON с choices:
Отдельный бинарник — если нет Node.js: архив под платформу со страницы загрузки, распаковать и
положить в PATH.
2
Ключи из терминала и проверка авторизации
opencode auth login # интерактивный выбор провайдера
opencode auth login bmitech --method key # сразу ключ, без меню
opencode auth list # что подключено
Ключи хранятся в конфиге OpenCode, а не в репозитории. Для CI и скриптов удобнее переменные
окружения: BMITEH_API_KEY в .env, файл — в .gitignore.
3
Свой провайдер в opencode.json
Провайдер BMITECH описывается как OpenAI-совместимый. Ключ берётся из окружения, поэтому конфиг
можно коммитить.
Модель выбирается в сессии или указывается на запуск. Варианты одной модели — это разные режимы
(быстрый, глубокий, экономичный).
/models
opencode run --model bmitech/<MODEL> "собери список файлов"
opencode run --print-logs --model bmitech/<MODEL> "ping" # отладка
5
Экономия токенов
Держите неизменным начало запроса: кэш промпта дешевле обычного ввода.
Большие задачи — через субагента, чтобы контекст не рос в основной сессии.
Черновики и извлечение метаданных — на дешёвой модели, финальный разбор — на сильной.
Пишите расход в usage.jsonl и сверяйте с лимитом команды раз в неделю.
Компакция сессии вместо чтения всего репозитория заново.
Лимиты и стоимость модели — в карточке модели
6
Диагностика
Симптом
Что проверить
Model unavailable
ID модели и провайдер в /models; ключ в окружении
401 / 403
opencode auth list, срок ключа, лимит команды
Пустой ответ
--print-logs, доступность baseURL из сети
Долгий старт
Прокси, VPN, размер сессии
Расход выше плана
Кэш промпта, субагенты, дешёвая модель для рутины
opencode auth list
curl -s -o /dev/null -w "%{http_code}\n" https://<BASE_URL>/v1/models
Объявления
Защита 30.11
Демонстрация решения по шаблону: проблема, цель, задачи, значимость, эффект, стек, ход работы, результаты, выводы, перспективы. Запись видео и презентация сохраняются для итоговой аттестации.
2026-11-16 · Методист
OpenCode: установка за шесть шагов
Скачать, зарегистрироваться, добавить ключ, прочитать про модели, дисклеймеры, проверки — раздел «OpenCode» на этой странице. Ключ команды — у хранителя.
2026-11-16 · 01.lab
Задачи недели — в чат
Предварительные задачи присылаем в чат с дедлайном (пятница, 10:00). Онлайн-встреча с вопросами — среда. В понедельник — задачи следующего спринта.
2026-11-16 · BMITECH
Спринт 1: знакомство и инфраструктура
Встречаемся внутри команды: опыт, навыки, роли. Скрин доски Miro или ВК с комментариями каждого — подтверждение встречи. Дальше доступы, ключи, репозиторий и smoke-тест.