CC procedure
Процедуры Vovk.ts подробно (`base` уже имеет полный конечный пункт, валидацию, ошибки и коды состояния) — атомарная единица серверной логики в проекте Vovk. Используйте, когда пользователь просит создать ЧТО-ЛИБО, производящее или потребляющее данные на сервере — данные для загрузки страницы («страница пользователей», «панель управления», «список продуктов»), конечную точку, обработчик API, серверное действие, отправку формы, контроллер, валидацию с помощью Zod / Valibot / ArkType, форму запроса/ответа, загрузку файла, скачивание файла, обработку ошибок (`HttpException`, коды состояния), типы контента (JSON, multipart, text, binary), или вызов серверного кода из React Server Component / SSR / SSG / PPR / серверного действия. Триггеры на фразы вроде «создать страницу пользователей», «добавить конечную точку», «создать обработчик формы», «получить X с сервера», «обработать загрузку файла», «валидировать ввод», «выбросить 404», «серверное действие для Y», «контроллер для Z», «добавить парсинг `req.body`», «.fn()», «CORS». НЕ включает сегменты / `route.ts` / `initSegment` → передать навыку `segment`. НЕ включает генерацию RPC-клиента, fetcher, импорты `@/client` → передать навыку `rpc`. НЕ включает пользовательские декораторы, `createDecorator`, авторизацию / защитные экраны авторизации → передать навыку `decorators`. НЕ включает `deriveTools` / MCP / подключение AI-инструментов → передать навыку `tools`. НЕ включает потоковую передачу JSON Lines / генераторы / `JSONLinesResponder` → передать навыку `jsonlines`. НЕ включает метаданные `@operation` / документацию Scalar → передать навыку `openapi`.
машинный переводПоказать оригиналСкрыть оригинал«Vovk.ts procedures in depth (`base` already has a complete endpoint, v…»
Vovk.ts procedures in depth (`base` already has a complete endpoint, validation, errors and status codes) — atomic unit of server-side logic in Vovk project. Use whenever user asks to build ANYTHING producing or consuming data on server — page loading data ("users page", "dashboard", "product list"), endpoint, API handler, server action, form submission, controller, validation with Zod / Valibot / ArkType, request/response shape, file upload, file download, error handling (`HttpException`, status codes), content types (JSON, multipart, text, binary), or calling server code from React Server Component / SSR / SSG / PPR / server action. Triggers on phrasings like "build a users page", "add an endpoint", "create a form handler", "fetch X from the server", "handle file upload", "validate input", "throw a 404", "server action for Y", "controller for Z", "add `req.body` parsing", ".fn()", "CORS". Does NOT cover segments / `route.ts` / `initSegment` → hand off to `segment` skill. Does NOT cover RPC client generation, fetcher, `@/client` imports → hand off to `rpc` skill. Does NOT cover custom decorators, `createDecorator`, authorization / auth guards → hand off to `decorators` skill. Does NOT cover `deriveTools` / MCP / AI tool wiring → hand off to `tools` skill. Does NOT cover JSON Lines streaming / generators / `JSONLinesResponder` → hand off to `jsonlines` skill. Does NOT cover `@operation` metadata / Scalar docs → hand off to `openapi` skill.
Процедуры Vovk.ts подробно (base уже имеет полный конечный пункт, валидацию, ошибки и коды состояния) — атомарная единица серверной логики в проекте Vovk.…
Как процесс C 64/100 · Есть пробелы — слабые места: входы и предусловия, повторный запуск, отчётность по ходу
Как улучшить
- Сократите description до 1024 символов.
- Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 1. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- ошибка
description-longdescription 1463 символов, лимит 1024 - предупреждение
body-longтело SKILL.md ≈ 5592 токенов (рекомендуется < 5000); вынесите детали в references/
Процессный рейтинг: все десять параметров 64/100
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 14, без проверки текущего состояния
- 60Инструменты и файлы. Используются инструменты (web), но во frontmatter они не объявлены
- 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 70Стоимость исполнения. Тело инструкции 5592 токенов
- 85Шаги. Шагов: 25, расплывчатых формулировок: 1
- 100Ошибки и развилки. Развилок: 3, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- low Разделов верхнего уровня: 17. Похоже на несколько доменов в одном скилле
- low Ответ описан самодельной разметкой (5 тегов): типизированный вызов надёжнее
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 1463: рекомендуется 120–800 символов
- -2Ссылки на localhost: у другого пользователя не заработает
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 13 примера фраз-триггеров в кавычках
- +4Структура: 23 заголовков
- +3Пошаговые инструкции: 25 пунктов
- +3Формат ответа описан явно
- +4Есть примеры (22 блоков кода)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 52.