Создание собственных
агентов, скилов и команд

Модуль 5 — Agents, Skills, Commands в opencode 60% практика

Программа обучения системных аналитиков работе с ИИ-агентами
Документация: Agents · Skills · Commands

От пользователя к создателю

💬

Пользователь чата

Задаёт вопросы в свободной форме. Результат зависит от формулировки

→

🛠️

Аналитик с агентом

Пишет структурированные инструкции. Знает промпт-инжиниринг и верификацию

→

⚙️

Создатель агентов

Конфигурирует агентов под проект и задачу. Стандартизирует работу команды

Создатель агентов — это аналитик, который масштабирует свой опыт:
один раз настроил → вся команда использует

Три уровня зрелости в работе с ИИ. Первый — пользователь чата. Все начинали с этого. Результат непредсказуем. Второй — аналитик с агентом. Это то, чему мы учились в модулях 0-4. Структурированные инструкции, контекст-задача-ограничения-критерии, верификация результатов. Третий — создатель агентов. Это сегодняшний модуль. Вы не просто используете агента — вы конфигурируете его под свой проект. Один раз настроили — и коллеги тоже пользуются. Это масштабирование экспертизы. Вы вложили в агента знание проекта, стандарты команды, типичные задачи — и он работает по этим правилам для всех.

Agents — специализированные ассистенты

🏗️ Primary

Основные агенты — переключение по Tab.

Встроенные: Build (все инструменты) и Plan (только анализ).

🔧 Subagent

Вызываются через @имя или автоматически.

Встроенные: General (мультизадачный) и Explore (только чтение).

📄 Конфигурация

Markdown-файл в .opencode/agents/:

frontmatter (description, mode, model, tools, permissions) + промпт

 .opencode/agents/review.md
---description: Ревью кода на безопасность и качествоmode: subagenttools:
  write: falseedit: false---

Ты — код-ревьюер. Анализируй код, не изменяй.
Фокус: безопасность, производительность, читаемость.

Agents — главный механизм. Два типа. Primary — основные агенты, переключаетесь Tab. Build и Plan — встроенные. Subagent — специализированные, вызываются через @имя в чате. General и Explore — встроенные. Конфигурация — обычный markdown-файл. Кладёте в .opencode/agents/ в проекте. Frontmatter — это YAML-шапка: описание, тип, модель, какие инструменты доступны. После шапки — промпт, системная инструкция для агента. Вот пример: агент-ревьюер. Subagent, без права на запись, фокус на безопасности. Вызов: @review в чате — и он анализирует код, не изменяя его.

Skills — переиспользуемые инструкции

Что это: набор инструкций, которые агент подгружает по ситуации

Где хранить: .opencode/skills/имя/SKILL.md

Как работает: агент видит список скиллов → загружает нужный через инструмент skill

Отличие от агента:
Агент = отдельная личность с контекстом
Skill = инструкция, которую любой агент может подгрузить

 .opencode/skills/req-template/SKILL.md
---name: req-templatedescription: Шаблон оформления требований---## Формат требования
- ID: REQ-NNN
- Описание: что система должна делать
- Приоритет: Высокий / Средний / Низкий
- Критерии приёмки: список проверок
- Связи: зависимости от других требований

## Правила
- Одно требование = одна функция
- Описание начинается с «Система должна...»
- Критерии приёмки — измеримые

Skills — второй механизм. Это не отдельный агент, а набор инструкций. Представьте: у вас в команде есть стандарт оформления требований. Или чеклист для API-ревью. Вы оформляете это как skill — и любой агент (Build, Plan, ваш кастомный) может его подгрузить. Хранятся в .opencode/skills/имя-скилла/SKILL.md. Обязательный frontmatter: name и description. Имя — строчные буквы, дефисы. SKILL.md — именно так, заглавными. Ключевое отличие от агента: агент — это «личность» с полным контекстом и настройками. Skill — это «справочник», который агент берёт с полки, когда нужно. Пример на слайде: шаблон оформления требований. Любой агент загрузит его, когда вы попросите «оформи требование по нашему стандарту».

Commands — шаблоны команд

Что это: пользовательская /команда с шаблоном промпта

Где хранить: .opencode/commands/имя.md

Аргументы:
$ARGUMENTS — всё после команды
$1, $2, $3 — позиционные

Спецвозможности:
!`git log -5` — вывод shell-команды
@src/file.cs — содержимое файла

 .opencode/commands/review-api.md
---description: Ревью API-контроллераagent: plan---

Сделай ревью API-контроллера $1:
- Коды ответов (все ли ошибки обработаны?)
- Naming (соответствие REST-конвенциям)
- Валидация входных данных
- Документация (XML-комментарии, Swagger)

Контекст проекта:
!`git log --oneline -5`

Вызов: /review-api WalletController

Commands — третий механизм. Самый простой. Это пользовательская слеш-команда с шаблоном промпта. Набираете /имя — и промпт отправляется. Хранятся в .opencode/commands/имя.md. Имя файла = имя команды. Три мощных возможности: Аргументы — $ARGUMENTS для всего текста после команды, $1 $2 $3 для позиционных. Shell output — обратные кавычки с восклицательным знаком. Вывод команды вставляется в промпт. File references — @путь/к/файлу. Содержимое файла подставляется в промпт. Пример: /review-api WalletController. $1 заменяется на WalletController, git log вставляет последние 5 коммитов для контекста, и агент Plan делает ревью. Обратите внимание: agent: plan — команда выполняется на Plan, без права на изменения.

Когда что использовать

	Agent	Skill	Command
Суть	Отдельная «личность» с контекстом	Инструкция, подгружаемая по ситуации	Шаблон промпта для быстрого вызова
Вызов	`Tab` или `@имя`	Автоматически агентом	`/имя`
Свой промпт	Да — системный	Да — инструкция	Да — шаблон с аргументами
Своя модель	Да	Нет	Да
Контроль инструментов	Да — tools, permissions	Нет	Через агента
Пример	Проектный онбордер	Шаблон требований	`/review-api`

Сравнительная таблица — когда что использовать. Agent — когда нужна отдельная роль с контекстом, своей моделью, правами на инструменты. Проектный онбордер, код-ревьюер, аналитик-документатор. Skill — когда нужна переиспользуемая инструкция, которую подгрузит любой агент. Шаблон требований, чеклист безопасности, стандарт именования. Command — когда нужен быстрый шаблон для повторяемого действия. /review-api, /check-migration, /generate-tests. Они не конкурируют, а дополняют друг друга. Один проект может использовать все три.

Практика 1: агент «Поздравлятор»

Шуточный агент для разминки — учимся создавать и вызывать

 .opencode/agents/congrats.md
---description: Генерирует креативные поздравления с днём рожденияmode: subagenttemperature: 0.9tools:
  write: falseedit: falsebash: false---

Ты — весёлый поздравлятор. Пользователь даёт имя и возраст.
Создай креативное, смешное поздравление с днём рождения.
Используй юмор, каламбуры и отсылки к возрасту.
Формат: стих или проза (выбирай сам, чередуй).

Вызов: @congrats Антон, 33 года

✓ temperature: 0.9 — высокая креативность · tools: все отключены — только генерация текста · mode: subagent — вызывается через @

Начнём с простого и весёлого. Создаём агента-поздравлятора. Цель — не поздравления, а навык создания агента: файл, frontmatter, промпт, вызов. Обратите внимание на ключевые настройки: temperature: 0.9 — максимальная креативность, потому что нам нужен юмор, а не точность. tools: всё false — агенту не нужны инструменты, он только генерирует текст. mode: subagent — вызывается через @congrats из любого агента. Создайте файл, перезапустите opencode, и попробуйте: @congrats Антон, 33 года. Если агент появился в автокомплите после @ — всё работает. Давайте сделаем это прямо сейчас. 5 минут.

Практика 2: проектный онбордер

Агент, который знает ваш проект и помогает в нём разобраться

 .opencode/agents/onboard.md
---description: Онбординг в проект — архитектура, аналитика, навигацияmode: subagenttools:
  write: falseedit: falsepermission:
  bash:
    "*": deny"git log*": allow"git diff*": allow---

Ты — проектный аналитик-онбордер для проекта [название].

## Контекст проекта
- Стек: [.NET 8 / Kotlin / ...]
- Архитектура: [Clean Architecture / Monolith / ...]
- Домен: [описание бизнес-домена]
- Ключевые сущности: [User, Order, Payment, ...]## Твоя задача
Помочь аналитику разобраться в проекте. Отвечай кратко.
Если не знаешь — так и скажи, не додумывай.

Теперь серьёзное задание. Проектный агент-онбордер. Идея: вы вкладываете в промпт знание о своём реальном рабочем проекте. Стек, архитектура, домен, ключевые сущности, известные проблемы. Агент становится «навигатором» по проекту для новичков и для вас самих. Обратите внимание на permissions: write и edit запрещены, bash — только git log и git diff. Агент может читать код и историю, но не может ничего изменить. Безопасно. Важная строчка в промпте: «Если не знаешь — так и скажи, не додумывай». Помните модуль 3.4 — галлюцинации? Мы закладываем защиту прямо в промпт агента. Шаблон на слайде — заполните квадратные скобки данными своего проекта.

Что вложить в проектного агента

Стек и версии — языки, фреймворки, БД, брокеры
Архитектура — монолит / микросервисы, слои, структура папок
Домен и терминология — глоссарий бизнес-терминов проекта
Ключевые сущности — основные модели и их связи
Интеграции — внешние API, очереди, партнёры
Известные проблемы — техдолг, архитектурные ограничения
Соглашения — стиль кода, naming, ветвление в git
Ссылки — Confluence, Jira-проект, Swagger URL

Не нужно описывать всё сразу — начните с 3-4 пунктов, итеративно дополняйте по мере использования

Чеклист — что вложить в промпт проектного агента. Не надо писать всё сразу. Начните с малого: Стек — чтобы агент понимал технологический контекст. Архитектура — чтобы знал, где искать бизнес-логику, а где — инфраструктуру. Домен — самое ценное. Глоссарий терминов. «Транш», «лимит», «конвертация» — что это значит в вашем проекте. Ключевые сущности — User, Order, Payment — и как они связаны. Остальное — по мере необходимости. Итеративно. Используйте агента неделю, заметьте, где он ошибается — и дополните промпт. Это живой документ, не высеченный в камне.

Практика

Создаём агентов и тестируем

🎉 Агент «Поздравлятор»

Создать .opencode/agents/congrats.md по шаблону. Вызвать @congrats с именем и возрастом. Проверить: агент появляется в автокомплите? Текст креативный?

⏱ 10 мин

📋 Проектный онбордер

Создать .opencode/agents/onboard.md для своего рабочего проекта. Заполнить контекст: стек, архитектура, домен, сущности. Задать 3 вопроса как новичок. Оценить качество ответов.

⏱ 25 мин

⚡ Команда /review-api

Создать .opencode/commands/review-api.md. Шаблон с $1 для имени контроллера. Протестировать на любом контроллере проекта.

⏱ 10 мин

📖 Skill для требований

Создать .opencode/skills/req-template/SKILL.md с шаблоном оформления требований вашей команды. Проверить: агент подгружает skill при работе с требованиями?

⏱ 15 мин

Четыре задания — час практики. Первое — поздравлятор. Разминка, 10 минут. Создаёте файл, перезапускаете opencode, вызываете @congrats. Если не появляется в автокомплите — проверьте путь к файлу и frontmatter. Второе — онбордер. Главное задание, 25 минут. Заполняете контекст своего проекта. Потом задаёте вопросы как новичок: «Где бизнес-логика?», «Какие есть интеграции?», «Как устроена обработка платежей?». Оцените — насколько ответы полезны новому аналитику? Третье — команда /review-api. 10 минут. Простой шаблон с аргументом. Четвёртое — skill с шаблоном требований. 15 минут. Оформите стандарт вашей команды. Приоритет: сначала 1 и 2, потом 3 и 4 если останется время.

Итоги Модуля 5

Agents: специализированные ассистенты — свой промпт, модель, инструменты, permissions
Skills: переиспользуемые инструкции — стандарты команды, шаблоны, чеклисты
Commands: шаблоны промптов /команда — аргументы, shell output, file refs
Проектный агент: вложите знание проекта → масштабируйте на команду

Далее → Модуль 6: Управление контекстом и сложные сценарии — контекстное окно, мультишаг, большие проекты

Четыре ключевых вывода: 1. Agents — полноценные специализированные ассистенты. Свой промпт, своя модель, свои права. 2. Skills — переиспользуемые инструкции для всей команды. Стандарты, шаблоны, чеклисты. 3. Commands — быстрые шаблоны для повторяемых действий. /review-api, /check-migration. 4. Проектный агент — самый ценный результат модуля. Вы вложили знание проекта в агента, и теперь любой аналитик команды может им пользоваться. В следующем модуле — управление контекстом. Как работать с большими проектами, когда код не помещается в контекстное окно агента. Мультишаговые задачи, чекпоинты.

Домашнее задание

Создать собственных агентов, скилы и команды для своего рабочего проекта

Агент-онбордер для своего проекта ⏱ 30 мин

Создать .opencode/agents/onboard.md с полным контекстом рабочего проекта. Протестировать: задать 5 вопросов как новичок в проекте. Доработать промпт по результатам — где агент ответил плохо.

Попросите коллегу задать вопросы вашему агенту — взгляд со стороны ценнее

Команда /review-api ⏱ 20 мин

Создать команду для ревью API-контроллера с аргументом $1. Добавить контекст проекта через !`git log` и @файл. Протестировать на 2 контроллерах — оценить качество ревью.

Попробуйте добавить agent: plan — ревью без изменений кода

Skill: стандарт оформления требований ⏱ 25 мин

Создать .opencode/skills/req-template/SKILL.md с шаблоном требований, принятым в вашей команде. Проверить: попросить агента «оформи требование по нашему стандарту» — подгрузился ли skill?

Если стандарта нет — отличный повод создать его вместе с агентом

Если рабочий проект недоступен — создайте онбордера для DigitalWallet

Три задания — все на рабочем проекте. Первое — агент-онбордер. Это главное задание. Создайте полноценного агента с контекстом вашего проекта. Протестируйте сами, а потом — дайте коллеге. Взгляд со стороны покажет, где контекст недостаточный. Доработайте промпт по результатам — это итеративный процесс. Второе — команда /review-api. Практический инструмент для ежедневной работы. Шаблон с аргументом, контекст из git log, ссылка на файл. Попробуйте agent: plan — чтобы ревью было безопасным, без изменений кода. Третье — skill с шаблоном требований. Если в команде есть стандарт — оформите его как skill. Если нет — это отличный повод создать. Попросите агента помочь: «создай шаблон требования для финтех-проекта с полями ID, описание, приоритет, критерии приёмки». Если рабочий проект недоступен — создайте онбордера для DigitalWallet. Контекст вы уже знаете из модулей 0-4.

Создание собственныхагентов, скилов и команд