Руководство по навыкам

В этом руководстве рассматриваются Skills панель в HagiCode.

Откройте Skills, если хотите:

• посмотреть какие навыки уже установлены на этой машине
• получить рекомендуемые навыки на основе ваших текущих проектов и репозиториев
• поиск в более широкой библиотеке навыков
• перед установкой подтвердите источник, состояние доверия и фактическую команду установки.
• управлять тем, какие источники помечены как доверенные

Для чего нужны навыки

Навыки — это встроенная панель просмотра и установки навыков HagiCode. Это дает вам единое место, где можно просмотреть доступные локально навыки, найти рекомендации, выполнить поиск в галерее и проверить детали установки, прежде чем устанавливать что-либо.

Используйте его, когда:

• вы новичок в HagiCode и хотите посмотреть, что уже доступно
• вы знаете, какую работу выполняете, и хотите лучше соответствовать навыкам помощника
• вы хотите установить новый навык, но сначала вам необходимо проверить источник
• вы хотите избежать переустановки того, что уже доступно локально

Рекомендуемый порядок чтения

При первом проходе начните с Local Skills, затем перейдите к Recommendation и Galleryи только после этого просмотрите панель сведений перед установкой.

1. Открытые навыки

В верхней панели навигации рабочей области HagiCode щелкните значок Skills кнопку, чтобы открыть панель.

Красная стрелка на скриншоте отмечает точку входа.

Открыв панель, вы увидите четыре основные вкладки:

• Local Skills
• Recommendation
• Gallery
• Trusted Providers

Когда открывать навыки

Вам не нужно покидать текущий проект, сеанс или процесс адаптации. Навыки открываются на верхней панели внутри той же рабочей области.

2. Проверьте местные навыки

Local Skills отвечает на два распространенных вопроса: Что уже установлено? и Какие из этих навыков можно обновить прямо сейчас?

Наиболее важные разделы на этой странице:

• Поле поиска: фильтруйте местные навыки по имени, идентификатору, пути или агенту.
• Refresh inventory: повторно просканировать то, что в данный момент установлено на этом компьютере.
• Update all: запускать пакетные обновления для навыков, поддерживающих управляемые обновления.
• Batch update summary: просмотреть результаты последней партии и журнал состояния.

В каждой строке обычно отображается:

• название навыка
• совместимые агенты
• локальный путь установки
• доступные действия

Если строка предупреждает об отсутствии метаданных установки, управляемой серверной частью, этот навык не может использовать обновления одним щелчком мыши и его следует проверить вручную.

:::осторожно[Пакетное обновление все еще требует проверки человеком] Update all означает только то, что поток обновления выполняется массово. Это не означает, что перечисленные навыки уже прошли проверку безопасности для вашего варианта использования. :::

3. Получите рекомендованные навыки

Recommendation создает список кандидатов из ваших текущих проектов и репозиториев. Это полезно, когда вы знаете, какой работой занимаетесь, но еще не решили, какие навыки привить.

Практический порядок чтения:

1. Проверьте селекторы героев вверху, чтобы понять, какой контекст определяет рекомендацию.
2. Нажмите Generate recommendations
3. Просмотрите чипы запросов, чтобы понять, почему были выбраны эти кандидаты.
4. Сравните карточки кандидатов, прежде чем открывать панель сведений.

Общие надписи на рекомендательных карточках означают:

• Recommended: в настоящее время предлагается системой
• Installed: уже установлено
• Installed locally: уже доступен в локальной среде и обычно не требует переустановки.

:::примечание[Что installed locally означает] Этот ярлык означает «это у вас уже есть». Это не приглашение установить его сейчас. :::

4. Ищите и сравнивайте в галерее.

Если вы уже знаете, что ищете, или хотите сравнить схожие навыки из разных источников, используйте Gallery.

Gallery лучшее место, где можно:

• поиск по ключевому слову
• сначала фильтруйте до надежных источников
• сравнивать схожие навыки из разных источников
• проверьте количество установок и состояние локальной установки

Начните с трех полей:

• Source: кто предоставляет навык
• Installs: количество установок, которое может выступать в качестве поддерживающего сигнала.
• Installed locally: доступен ли навык на вашем компьютере.

Проверьте источник перед подсчетом количества установок

Популярность может помочь, но она не должна заменять обзор источника. Начните с Source, затем используйте Installs как дополнительный контекст.

5. Перед установкой просмотрите сведения о навыках.

Когда вы открываете навык, HagiCode отображает панель сведений. Это самый важный экран, который необходимо просмотреть перед установкой.

Обратите особое внимание на:

• имя, источник и количество установок: убедитесь, что вы открыли нужный элемент.
• Trust status: почему этот источник считается надежным
• Managed command: фактическая команда HagiCode готова к запуску.
• Status: может ли текущее рабочее пространство установить этот навык
• Overview: поддержка идентификаторов, таких как идентификатор навыка, пул, источник и количество установок.

Managed command имеет значение, потому что это настоящая команда установки, а не декоративный текст.

:::осторожно[trusted не означает «пропустить обзор»] Даже если источник помечен trusted, вам все равно следует прочитать оба Trust status и Managed command перед установкой. :::

6. Управление доверенными поставщиками

Trusted Providers контролирует, какие источники получают trusted этикетка. Откройте его, если хотите узнать, почему источнику доверяют, или когда вам нужно настроить правила доверия.

На этой странице:

• Rule format объясняет, как пишутся правила
• Add provider позволяет добавить набор правил поставщика
• Reset defaults восстанавливает пресеты по умолчанию
• Rules, Status и Source examples столбцы показывают правила сопоставления, текущее состояние и примеры совпадений.

Общие стили правил включают в себя:

• prefix:owner/ для доверия на основе префикса
• exact:owner/repo для одного точного источника

Надежные поставщики не являются страницей учетных данных

Эта страница только решает, какие источники помечены как доверенные. Он не хранит токены, пароли или другие секреты.

Проверьте эти 4 вещи перед установкой

Прежде чем устанавливать навык, просмотрите как минимум эти четыре сигнала:

Проверить	Где искать	Что это вам говорит
Можно ли доверять источнику	Trusted Providers, плюс Trust status в панели подробностей	Почему этот источник помечен как доверенный
Установлен ли он уже	метки статуса в Recommendation и Gallery	Если там написано installed locally, вам обычно не нужно его переустанавливать
Результат пакетного обновления	Batch update summary в Local Skills	Удалось ли последнее массовое обновление и нужно ли что-либо проверять вручную.
Фактическая команда установки	Managed command в панели подробностей	Что на самом деле будет запускать HagiCode

Общий путь пользователя

Обычная последовательность действий в первый раз:

1. Открыть Local Skills и просмотрите то, что уже доступно
2. Использование Recommendation найти кандидатов, подходящих для вашей текущей работы
3. Использование Gallery искать и сравнивать источники
4. Откройте панель сведений, чтобы проверить состояние доверия и команду установки.
5. При необходимости просмотрите или измените правила доверия в Trusted Providers

Связанное чтение

Product Overview See where Skills fits in the larger HagiCode workspace and workflow.

Wizard Setup If you are just getting started, review the current onboarding flow before returning to Skills.

Desktop Installation Guide If you are still finishing installation or first launch, continue with the desktop setup guide.