Использовать AI-навыки в SourceCraft

Вы можете автоматизировать повторяющиеся задачи и расширить функциональность чата с Code Assistant в интерфейсе SourceCraft с помощью AI-навыков.

AI-навык запускается в чате с Code Assistant и передает AI-агенту инструкции и контекст, специфичные для конкретной задачи и репозитория, в котором открыт чат.

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

Например, с помощью AI-навыков вы можете:

  • Пройти интерактивное обучение работе с SourceCraft.
  • Запросить помощь с конфигурацией репозитория.
  • Декомпозировать задачу.
  • Сделать саммари по информации из задачи.
  • Собрать контекст ваших действий в репозитории за последние несколько часов.

Подробнее см. на странице AI-навыки в SourceCraft.

Примечание

В инструкциях описана настройка навыков в интерфейсе SourceCraft. О настройке в формате «Configuration as Code» см. в подразделе Конфигурационные файлы навыков.

Запустить навык

По умолчанию в любом репозитории доступны для запуска только системные навыки. Для запуска навыка из каталога или публичного навыка вначале импортируйте их. Для запуска пользовательского навыка вначале создайте его в репозитории.

Чтобы запустить навык:

  1. Откройте главную страницу SourceCraft.

  2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.

  3. Выберите репозиторий, в котором вы хотите запустить навык.

  4. На левой панели нажмите Чат Code Assistant.

    Также вы можете запустить навык из раздела Автоматизации в секции AI.

  5. В правом нижнем углу чата нажмите и выберите навык, который вы хотите запустить.

    Совет

    Если вам известна команда, соответствующая навыку, вы также можете начать вводить ее в чате, начиная с /, например /configs, и в выпадающем меню выбрать подходящую команду, например /configs-helper.

  6. Нажмите или Enter.

  7. (опционально) Если навыком предусмотрены параметры, введите их или выберите из выпадающего меню и нажмите Принять.

  8. По ходу работы Code Assistant может задавать вам уточняющие вопросы. Отвечайте на них в чате на естественном языке.

    Совет

    Если вы передумали и хотите остановить работу Code Assistant, нажмите Остановить.

    Дождитесь появления в чате сообщения Работа с навыком закончена.

  9. Если в ходе выполнения навыка в репозиторий были внесены изменения:

    1. В правом верхнем углу нажмите Сохранить изменения.

    2. В открывшемся окне настройте параметры внесения изменений:

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

    3. Подтвердите внесение изменений.

Импортировать навык

Вы можете импортировать в свой репозиторий навык из каталога или любой публичный навык.

Важно

Импортируемые навыки содержат инструкции для Code Assistant, которые будут выполняться в вашем репозитории. Обязательно ознакомьтесь с содержимым этих инструкций, прежде чем использовать навык.

Учитывайте, что подключенный навык может быть изменен автором, что, в свою очередь, может привести к неожиданному поведению.

Импортировать навык из каталога

  1. Откройте главную страницу SourceCraft.

  2. В верхнем центральном блоке нажмите Просмотреть AI-навыки.

  3. Выберите навык, который вы хотите импортировать.

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

  4. В карточке навыка нажмите Подключить.

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

    Совет

    Чтобы протестировать навык, нажмите Запустить.

  5. Выберите репозиторий, в который вы хотите импортировать навык.

  6. Изучите инструкции и параметры навыка.

  7. (опционально) Задайте Дополнительные инструкции для модели и Параметры запуска.

  8. Нажмите Сохранить.

  9. В открывшемся окне:

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

  10. Подтвердите внесение изменений.

  11. Проверьте работу навыка.

Импортировать публичный навык

  1. Создайте в репозитории, в котором вы хотите добавить навык, файл .sourcecraft/ai.yaml со следующим содержимым:

    skills:
  - source:
      repo: <слаг_организации>/<слаг_репозитория>
      path: .sourcecraft/skills/<команда_для_запуска>
    settings:
      instructions: |-
        <дополнительные_инструкции>
      inputs:
        <параметр>: <значение_по_умолчанию>

    Где:

    • source.repo — путь к публичному репозиторию, из которого импортируется навык, например examples/skills;
    • source.path — путь к директории с навыком, например .sourcecraft/skills/issue-summary;
    • settings.instructions — дополнительные инструкции для агента, например Результат твоей работы должен быть только на английском языке;
    • settings.inputs — параметры навыка по умолчанию, например config_type: Правила для веток.

  2. Проверьте работу навыка.

Настроить системный навык или импортированный навык

Для системных, публичных и навыков из каталога вы можете настроить дополнительные инструкции и параметры по умолчанию:

  1. Откройте главную страницу SourceCraft.

  2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.

  3. Выберите репозиторий, в котором вы хотите настроить навык.

  4. В разделе Автоматизации перейдите в секцию AI.

  5. Напротив навыка, который вы хотите настроить, нажмите .

  6. Задайте Дополнительные инструкции для модели и Параметры запуска.

  7. Нажмите Сохранить.

  8. В открывшемся окне:

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

  9. Подтвердите внесение изменений.

Создать пользовательский навык

  1. Откройте главную страницу SourceCraft.

  2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.

  3. Выберите репозиторий, в котором вы хотите создать навык.

  4. В разделе Автоматизации перейдите в секцию AI.

  5. В правом верхнем углу нажмите Новый AI-навык.

  6. В открывшемся окне задайте:

    • Название, которое будет отображаться в интерфейсе SourceCraft, например Саммари по задаче.

    • Описание, например Создает краткое саммари по задаче. Можно использовать, чтобы быстро разобраться в том, что происходит в больших задачах или задачах с объемной дискуссией в комментариях.

    • Команда для запуска, например issue-summary.

    • Описание для модели — текстовые инструкции для агента в разметке Markdown.

      Совет

      Примеры готовых навыков см. в репозиториях sourcecraft/ai и examples/skills.

  7. (опционально) В блоке Параметры запуска нажмите Добавить параметр и настройте его:

    1. Выберите тип параметра:
      • Строка.
      • Выбор. Для этого типа параметра добавьте возможные варианты.
      • Булево.
    2. Введите название параметра.
    3. (опционально) Выберите или введите значение параметра по умолчанию.
    4. (опционально) Задайте описание параметра.
    5. Укажите, должен ли быть параметр обязательным.

    Чтобы добавить еще один параметр, нажмите Добавить параметр.

    Примечание

    В текстовых инструкциях для агента параметры указываются в формате {{ <название_параметра> }}.

  8. Нажмите Сохранить.

  9. В открывшемся окне:

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

  10. Подтвердите внесение изменений.

  11. Проверьте работу навыка.

Отредактировать пользовательский навык

  1. Откройте главную страницу SourceCraft.

  2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.

  3. Выберите репозиторий, в котором вы хотите отредактировать пользовательский навык.

  4. В разделе Автоматизации перейдите в секцию AI.

  5. Напротив пользовательского навыка, который вы хотите отредактировать, нажмите и выберите Изменить.

  6. Измените параметры пользовательского навыка. Подробнее см. Создать пользовательский навык.

  7. Нажмите Сохранить.

  8. В открывшемся окне:

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

  9. Подтвердите внесение изменений.

Удалить пользовательский или импортированный навык

  1. Откройте главную страницу SourceCraft.

  2. На вкладке Домой в секции Ваша мастерская перейдите в раздел Репозитории.

  3. Выберите репозиторий, в котором вы хотите удалить навык.

  4. В разделе Автоматизации перейдите в секцию AI.

  5. Напротив навыка, который вы хотите удалить, нажмите и выберите Удалить.

  6. В открывшемся окне:

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

  7. Подтвердите внесение изменений.

См. также

Предыдущая
Анализ уязвимостей с помощью ИИ
Следующая
Создать реестр