AC openapi-contract-driven
Рабочий процесс разработки на основе контрактов OpenAPI для команд из нескольких агентов. Решает системный дефект "frontend изобретает конечные точки, backend забывает реализовать" в многоагентном сотрудничестве. Используйте, когда: (1) начинаете новый проект или стандартизируете API-сотрудничество, (2) часто видите "пустую страницу / 500 / 502" без явной корневой причины, (3) необходимо установить систему API-контрактов между командами людей/AI-агентов. OpenAPI 契约驱动开发工作流。解决多 Agent 协作中「前端自造端点，后端漏实现」 这个系统性缺陷。Use when: (1) 新项目启动或已有项目需要规范 API 协作， (2) 频繁出现"页面空白 / 500 / 502"但找不到根因， (3) 需要在多人/AI agent 团队中建立 API 契约体系。 НЕ для: одиночных проектов, временных скриптов, проектов не на REST API.
машинный переводПоказать оригиналСкрыть оригинал«OpenAPI Contract-Driven Development workflow for multi-agent teams. So…»
OpenAPI Contract-Driven Development workflow for multi-agent teams. Solves the systemic defect of "frontend invents endpoints, backend forgets to implement" in multi-agent collaboration. Use when: (1) starting a new project or standardizing API collaboration, (2) frequently seeing "blank page / 500 / 502" with no clear root cause, (3) need to establish API contract system across human/AI agent teams. OpenAPI 契约驱动开发工作流。解决多 Agent 协作中「前端自造端点，后端漏实现」 这个系统性缺陷。Use when: (1) 新项目启动或已有项目需要规范 API 协作， (2) 频繁出现"页面空白 / 500 / 502"但找不到根因， (3) 需要在多人/AI agent 团队中建立 API 契约体系。 NOT for: 单人项目、临时脚本、非 REST API 项目。
Рабочий процесс разработки на основе контрактов OpenAPI для команд из нескольких агентов.
Как процесс C 50/100 · Есть пробелы — слабые места: результат и критерий готовности, входы и предусловия, ошибки и развилки
Как улучшить
- Свои кейсы (evals/evals.json, 4–6 реальных запросов с ожидаемыми ответами): тогда полная проверка прогонит именно их, а не черновик от модели.
- spec.yaml с триггерными фразами и утверждениями — контракт поведения для CI; `skilltest init` создаст шаблон.
Находки guard · 0
✓ Критических и высоких находок нет
Просканировано файлов: 14. Улики замаскированы. Пометки в серых чипах объясняют, почему серьёзность понижена.
По спецификации Agent Skills
✓ По спецификации Agent Skills замечаний нет
Процессный рейтинг: все десять параметров 50/100
- 0Результат и критерий готовности. Не сказано, что считать результатом
- 0Входы и предусловия. Не сказано, что нужно иметь на входе
- 0Ошибки и развилки. Линейный процесс без обработки сбоев
- 0Отчётность по ходу. Скилл ничего не сообщает по ходу работы
- 50Когда включается. Не сказано, при каком запросе скилл включается
- 60Инструменты и файлы. Используются инструменты (bash, web), но во frontmatter они не объявлены
- 100Шаги. Шагов: 10
- 100Согласованность. Имя и обязательные поля на месте
- 100Стоимость исполнения. Тело инструкции 1306 токенов
- 100Повторный запуск. Изменяющих операций нет
Всё перечисленное измерено по тексту скилла, а не оценено моделью: цифры проверяемы. Вес параметра тем больше, чем чаще из-за него процесс встаёт.
Сигналы качества
- +3Формат ответа не описан: модель каждый раз решает сама
- +1Лицензия не указана
- +2Инструкции на одном языке
- +5В description 3 примера фраз-триггеров в кавычках
- +4Описание говорит, когда скилл НЕ применять
- +3Длина description 597 символов: достаточно сигнала, не съедает бюджет
- +4Структура: 17 заголовков
- +3Пошаговые инструкции: 10 пунктов
- +4Есть примеры (8 блоков кода)
- +4Справочные файлы упоминаются в инструкциях (1 из 1)
База качества 70; замечания lint вычитаются, сигналы прибавляют до 100. Итог: 97.