AIKraft/Skills/iii-core-primitives

iii-core-primitives

Используйте для регистрации функций iii, привязки триггеров, выбора режима вызова (sync/void/enqueue), создания воркеров и инспекции реестра. Подходит для установки воркеров, написания кастомных триггеров, перемещения данных каналов и адаптации внешних HTTP-функций в TypeScript, Python и Rust.

IIiii official Разработка ★ 18.8k

Что делает навык

Навык предоставляет базовые примитивы для регистрации функций, привязки триггеров, создания воркеров и инспекции реестра движка iii. Он позволяет агентам управлять жизненным циклом рабочих процессов, выбирая режимы вызова (sync, void, enqueue) и настраивая взаимодействие с внешними HTTP-сервисами.

Когда применять

  • Регистрация локальных обработчиков или привязка внешних HTTP-эндпоинтов к функциям iii.
  • Создание и настройка воркеров для подключения к движку и выполнения задач.
  • Настройка триггеров (HTTP, cron, durable:subscriber и др.) для автоматического запуска функций.
  • Инспекция реестра движка для получения списка подключенных воркеров, функций и триггеров.
  • Выбор режима вызова функции (синхронный, асинхронный void или очередь) в зависимости от требований к результату.

Как работает

  1. Инициализировать воркер с помощью registerWorker (или register_worker) и указать имя воркера.
  2. Зарегистрировать функции через registerFunction, передав ID функции (с использованием ::) и обработчик или HttpInvocationConfig.
  3. Привязать триггеры к функциям с помощью registerTrigger, указав тип (например, http, cron) и конфигурацию.
  4. Вызывать функции из кода через trigger, выбирая действие: Sync (по умолчанию), Void или Enqueue.
  5. Использовать встроенные функции (engine::workers::list, engine::functions::list) для проверки состояния реестра.
  6. При необходимости добавить существующий воркер из реестра через compose::add worker=<name>.

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

Зарегистрируй функцию orders::validate в воркере orders-worker на TypeScript, которая проверяет наличие ID заказа.
Создай HTTP-триггер для функции orders::process, чтобы она вызывалась по POST-запросу на путь /orders.
Вызови функцию charge асинхронно с помощью режима Enqueue в очередь payments, передав валидированный заказ.

Что понадобится

  • Доступ к движку iii (WebSocket соединение, например ws://localhost:49134).
  • Установленный SDK iii для соответствующего языка (TypeScript, Python или Rust).
  • Файл манифеста iii.worker.yaml для локальных воркеров, если требуется автозапуск.

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «iii-core-primitives» из репозитория: # https://github.com/iii-hq/iii
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r iii-core-primitives/ ~/.claude/skills/iii-core-primitives/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.