BF api-design-and-evolution
Проектирование, управление, документирование, обзор и развитие общедоступных API и интерфейсов событий. Используйте при выборе REST/HTTP, GraphQL, RPC, событий, веб-хуков или потоковой передачи; написании контрактов OpenAPI или AsyncAPI; оценке ландшафта API, владения, дублирования, жизненного цикла, обнаруживаемости, вывода из эксплуатации, шлюзов, сервисных сеток, прямого или бокового трафика, маршрутизации, политик, наблюдаемости или границ сбоев; определении схем, пагинации, мутаций, ошибок, идемпотентности или совместимости; или планировании версионирования, устаревания и миграции. Не используйте для исследования продукта, эксплуатации платформы, полной оценки безопасности, написания ADR или этапов выпуска; передавайте эти задачи соседним специализированным навыкам.
машинный переводПоказать оригиналСкрыть оригинал«Design, govern, document, review, and evolve consumer-facing APIs and…»
Design, govern, document, review, and evolve consumer-facing APIs and event interfaces. Use when choosing REST/HTTP, GraphQL, RPC, events, webhooks, or streaming; writing OpenAPI or AsyncAPI contracts; assessing an API landscape, ownership, duplication, lifecycle, discoverability, retirement, gateways, service meshes, north-south or east-west traffic, routing, policy, observability, or failure boundaries; defining schemas, pagination, mutations, errors, idempotency, or compatibility; or planning versioning, deprecation, and migration. Do not use for product discovery, platform operations, full security assessment, ADR authoring, or delivery gates; route those to the neighboring specialist skills.
Проектирование, управление, документирование, обзор и развитие общедоступных API и интерфейсов событий.
Как процесс F 52/100 · Не запустится — Скилл ссылается на файлы, которых нет в архиве: ../adr-authoring/SKILL.md, ../product-discovery/SKILL.md, ../secure-software-engineering/SKILL.md
Как улучшить
- В тексте есть ссылки на отсутствующие файлы: добавьте файлы или уберите ссылки.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 19. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
- предупреждение
missing-refссылка на отсутствующий файл: ../adr-authoring/SKILL.md - предупреждение
missing-refссылка на отсутствующий файл: ../product-discovery/SKILL.md - предупреждение
missing-refссылка на отсутствующий файл: ../secure-software-engineering/SKILL.md - предупреждение
missing-refссылка на отсутствующий файл: ../verification-methodology/SKILL.md - предупреждение
missing-refссылка на отсутствующий файл: ../release-engineering/SKILL.md
Процессный рейтинг: все десять параметров 52/100
- 0Инструменты и файлы. Не хватает 5 файла(ов): ../adr-authoring/SKILL.md, ../product-discovery/SKILL.md, ../secure-software-engineering/SKILL.md
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 30Повторный запуск. Изменяющих операций: 5, без проверки текущего состояния
- 100Шаги. Шагов: 12
- 100Когда включается. Сказано, когда применять и когда не применять
- 100Ошибки и развилки. Развилок: 1, есть раздел про ошибки
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 1991 токенов
- medium Правила безопасности и запреты внутри скилла: их место в системном промпте, здесь они не защищают
- low Среди тестов нет случая на инъекцию через данные
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +5В description нет примеров фраз, по которым скилл должен срабатывать
- +3Формат ответа не описан: модель каждый раз решает сама
- +4Нет примеров входа/выхода
- +2Инструкции на одном языке
- +4Описание говорит, когда скилл НЕ применять
- +3Длина description 705 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 8 заголовков
- +3Пошаговые инструкции: 12 пунктов
- +4Справочные файлы упоминаются в инструкциях (10 из 10)
- +1Лицензия указана
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 77.