AIKraft/AI/Войти
AIKraft/Skills/Ziniao: общее

Ziniao: общее

紫鸟 CLI 共享基础：应用配置初始化、统一 apiKey 认证、错误处理、输出格式、安全规则。当用户需要第一次配置(`ziniao-cli config init`)、遇到认证/权限问题、或首次使用 ziniao-cli 时触发。

ziniao-open official Другое

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

Навык обеспечивает базовую настройку CLI Ziniao, включая инициализацию конфигурации, единую аутентификацию по apiKey, обработку ошибок и управление локальным браузером ZClaw. Он решает задачи первичной настройки агента, восстановления доступа при проблемах с авторизацией или состоянием клиента, а также маршрутизации запросов к серверным API или локальному браузеру.

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

  • Первичная настройка ziniao-cli для AI Agent или пользователя (ziniao-cli config init).
  • Восстановление работы при ошибках аутентификации, отсутствии клиента или потере соединения с Bridge.
  • Проверка статуса конфигурации, API Key и готовности окружения перед выполнением бизнес-задач (ziniao-cli doctor).
  • Управление несколькими аккаунтами (профилями) и переключение между ними.
  • Вызов серверных API или управление браузером через ZClaw Bridge с учетом прав доступа (Boss/Member).

Как работает

  1. При первом использовании выполнить ziniao-cli config init (с флагами --new для AI, --api-key-stdin для CI/CD или интерактивно для людей).
  2. Перед выполнением любых команд с ZClaw (store/page) запустить ziniao-cli doctor для проверки конфигурации, сети и статуса клиента.
  3. Если doctor показывает, что клиент не запущен, использовать соответствующие команды shell (Get-Command, where.exe, command -v) для запуска ziniao start или open -a.
  4. Если клиент запущен, но не авторизован, выполнить ziniao-cli zclaw login; если Bridge недоступен, подождать до 30 секунд и повторить doctor.
  5. Выбирать команду: использовать быстрые команды (например, ziniao-cli store list) или общие api команды (ziniao-cli api <path>) для серверных запросов.
  6. Обработать вывод: извлечь URL для подтверждения создания приложения, проверить поля ok/error в JSON и сообщить об ошибках или обновлениях (_notice.update).

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

Инициализируй ziniao-cli для меня как AI Agent, чтобы мы могли начать работу с платформой.
Проверь готовность окружения и браузера Ziniao перед тем, как открыть список магазинов.
У меня ошибка аутентификации при работе с браузером. Что нужно сделать, чтобы восстановить доступ?

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

  • Установленный ziniao-cli и локальный клиент Ziniao (ZClaw Bridge).
  • Действующий API Key, полученный через процесс инициализации config init.
  • Доступ к интернету для связи с сервером sbappstoreapi.ziniao.com и локальный доступ к порту 9481.

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

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

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

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