SKILLEMALL.ai

BC api-breaking-change-detector

Сопоставляет контроллеры/DTO C# Web API с их потребителями TypeScript/JavaScript (React, Angular, Vue, Svelte, Node.js или написанными вручную/автоматически сгенерированными HTTP-клиентами, такими как Fetch, Axios, NSwag) для обнаружения расхождений в контрактах в обоих направлениях: изменения на стороне сервера, нарушающие клиентские приложения (переименованные/удаленные ключи JSON, новые обязательные параметры, изменение кодов состояния), и код на стороне клиента, отправляющий поля, которые сервер больше не читает. Работает непосредственно с исходным кодом, а не с экспортированными файлами спецификаций OpenAPI. Используйте, когда пользователь просит проверить наличие нарушающих изменения API, синхронизировать контракт между фронтендом и бэкендом или проверить изменение DTO/контроллера по отношению к его потребителям TypeScript/JS перед слиянием. Не для генерации нового кода API по спецификации (см. openapi-to-application-code) или для создания новых конечных точек (см. aspnet-minimal-api-openapi).

машинный переводПоказать оригиналСкрыть оригинал«Cross-references C# Web API controllers/DTOs against their TypeScript/…»

Cross-references C# Web API controllers/DTOs against their TypeScript/JavaScript consumers (React, Angular, Vue, Svelte, Node.js, or hand-written/auto-generated HTTP clients like Fetch, Axios, NSwag) to catch contract drift in both directions: backend changes that break client applications (renamed/removed JSON keys, new required parameters, status code shifts) and frontend code sending fields the backend no longer reads. Works directly against source code, not exported OpenAPI spec files. Use when the user asks to check for breaking API changes, verify frontend/backend contract sync, or audit a DTO/controller change against its TypeScript/JS consumers before merging. Not for generating new API code from a spec (see openapi-to-application-code) or scaffolding new endpoints (see aspnet-minimal-api-openapi).

github/awesome-copilot Agent Skills автор: github MIT 1 файл тело ≈ 1 460 токенов Открыть источникgithub.com↗ проанализирован 5 дн назад

Сопоставляет контроллеры/DTO C Web API с их потребителями TypeScript/JavaScript (React, Angular, Vue, Svelte, Node.js или написанными вручную/автоматически…

Как процесс C 62/100 · Есть пробелы — слабые места: входы и предусловия, ошибки и развилки, отчётность по ходу

ИнтеграцияРазработкатип и темы размечены автоматически по тексту скилла
JSON
Технический рейтинг
B
94/100
безопасность, качество, тесты
Безопасность 60%
100
Качество 40%
84
Прогон на моделях
не было
Процессный рейтинг
C
62/100
Есть пробелы
Входы и предусловия вес 11
0
Ошибки и развилки вес 10
0
Отчётность по ходу вес 2
0
три самых слабых из десяти параметров · все десять

Как улучшить

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

    Находки guard · 0

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

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

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

    ✓ По спецификации Agent Skills замечаний нет

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

    • 0Входы и предусловия. Не сказано, что нужно иметь на входе
    • 0Ошибки и развилки. Линейный процесс без обработки сбоев
    • 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
    • 60Инструменты и файлы. Используются инструменты (bash, web), но во frontmatter они не объявлены
    • 60Результат и критерий готовности. Формат результата описан, критерия завершения нет
    • 85Шаги. Шагов: 40, расплывчатых формулировок: 1
    • 100Когда включается. Сказано, когда применять и когда не применять
    • 100Согласованность. Имя и обязательные поля на месте
    • 100Стоимость исполнения. Тело инструкции 1460 токенов
    • 100Повторный запуск. Изменяющие операции проверяют текущее состояние

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

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

    • +5В description нет примеров фраз, по которым скилл должен срабатывать
    • +3Длина description 817: рекомендуется 120–800 символов
    • +4Нет примеров входа/выхода
    • +1Лицензия не указана
    • +2Инструкции на одном языке
    • +4Описание говорит, когда скилл НЕ применять
    • +4Структура: 5 заголовков
    • +3Пошаговые инструкции: 40 пунктов
    • +3Формат ответа описан явно

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