AIKraft/AI/Войти
AIKraft/Skills/Локальная разработка функций Nango

Локальная разработка функций Nango

Builds Nango Functions in a checked-out Zero YAML TypeScript Nango project using local files, index.ts registration, nango dryrun, generated tests, and optional nango deploy via CLI. Use when creating, updating, validating, testing, or deploying Nango actions or syncs locally in a repo. This content overlaps with building-nango-functions but adds CLI workflow details, so load this instead of build

nangohq official Разработка

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

Создаёт и настраивает Nango Functions (actions или syncs) в локальном проекте Nango Zero YAML TypeScript, обеспечивая валидацию через CLI и тестирование. Решает задачи разработки, обновления и проверки интеграций до их развёртывания.

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

  • Создание новых actions или syncs в локальном репозитории Nango.
  • Валидация и отладка функций с помощью nango dryrun перед деплоем.
  • Настройка стратегии чекпоинтов и удаления записей для syncs.
  • Тестирование интеграций с использованием сгенерированных тестов и локальных файлов.

Как работает

  1. Определить тип функции (action или sync) и прочитать соответствующий справочный файл (references/actions.md или references/syncs.md).
  2. Для syncs пройти Sync Strategy Gate: выбрать стратегию чекпоинтов и удаления, обосновать выбор полного обновления, если чекпоинты невозможны.
  3. Собрать обязательные входные данные (Integration ID, имя скрипта, API reference, Connection ID и специфичные параметры).
  4. Создать или обновить файл функции в директории {integrationId}/actions/ или {integrationId}/syncs/, применив правила именования и схемы Zod.
  5. Зарегистрировать функцию в index.ts и выполнить валидацию через nango dryrun с флагом --validate.
  6. При необходимости выполнить тестирование или развёртывание через CLI.

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

Создай action для интеграции 'github' с именем 'get-repo', используя входные параметры из sample response.
Настрой sync для 'jira' с частотой 'every hour', используя cursor-пагинацию и стратегию удаления через webhook.
Проверь локальную функцию 'sync-users' через nango dryrun, используя Connection ID 'conn_123'.

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

  • Локально выгруженный проект Nango Zero YAML TypeScript с директорией .nango/.
  • Установленный CLI Nango для выполнения команд dryrun и deploy.
  • Доступ к API reference URL или sample response для разрабатываемого провайдера.

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

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

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

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