oro-skills
oro-skills
oro-skills — Claude Code плагин-маркетплейс, предоставляющий каждому агенту Oro общий набор навыков (skills) и автоматизации (hooks). Всё, что описано в skill — это то, что агент будет делать. Пробелы в skills = пробелы в работе всех агентов.
Установка
oro-skills устанавливается на уровне проекта. Попросить любого агента с установленными навыками помочь с установкой:
/oro-skills:teach
Или вручную — плагин устанавливается в flat-структуре в .claude/plugins/.
Навыки (Skills)
Каждый навык вызывается через /oro-skills:<skill-name>. Навыки делятся на категории.
Доставка и код
| Навык | Вызов | Назначение |
|---|---|---|
| deliver | /oro-skills:deliver | Создаёт ветку, коммитит, пушит, открывает MR в GitLab, ждёт CI |
| reflect | /oro-skills:reflect | Анализирует завершённую работу, сохраняет learnings в memory |
Коммуникация
| Навык | Вызов | Назначение |
|---|---|---|
| report | /oro-skills:report <event> | Отправляет событие в Telegram (task_start, task_complete, etc.) |
| escalate | /oro-skills:escalate | Эскалация к Семёну через Telegram, когда заблокирован >20 мин |
| digest | /oro-skills:digest | Сводка завершённой работы в Telegram |
| talk | /oro-skills:talk | Отправляет сообщение другому агенту через AgentAPI |
Управление агентами
| Навык | Вызов | Назначение |
|---|---|---|
| discover | /oro-skills:discover | Находит работающие workspaces через Coder API |
| restart | /oro-skills:restart | Сохраняет состояние, пишет resume prompt, перезапускает сессию |
| teach | /oro-skills:teach | Помогает другому агенту установить плагины |
| learn | /oro-skills:learn | Запрашивает установку плагина от другого агента |
Исследование
| Навык | Вызов | Назначение |
|---|---|---|
| patrol | /oro-skills:patrol | Исследует best practices, предлагает улучшения (SWOT) |
| find-skills | /oro-skills:find-skills | Находит внешние навыки в открытой экосистеме |
Распространение
| Навык | Вызов | Назначение |
|---|---|---|
| propagate-plugins | /oro-skills:propagate-plugins | Обновляет навыки у всех агентов после push |
Хуки (Hooks)
Хуки — автоматические действия, выполняемые на определённые события Claude Code. Агент не вызывает их явно — они срабатывают сами.
SessionStart
Срабатывает при запуске сессии:
- Инициализация переменных окружения
- Автообновление плагинов (проверяет новые версии)
- Напоминание прочитать memory и resume prompt
PreToolUse
Срабатывает перед каждым вызовом инструмента:
- Защита
.claude/путей — блокирует Write/Edit на.claude/(Claude Code показывает confirmation prompt, блокирующий автономных агентов)
.claude/ всегда используй Bash с cat > или heredoc, а не Write/Edit. Это обходит confirmation prompt.PostToolUse
Срабатывает после каждого вызова инструмента:
- Проверка эскалации (каждые 5 минут без прогресса)
- Напоминание о delivery (незакоммиченные изменения)
- Напоминание о digest
PostCompact
Срабатывает при сжатии контекста (context compaction):
- Синхронизация (
oro project upload) - Напоминание перечитать CLAUDE.md
UserPromptSubmit
Срабатывает при получении сообщения от пользователя:
- Инжектирует operational state (время сессии, незакоммиченные файлы, непушенные коммиты)
Stop
Срабатывает перед остановкой:
- Проверяет незакоммиченные изменения
- Синхронизация состояния
- Семантическая оценка выполненной работы
StopFailure
Срабатывает при аварийной остановке (API crash):
- Отправляет alert в Telegram (только наблюдательный режим)
Жизненный цикл обновления
skill-manager обновляет skill
│
▼
bump version в plugin.json → push в main
│
▼
/oro-skills:propagate-plugins
│
▼
обновить локальный кэш → oro upload → уведомить агентов через AgentAPI
│
▼
Агенты получают обновление при следующем restart
Формат сообщений между агентами
Для навыка talk:
[From: <workspace> (<role>)] [Type: question|task|info|review-request]
<содержание сообщения>
Конвенции
- Коммуникация — уважительный, спокойный, честный тон
- Эскалация — после ~20 минут без прогресса и 2–3 неудачных подходов
- Git — staging конкретных файлов (никогда
git add .), никогда не коммитить секреты - Автономные агенты — пушат в main; шаблонные изменения через MR
Связанные документы
- Экосистема Oro — общая архитектура
- oro CLI — управление сессиями
- CLAUDE.md — структура файла инструкций