CC segment
Сегменты Vovk.ts в деталях (`base` уже охватывает один корневой сегмент и его `route.ts`) — единица нарезки бэкенда в проекте Vovk. Используйте, когда пользователь говорит о разделении бэкенда на части, путях API, маршрутах «catch-all», `route.ts`, `initSegment`, времени выполнения / `maxDuration` для каждого сегмента, статических API (спецификации OpenAPI, исторические наборы данных), статического экспорта (`output: 'export'`), `generateStaticParams` или CLI `vovk new segment`. Триггеры на фразы вроде «разделить мой бэкенд», «добавить срез API», «сделать статический конечный пункт OpenAPI», «отделить админский API», «предварительно отрисовать API во время сборки», «мне нужно пространство имен `/api/foo`», «добавить корневой / именованный / статический сегмент». НЕ охватывает сами процедуры/обработчики → передать навыку `procedure` для всего внутри контроллера. НЕ охватывает создание OpenAPI, кроме подключения `openAPIObject` для каждого сегмента → передать навыку `openapi`. НЕ охватывает механику маршрутизации multitenant (поддомены, прокси `multitenant()`, фронтенд-страницы для каждого клиента) → передать навыку `multitenant`.
машинный переводПоказать оригиналСкрыть оригинал«Vovk.ts segments in depth (`base` already covers the one root segment…»
Vovk.ts segments in depth (`base` already covers the one root segment and its `route.ts`) — the unit of backend slicing in a Vovk project. Use whenever the user talks about splitting a backend into parts, API paths, catch-all routes, `route.ts`, `initSegment`, per-segment runtime/maxDuration, static APIs (OpenAPI specs, historical datasets), static export (`output: 'export'`), `generateStaticParams`, or the `vovk new segment` CLI. Triggers on phrasings like "split my backend", "add an API slice", "make a static OpenAPI endpoint", "separate admin API", "pre-render API at build time", "I need a `/api/foo` namespace", "add a root/named/static segment". Does NOT cover procedures/handlers themselves — hand off to the `procedure` skill for anything inside a controller. Does NOT cover OpenAPI authoring beyond wiring per-segment `openAPIObject` — hand off to the `openapi` skill. Does NOT cover multi-tenant routing mechanics (subdomains, `multitenant()` proxy, per-tenant frontend pages) — hand off to the `multitenant` skill.
Скилл учит ИИ различать сегменты Vovk.ts — слой разделения бэкенда на части с отдельными `route.ts`, runtime и статикой. Срабатывает на просьбы вроде «раздели API на `/admin` и `/public`» или «сделай OpenAPI статичным». В описании перечислены триггеры и примеры кейсов, но самого инструмента нет: ни файла с логикой, ни примеров конфига. Описание обрезано и не объясняет, как именно ИИ должен помогать — генерировать структуру, писать `initSegment`, или просто подсказывать синтаксис. Без конкретных шаблонов или рабочего примера скилл остаётся справочником вместо инструмента.
Для проекта Vovk полезно, если вы уже знаете, что такое сегменты. Если нет — скилл не научит. Ставить имеет смысл только если ИИ у вас уже работает с Vovk и нужно просто уточнить область применения.
Сегменты Vovk.ts в деталях (base уже охватывает один корневой сегмент и его route.ts) — единица нарезки бэкенда в проекте Vovk. Используйте, когда…
Как процесс C 53/100 · Есть пробелы — слабые места: результат и критерий готовности, входы и предусловия, повторный запуск
Как улучшить
- Сократите description до 1024 символов.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 1. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 1031 символов, лимит 1024
Процессный рейтинг: все десять параметров 53/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 7, без проверки текущего состояния
- 60Инструменты и файлы. Используются инструменты (bash, node), но во frontmatter они не объявлены
- 60Ошибки и развилки. Развилок: 2
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 85Шаги. Шагов: 25, расплывчатых формулировок: 3
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 2973 токенов
- low Разделов верхнего уровня: 10. Похоже на несколько доменов в одном скилле
- low Ответ описан самодельной разметкой (9 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1031: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 7 примера фраз-триггеров в кавычках
- +4Структура: 23 заголовков
- +3Пошаговые инструкции: 25 пунктов
- +4Есть примеры (9 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 61.