SKILLEMALL.ai
GitHub ↗ EN Войти

CD v2-api-conventions

Контракт ответа, ошибки, пагинации и валидации, которому должен соответствовать каждый конечный пункт `/api/v2`. Используйте при добавлении или изменении маршрута в `apps/sim/app/api/v2/` или при его проверке на соответствие.

машинный переводПоказать оригиналСкрыть оригинал«The response, error, pagination, and validation contract every `/api/v…»

The response, error, pagination, and validation contract every `/api/v2` endpoint must satisfy. Use when adding or changing a route under `apps/sim/app/api/v2/`, or when auditing one for conformance.

simstudioai/sim Claude Code автор: simstudioai Apache-2.0 1 файл тело ≈ 8 008 токенов Открыть источникgithub.com↗ проанализирован 11 ч назад

Контракт ответа, ошибки, пагинации и валидации, которому должен соответствовать каждый конечный пункт /api/v2.

Как процесс D 39/100 · Процесс не доведён — Скилл ссылается на файлы, которых нет в архиве: ../../../apps/sim/lib/api/contracts/v2/openapi/README.md

ИнтеграцияРазработкатип и темы размечены автоматически по тексту скилла
Запускается в: Claude / Claude Code ChatGPT / Codex Gemini CLI Cursor GitHub Copilot / VS Code Qwen Code Kimi Code CLI Z.ai (GLM) DeepSeek (Deep Code) Mistral Vibe LangChain (deepagents) OpenClaw Goose OpenCode
JSON
Технический рейтинг
C
86/100
безопасность, качество, тесты
Безопасность 60%
98
Качество 40%
68
Прогон на моделях
не было
Процессный рейтинг
D
39/100
Процесс не доведён
Скилл ссылается на файлы, которых нет в архиве: ../../../apps/sim/lib/api/contracts/v2/openapi/README.md
Инструменты и файлы вес 18
0
Результат и критерий готовности вес 14
0
Входы и предусловия вес 11
0
три самых слабых из десяти параметров · все десять

Как улучшить

  1. Тело SKILL.md длиннее 5 000 токенов: вынесите справочные детали в references/ и подключайте по необходимости.
  2. В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
Для прогона на моделях — необязательно
  • Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
  • spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.

Находки guard · 2

✓ Критических и высоких находок нет

Средние и низкие: 2
  • низкая Секреты в коде secret-high-entropy-token SKILL.md:55
    Строка, похожая на токен (может быть id, хеш или секрет) (определение детектора / чёрного списка)
    **404 is deliberately overloaded.** A workspace the caller cannot reach answers `404 "Workspace not found"`, never 403 — a 403 would confirm the resource exists. `crea…icy` do
    детектор
  • низкая Секреты в коде secret-high-entropy-token SKILL.md:63
    Строка, похожая на токен (может быть id, хеш или секрет) (определение детектора / чёрного списка)
    **Which of 403 and 404 an operation documents follows from its authorization, not from whether it is a read.** `requirePermission` throws two different failures: no workspace access at all is `NoWorks
    детектор

Просканировано файлов: 1. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.

По спецификации Agent Skills

  • предупреждение body-long тело SKILL.md ≈ 8008 токенов (рекомендуется < 5000); вынесите детали в references/
  • предупреждение missing-ref ссылка на отсутствующий файл: ../../../apps/sim/lib/api/contracts/v2/openapi/README.md
  • заметка edit-residue в тексте есть пометки об устаревшем (строки 116): проверьте, не остались ли старые правила рядом с новыми — полная проверка читает текст на противоречия

Процессный рейтинг: все десять параметров 39/100

Не запустится. Скилл ссылается на файлы, которых нет в архиве: ../../../apps/sim/lib/api/contracts/v2/openapi/README.md
  • 0Инструменты и файлы. Не хватает 1 файла(ов): ../../../apps/sim/lib/api/contracts/v2/openapi/README.md
  • 0Результат и критерий готовности. Не сказано, что считать результатом
  • 0Входы и предусловия. Не сказано, что нужно иметь на входе
  • 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
  • 20Когда включается. Не сказано, при каком запросе скилл включается
  • 30Повторный запуск. Изменяющих операций: 26, без проверки текущего состояния
  • 40Стоимость исполнения. Тело инструкции 8008 токенов: вытесняет саму задачу из окна
  • 100Шаги. Шагов: 35
  • 100Ошибки и развилки. Развилок: 1, есть раздел про ошибки
  • 100Согласованность. Имя и обязательные поля на месте
  • medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
  • low Разделов верхнего уровня: 12. Похоже на несколько доменов в одном скилле
  • high Скилл велит модели самой совершать необратимое действие, без подтверждения человеком

Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.

Сигналы качества

  • +5В description нет примеров фраз, по которым скилл должен срабатывать
  • +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
  • +3Формат ответа не описан: модель каждый раз решает сама
  • +1Лицензия не указана
  • +2Инструкции на одном языке
  • +3Длина description 199 символов: достаточно сигнала, не съедает бюджет
  • +4Структура: 14 заголовков
  • +3Пошаговые инструкции: 35 пунктов
  • +4Есть примеры (3 блоков кода)

База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 68.