Кратко
Что агент должен знать
Операция описывает универсальное действие: что требуется выполнить. Её код не содержит название провайдера или его API-метода.
Контракт задаёт нормализованный запрос и ответ. Пакет @opsregistry/contracts содержит Zod-схемы и TypeScript-типы.
Capability заявляет, что конкретный провайдер поддерживает операцию. Adapter реализует отображение универсального контракта на API этого провайдера.
Не переносите особенности одного приложения в универсальную операцию. OpsRegistry должен оставаться нейтральным к приложениям, агентским платформам и конкретным поставщикам.
Реестр охватывает бизнес, программы и оборудование. CAD-операции пока черновые: проверяйте наличие нужной версии контракта и работающего адаптера.
У операции могут быть прямые и составные реализации через другие операции, которые тоже допускают дальнейшее разложение. Разложение относится к реализации; внешний контракт и его гарантии сохраняются. Сценарий — пользовательский шаблон на том же механизме, а не отдельный обязательный тип действия.
Составная реализация может быть обычным кодом адаптера. Общий декларативный формат и resolver пока не реализованы. Не выводите поддержку сложной операции только из наличия примитивов: проверяйте всю реализацию, контекст и гарантии ошибок. Проверенная цепочка исполняется программно, без решения LLM на каждом шаге.
Рекомендуемый порядок
- Прочитать /llms.txt.
- Проверить домен и правила в разделе именования.
- Найти подходящий код в operations.json.
- Проверить контракт в npm-пакете или исходном репозитории.
- Выбрать capability и адаптер под нужного провайдера.
- Проверить режим авторизации и ограничения конкретного адаптера.