Установка HagiTask

Для кого: Для пользователей, которые хотят установить задачи сообщества и использовать их в HagiCode.

Предварительные требования:

• Доступ к используемому приложению HagiCode и серверной службе.
• Версия приложения, поддерживающая управление задачами сообщества HagiTask и Community Gallery.
• Необходимые задаче agents, skills или инструменты CLI уже подготовлены; требования указаны в подробностях задачи.

Установка из Community Gallery

Поддерживаемый сейчас процесс: найти сведения о задаче и ZIP-архив в Community Gallery на HagiTask Site, а затем воспользоваться функцией установки задач сообщества в приложении:

1. Найдите задачу в Gallery по названию, категории или тегам.
2. Откройте страницу задачи и проверьте версию, издателя, совместимость и размер установки.
3. Выберите установку. Приложение получит ZIP по адресу packageUrl и проверит идентификатор задачи, версию и SHA-256.
4. После успешной проверки приложение запишет пакет в локальный каталог данных HagiTask и обновит каталог задач.

Адреса Gallery для поиска, подробностей и архивов соответственно: /index.json, /tasks/<taskId>.json и /packages/<taskId>.zip. Для установки используется архив; разбирать содержимое веб-страницы не требуется.

Установка из архива

Если вы уже получили ZIP поддерживаемым способом через Gallery, выберите установку локального архива в интерфейсе управления задачами сообщества. Архив должен содержать полный каталог пакета задач; его ID, версия и хеш содержимого должны совпадать с данными запроса на установку.

Загрузка локальной папки через браузер не входит в текущий процесс установки из Community Gallery. Настройка источников в виде папок на сервере служит другой цели; подробности см. в разделе Использование HagiTask.

Проверка установки

После установки проверьте в интерфейсе управления задачами сообщества, что:

• У задачи указаны правильные taskId, версия и издатель.
• Задача включена или её можно включить вручную.
• В уведомлениях о зависимостях и совместимости нет невыполненных требований.
• После обновления каталога задача остаётся доступной и её панель открывается.

В записи об установке сохраняются источник, версия, хеш архива и состояние включения. Встроенные задачи показываются только для ознакомления: удалить их как пакеты сообщества нельзя.

Решение проблем

Gallery недоступна

Убедитесь, что настроенный в приложении адрес Gallery доступен и использует HTTPS; проверьте сеть, время ожидания и состояние сайта. Если первоначальное получение каталога не удалось, приложение не создаст фиктивный пустой каталог; при наличии действительного кеша оно может временно показывать прежний каталог.

Задача не находится или подробности некорректны

Используйте канонический taskId из подробностей задачи, а не отображаемый псевдоним. agentsmd и portytail — только понятные человеку псевдонимы для claude-md-update и ponytail, а не идентификаторы устанавливаемых задач.

Ошибка проверки целостности или версии

Загрузите архив из Gallery заново. Не изменяйте ZIP и созданные файлы каталога вручную. Если ошибка сохраняется, попросите сопровождающего пакета проверить исходные данные и номер версии в Community Packages.

Задача недоступна после установки

Проверьте требования к agents, skills и CLI в подробностях задачи; убедитесь, что задача включена в приложении, и обновите каталог. Если содержимое пакета некорректно, обратитесь к руководству для участников сообщества, где описаны схема и процесс проверки.

Следующий шаг: Использование HagiTask.