Skill Orchestrator

Использование скиллов

Если есть хотя бы 1% шанс что скилл применим к тому что ты делаешь — ты ОБЯЗАН его вызвать.

ЕСЛИ СКИЛЛ ПРИМЕНИМ К ЗАДАЧЕ — У ТЕБЯ НЕТ ВЫБОРА. ТЫ ОБЯЗАН ЕГО ИСПОЛЬЗОВАТЬ.

Это не обсуждается. Это не опционально. Ты не можешь рационализировать отказ от этого.

Приоритет инструкций

Скиллы переопределяют поведение по умолчанию, но инструкции пользователя всегда в приоритете:

1. Явные инструкции пользователя (CLAUDE.md, прямые запросы) — высший приоритет
2. Скиллы — переопределяют поведение по умолчанию там где конфликтуют
3. Поведение по умолчанию — низший приоритет

Правило

Вызывай подходящие скиллы ДО любого ответа или действия. Даже 1% шанс что скилл может быть применим означает что нужно его вызвать. Если вызванный скилл оказался неподходящим — можно не следовать ему.

См. [references/skill-flow.md](references/skill-flow.md)

Карта скиллов проекта

Базовый набор шаблонных скиллов:

| Ситуация | Скилл | |----------|-------| | Пользователь описывает идею / хочет что-то создать или изменить | brainstorming | | Есть спек или чёткие требования для многошагового задания | writing-plans | | Есть готовый план для выполнения | executing-plans | | Любая ошибка, неожиданное поведение, баг | systematic-debugging | | Собираешься заявить что что-то готово / работает / исправлено | verification-before-completion | | Написать тесты для нового функционала | unit-test-writer | | Ревью изменений на качество и безопасность | code-review | | Подготовить коммит + описание изменений для MR/QA | commit-and-changes-writer | | Написать только сообщение коммита (без описания MR) | commit-writer | | Обновить или почистить CLAUDE.md | update-claude-md | | Подготовить промпт для перехода к следующему этапу в новом чате | next-stage-prompt | | Вопрос, объяснение, консультация — без создания или изменения чего-либо | скилл не нужен, отвечай напрямую |

> Проектные скиллы (специфичные для конкретного стека/инфраструктуры этого проекта) добавляй в эту таблицу отдельной строкой.

Обязательный порядок работы над фичей

brainstorming → [спек сохранён в docs/specs/] → writing-plans → executing-plans (с вызовом скилла unit-test-writer для написания тестов и скилла code-review для ревью)

1. Спек обязателен. brainstorming ВСЕГДА завершается записью спека в docs/specs/YYYY-MM-DD--design.md и одобрением пользователя. Переход к writing-plans без спека — запрещён.

1. Тесты — только через unit-test-writer. Никогда не пиши тесты вручную. После реализации кода вызывай скилл unit-test-writer через Agent tool (subagent_type не указывай — general-purpose справится). Передавай полный контекст: какой файл изменён, что нужно покрыть.

1. Ревью — только через code-review. После завершения реализации (включая тесты) вызывай скилл code-review через Agent tool.

1. Порядок нарушать нельзя. Нельзя пропускать шаги даже если задача кажется простой. Исключение: однострочные правки без логики (опечатки, переименование, правка конфига) — для них brainstorming и writing-plans не нужны, достаточно сразу executing-plans или прямого редактирования.

Приоритет скиллов

Когда могут применяться несколько скиллов:

1. Сначала процессные скиллы (brainstorming, systematic-debugging) — определяют КАК подходить к задаче
2. Потом скиллы реализации (writing-plans, executing-plans, проектные скиллы) — направляют выполнение

Примеры:

• «Хочу добавить новый эндпоинт» → brainstorming → спек → writing-plans → executing-plans (использует unit-test-writer + code-review)
• «Это не работает» → systematic-debugging
• «Напиши тесты для нового обработчика» → unit-test-writer

Типы скиллов

Жёсткие (systematic-debugging, verification-before-completion): следуй точно. Не адаптируй дисциплину.

Гибкие (brainstorming, writing-plans): адаптируй принципы к контексту.

Сам скилл указывает к какому типу относится.

Красные флаги

Эти мысли означают СТОП — ты рационализируешь:

| Мысль | Реальность | |-------|------------| | «Это просто вопрос» | Вопросы — это задачи. Проверь скиллы. | | «Нужно сначала больше контекста» | Проверка скиллов идёт ДО уточняющих вопросов. | | «Давай быстро гляну файлы» | Скиллы говорят КАК исследовать. Сначала проверь. | | «Это не требует формального скилла» | Если скилл существует — используй его. | | «Помню этот скилл» | Скиллы меняются. Прочитай актуальную версию. | | «Сделаю эту одну вещь сначала» | Проверяй ДО любого действия. | | «Скилл избыточен здесь» | Простые вещи усложняются. Используй его. |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: megamott
• Source: megamott/vibe-skills
• License: MIT

Install and usage instructions live in the source repository linked above.