AIKraft/Skills/iii-error-handling

iii-error-handling

Обработка ошибок iii engine и SDK в Node, Python, Rust и browser workers. Полезно при интерпретации кодов ошибок, проверке возможности повтора, отказе RBAC, таймаутах, сбоях хендлеров и исключений SDK.

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

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

Навык обеспечивает обработку ошибок iii engine и SDK в Node, Python, Rust и browser workers. Он позволяет агентам интерпретировать коды ошибок, проверять возможность повтора, а также реагировать на отказы RBAC, таймауты, сбои хендлеров и исключения SDK.

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

  • Интерпретация кодов ошибок при вызове функций через SDK или engine.
  • Проверка возможности повтора операции при получении ошибок отворота или таймаута.
  • Анализ причин отказа в доступе (RBAC) или сбое хендлеров.
  • Обработка исключений SDK и ошибок маршрутизации (invocation_error).

Как работает

  1. Разделить ошибки на два широких класса: SDK/local errors и engine/remote invocation errors.
  2. Ветвить логику обработки на основе точных строк кодов ошибок (error codes), а не только сообщений.
  3. Отделять engine wire codes от SDK-local codes при анализе.
  4. Для кодов function_not_found, function_not_invokable проверять ID функции, регистрацию и тип триггера.
  5. Для invocation_error, invocation_stopped, invocation_failed inspect логи, стек вызовов и состояние протокола.
  6. Для FORBIDDEN не повторять попытки вслепую, а проверять политику и контекст аутентификации.

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

Обработай ошибку с кодом FORBIDDEN, проверь RBAC политику и не повторяй запрос.
При получении TIMEOUT от Node SDK оцени, нужно ли увеличить время ожидания или оптимизировать нагрузку.
Проанализируй ошибку invocation_error: проверь логи движка, состояние протокола и доступность воркера.

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

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

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

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