JJ

jentic/jentic-api-scorecard

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

22 stars Качество 70 Тренд 30Apache-2.0

Оцените любой документ OpenAPI для готовности к ИИ. Инструмент командной строки, GitHub Action и навыки агента, которые реализуют открытую структуру оценки JAIRF, с отчетами HTML и выходом OpenAPI Overlay.

Обзор

Документ OpenAPI, который проходит проверку, не обязательно может использоваться агентом ИИ. Грамматика — это одно; семантическая ясность, безопасность и открытость — это другое. Документ OpenAPI сравнивается с Jentic API AI Readiness Framework (JAIRF) по шести измерениям и возвращает один балл, поэтому вы точно знаете, где улучшить. Совместите это с мастерством агента-компаньона для автоматического применения этих улучшений: невзламывающие правки, многоразовое наложение OpenAPI и журнал изменений до / после. 1. Получить бесплатный ключ на странице Jentic Scorecard API Keys. Каждый документ OpenAPI оценивается по шести объективам — небольшие, целенаправленные улучшения в любом из них, как правило, приносят огромную прибыль как разработчикам, так и агентам ИИ. Структурная валидность и соответствие самому OpenAPI. - качество документации и насколько хорошо документ OpenAPI играет с инструментами нисходящего потока. - семантическая ясность и контекст, в котором LLM должен рассуждать о каждой операции.

Обзор (машинный перевод)

Документ OpenAPI, который проходит проверку, не обязательно может использоваться агентом ИИ. Грамматика - это Семантическая ясность, безопасность и открытость — это другое. Jentic API Scorecard Оцените свой OpenAPI-документ против Jentic API AI Readiness Framework (JAIRF) в шести измерениях и возвращает один класс, поэтому вы точно знаете, где улучшить. В паре. с компаньоном (api-improve Agent) для автоматического применения этих улучшений: Неразрывные правки, многоразовый OpenAPI Overlay и a before/after changelog.

Таблица содержимого

Быстрый старт

  • Что это значит
  • Как это работает
  • Требования
  • Установить
  • Попробуй сейчас
  • Глубина выходного сигнала
  • Машиночитаемый выход Отчет HTML Анализ LLM Anonymous vs. Keyed Access
  • Навыки
  • jentic-api-scorecard
  • jentic-api-improve
  • Ссылка на CLI
  • Команды
  • [[Т0]]
  • GitHub Action
  • Предпочитаете браузер? Готовность предприятия по умолчанию Документ OpenAPI никогда не покидает окружающую среду
  • Аудиторский конец до конца Подписано для регулируемых сред
  • Бежит куда угодно
  • Подстрижен для воспроизводимости Статус
  • Статус сигнала двигателя
  • Лицензия

Быстрый старт

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Jentic API Scorecard

An OpenAPI document that passes validation isn’t necessarily one an AI agent can use. Grammar is one thing; semantic clarity, safety, and discoverability are another. The Jentic API Scorecard scores your OpenAPI document against the Jentic API AI Readiness Framework (JAIRF) across six dimensions and returns a single grade — so you know exactly where to improve. Pair it with the companion api-improve agent skill to apply those improvements automatically: non-breaking edits, a reusable OpenAPI Overlay, and a before/after changelog.

Table of contents

Quick start

  1. Get a free key at the Jentic Scorecard API Keys page.

  2. Score an OpenAPI document:

    JENTIC_API_KEY= npx @jentic/api-scorecard-cli score ./openapi.yaml
    

What it scores

Each OpenAPI document is evaluated across six lenses — small, targeted improvements in any of them tend to produce outsized gains for both human developers and AI agents:

Открыть полный README на GitHub

Рекомендуемые инструменты

Попробуйте другой запрос или уберите фильтр.

Установка

npx skillfish add jentic/jentic-api-scorecard
Новичок в MCP? Начните с руководства на mcpskill.org →