К основному содержанию
affpapa.org
RU EN
скилл CX Codex

sap-api-style — скилл для Claude Code: что делает и как установить

Помогает оформлять документацию к REST, OData и библиотечным API по стандартам SAP API Style Guide. Пригодится при подготовке спецификаций к публикации в SAP API Business Hub.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓ 
npx skills add secondsky/sap-skills --skill sap-api-style -a claude-code
Открыть на GitHub

Что делает sap-api-style

Скилл содержит правила официального руководства по стилю API от SAP для спецификаций OpenAPI 3.0.3, OData версий от v2.0 до v4.01, а также исходного кода на Java, JavaScript, .NET и C/C++. Он задаёт шаблоны комментариев для Javadoc, JSDoc, XML-документации и Doxygen.

Внутри собраны требования к именованию ресурсов и параметров, структура двухуровневых шаблонов для REST и трёхуровневых для OData. Правила строго фиксируют ограничения по длине строк: заголовок API ограничен 80 символами, поле x-sap-shortText — 180 символами, а сводка операции — 255 знаками. При описании жизненного цикла нужно указывать метаданные x-sap-stateInfo и выдерживать срок поддержки устаревших версий не менее 12 месяцев. Вся документация пишется исключительно на американском английском.

Какие задачи решает

  • подготовить спецификацию OpenAPI 3.0.3 для SAP API Business Hub
  • проверить имена параметров и эндпоинтов на соответствие правилам SAP
  • оформить комментарии к методам через JSDoc, Javadoc или XML
  • разметить устаревший API с помощью поля x-sap-stateInfo
  • составить описание сервиса OData по трёхуровневому шаблону

Примеры запросов агенту

  • Оформи спецификацию OpenAPI для этого REST-эндпоинта по правилам sap-api-style
  • Проверь имена параметров и ресурсов сервиса OData на соответствие стилю SAP
  • Добавь JSDoc-комментарии к функциям библиотеки с учётом стандартов SAP

Как установить sap-api-style

1Через Skills CLI (Vercel)

npx skills add secondsky/sap-skills --skill sap-api-style -a claude-code

2Вручную: положить файлы

~/.claude/skills/sap-api-style/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/sap-api-style/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Из того же набора20

sap-btp-best-practices Скилл с практиками SAP BTP: модель аккаунтов, аутентификация, CI/CD, отказоустойчивость. Пригодится, когда проектируете ландшафт BTP до начала работ. CX Codex +1 1 000установок sap-btp-connectivity Помогает настроить Destination Service, Cloud Connector и прокси для гибридной связности в SAP BTP. Пригодится при отладке ошибок 405, 407 и 503 или подключении к on-premise системам. CX Codex +1 943установок sap-abap-cds Скилл снабжает ИИ справочником по синтаксису ABAP CDS от релиза 7.40 SP8 до ABAP Cloud. Помогает писать представления, связывать таблицы через ассоциации и настраивать правила DCL. CX Codex +1 939установок sap-btp-cloud-logging Помогает настраивать сервис SAP Cloud Logging на платформе BTP, передавать телеметрию и строить дашборды в OpenSearch. CX Codex +1 851установок sap-ai-core Скилл помогает подключать большие языковые модели и выстраивать машинное обучение на SAP BTP. Пригодится при настройке оркестрации, RAG и защитных фильтров. CX Codex +1 723установок sap-hana-cli Скилл подключает агента к hana-cli: осмотр таблиц и представлений, SQL-запросы, HDI-контейнеры и выгрузка метаданных в CDS, EDMX или OpenAPI. CX Codex +1 717установок sap-sqlscript Скилл с шаблонами SQLScript для процедур, функций и AMDP в SAP HANA. Пригодится, когда агент пишет или правит код в слое базы данных. CX Codex +1 711установок sapui5 Скилл для ИИ-агентов, который помогает писать приложения на SAP UI5: XML-вью, контроллеры, привязка данных, OData и тесты. CX Codex +1 697установок

Похожие

sap-fiori-add-visual-filter sap-fiori-tools Добавляет визуальные фильтры с графиками в панели фильтрации Fiori Elements на базе CAP или ABAP RAP. Помогает прописать агрегацию и аннотации CDS без ручных ошибок в синтаксисе. CX Codex +1 601установок sap-fiori-app-development sap-fiori-tools Скилл задаёт агенту правила сборки SAP Fiori Elements: List Report, Object Page, Worklist, подключение к CAP или внешнему OData. CX Codex +1 595установок api-reference-documentation aj-geddes Скилл помогает агенту собрать справочник по API: эндпоинты, аутентификация, примеры запросов и ответов, спецификация OpenAPI. CX Codex +1 494установок api-design-patterns agent-skills Скилл с 38 правилами проектирования REST API: ресурсы, ошибки, безопасность, пагинация, версионирование. Пригодится, когда агент пишет или проверяет эндпоинты. CX Codex +1 929установок api-documenter zhaono1 Скилл для описания REST и GraphQL API в формате OpenAPI/Swagger. Пригодится, когда нужно превратить россыпь эндпоинтов в читаемую спецификацию. CX Codex +1 717установок api-designer VoltAgent Community Проектирует архитектуру REST и GraphQL, готовит спецификации OpenAPI 3.1 и схемы авторизации. Пригодится при создании новых API или рефакторинге старых эндпоинтов. 756установок

Рядом в теме «Бэкенд и API»

Всё по теме «Бэкенд и API» →

Вопросы о sap-api-style

Как установить sap-api-style в Claude Code?

Выполните команду npx skills add secondsky/sap-skills --skill sap-api-style -a claude-code в терминале.

Что делает скилл sap-api-style?

Он предоставляет инструкции, ограничения и шаблоны для написания документации REST, OData и библиотечных API по стандартам экосистемы SAP.

Какие требования скилл предъявляет к устаревающим API?

При выводе из эксплуатации нужно задавать метаданные x-sap-stateInfo и обеспечивать поддержку сервиса в течение как минимум 12 месяцев.

Смотрите также

Спонсоры проекта

Компании, которые помогают держать аналитику открытой
Золотой спонсор AI-аналитика спроса на iGaming — индекс, тренды, конкуренты
Nutra.Club Закрытое сообщество Nutra-вертикали от команды M1

Показы, клики и копирования кода — открытая статистика. Мы держим цифры публичными по той же логике, что и сам NeBlask. Стать спонсором