BD API Changelog Gen
Инструмент сравнения спецификаций OpenAPI/Swagger, который генерирует удобочитаемые журналы изменений API. Сравнивает два файла спецификаций OpenAPI 3.x или Swagger 2.0 (YAML или JSON) с семантическим сравнением — а не сравнением текста по строкам — и создает структурированный журнал изменений, классифицируя каждое изменение как BREAKING (удаленный конечный пункт, удаленное обязательное поле, измененный тип ответа, суженное перечисление, ужесточенная аутентификация) или NON-BREAKING (добавленное необязательное поле, новый конечный пункт, ослабленное ограничение, добавленное значение перечисления). Выводит журнал изменений в формате Markdown для документации/PR, JSON для конвейеров CI и раздел «руководство по миграции», адресованный потребителям API. Обнаруживает изменения схемы аутентификации и удаленные области безопасности. Поддерживает локальные файлы и несколько версий спецификаций в репозитории Git. Никаких внешних API — чистое локальное парсинг файлов. Активируется по запросам «api diff», «openapi diff», «what changed in the API», «breaking changes», «api changelog», «spec diff», «/api-changelog».
машинный переводПоказать оригиналСкрыть оригинал«OpenAPI/Swagger spec differ that generates human-readable API changelo…»
OpenAPI/Swagger spec differ that generates human-readable API changelogs. Diffs two OpenAPI 3.x or Swagger 2.0 spec files (YAML or JSON) with a semantic diff — not a line-level text diff — and produces a structured changelog classifying every change as BREAKING (removed endpoint, removed required field, changed response type, narrowed enum, tightened auth) or NON-BREAKING (added optional field, new endpoint, relaxed constraint, added enum value). Outputs Markdown changelog for docs/PRs, JSON for CI pipelines, and a "migration guide" section addressed to API consumers. Detects auth scheme changes and removed security scopes. Supports local files and multiple spec versions in a git repo. Zero external API — pure local file parsing. Triggers on "api diff", "openapi diff", "what changed in the API", "breaking changes", "api changelog", "spec diff", "/api-changelog".
Инструмент сравнения спецификаций OpenAPI/Swagger, который генерирует удобочитаемые журналы изменений API.
Как процесс D 48/100 · Процесс не доведён — слабые места: результат и критерий готовности, входы и предусловия, согласованность
Как улучшить
- Скажите в description, КОГДА применять скилл («используй, когда…», примеры запросов): это главный сигнал для агента.
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 2. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
name-formatname должен быть в kebab-case (строчные буквы, цифры, дефисы) - предупреждение
description-no-whendescription не говорит, КОГДА применять скилл (нет "use when / используй когда") - заметка
frontmatter-keyнеизвестное поле фронтматтера "homepage"
Процессный рейтинг: все десять параметров 48/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 2, без проверки текущего состояния
- 40Согласованность. Имя во frontmatter (API Changelog Gen) не совпадает с папкой (phy-api-changelog-gen)
- 55Ошибки и развилки. Развилок: 1
- 60Инструменты и файлы. Используются инструменты (bash, python), но во frontmatter они не объявлены
- 70Когда включается. Сказано, когда применять, но не сказано, когда не стоит
- 70Стоимость исполнения. Тело инструкции 4091 токенов
- 100Шаги. Шагов: 9
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +4Описание не говорит, когда скилл НЕ применять (ложные срабатывания)
- +3Длина description 874: рекомендуется 120–800 символов
- +3Формат ответа не описан: модель каждый раз решает сама
- +2Инструкции на одном языке
- +5В description 8 примера фраз-триггеров в кавычках
- +4Структура: 10 заголовков
- +3Пошаговые инструкции: 9 пунктов
- +4Есть примеры (10 блоков кода)
- +1Лицензия указана
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 69.