---
metadata:
  - name: generator
    content: Diplodoc Platform v5.63.0
alternate:
  - https://vibe.sourcecraft.dev/portal/docs/en/sourcecraft/operations/ai-skills.md
  - https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ai-skills.md
  - href: https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ai-skills.md
    type: text/markdown
    title: Markdown version
  - href: https://vibe.sourcecraft.dev/portal/docs/ru/llms.txt
    rel: describedby
---
> **Documentation Index:** Fetch the complete configuration index at https://vibe.sourcecraft.dev/portal/docs/ru/llms.txt

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

<!-- source: ru/_includes/sourcecraft/ai-skills-intro.md -->
{% note tip %}

Эта страница про навыки в интерфейсе и CI/CD SourceCraft. Про навыки в плагине Code Assistant читайте на странице [Навыки (skills) в SourceCraft Code Assistant](https://vibe.sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/skills.md).

{% endnote %}

Вы можете автоматизировать повторяющиеся задачи и расширить функциональность [чата с Code Assistant](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/code-assistant.md#chat-mode) в интерфейсе SourceCraft с помощью _AI-навыков_.

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

AI-навыки можно запускать в чате с Code Assistant, а также [из CI/CD](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ai-skills.md#run-skill-ci-cd). При запуске из CI/CD навык выполняется в кубике рабочего процесса.

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

Например, с помощью AI-навыков вы можете:
* Пройти интерактивное обучение работе с SourceCraft.
* Запросить помощь с конфигурацией репозитория.
* Декомпозировать [задачу](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#issues).
* Сделать саммари по информации из задачи.
* Собрать контекст ваших действий в репозитории за последние несколько часов.

<iframe width="640" height="360" src="https://runtime.strm.yandex.ru/player/video/vplvnm5w3edfcrns6is3?autoplay=0&mute=0" allow="autoplay; fullscreen; picture-in-picture; encrypted-media" frameborder="0" scrolling="no"></iframe>
<!-- endsource: ru/_includes/sourcecraft/ai-skills-intro.md -->

Подробнее на странице [AI-навыки в SourceCraft](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md).

{% note info %}

В инструкциях описана настройка навыков в интерфейсе SourceCraft. Подробнее о настройке в формате «Configuration as Code» в подразделе [Конфигурационные файлы навыков](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#ai-skills-config).

{% endnote %}

## Запустить навык в интерфейсе SourceCraft {#run-skill}

По умолчанию в любом [репозитории](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/index.md#repos) доступны для запуска только [системные навыки](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#system). Для запуска [навыка из каталога](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#catalog) или [публичного навыка](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#public) вначале [импортируйте](#import-skill) их. Для запуска [пользовательского навыка](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#custom) вначале [создайте](#add-custom-skill) его в репозитории.

Чтобы запустить навык:
1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории**.
1. Выберите репозиторий, в котором вы хотите запустить навык.
1. На левой панели нажмите ![image](../../_assets/code-assistant/chat-logo-src.svg) **Чат Code Assistant**.

    Также вы можете запустить навык из раздела ![image](../../_assets/console-icons/terminal-line.svg) **Автоматизации** в секции ![image](../../_assets/console-icons/sparkles.svg) **AI-навыки**.

1. В правом нижнем углу чата нажмите ![image](../../_assets/sourcecraft/slash-command.svg)</svg> и выберите навык, который вы хотите запустить.

    {% note tip %}

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

    {% endnote %}

1. Нажмите ![image](../../_assets/sourcecraft/send.svg)</svg> или **Enter**.
1. (опционально) Если навыком предусмотрены параметры, введите их или выберите из выпадающего меню и нажмите **Принять**.
1. По ходу работы Code Assistant может задавать вам уточняющие вопросы. Отвечайте на них в чате на естественном языке.

    {% note tip %}

    Если вы передумали и хотите остановить работу Code Assistant, нажмите ![image](../../_assets/console-icons/circle-stop.svg) **Остановить**.

    {% endnote %}

    Дождитесь появления в чате сообщения ![image](../../_assets/console-icons/sparkles.svg) **Работа с навыком закончена**.

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

    <!-- source: ru/_includes/sourcecraft/commit-message.md -->
    1. В правом верхнем углу нажмите **Сохранить изменения**.
    1. В открывшемся окне настройте параметры внесения изменений:

        <!-- source: ru/_includes/sourcecraft/commit-message-settings.md -->
        * В поле **Сообщение об изменениях** укажите комментарий, который опишет внесенные изменения.
        * В блоке **Ветка изменений** выберите, в какую ветку внести изменения. При необходимости создайте новую ветку.
        * В блоке **Действие после сохранения изменений** выберите действие после сохранения изменений: `Сохранить и создать новое предложение изменений` или `Просто сохранить`.
        <!-- endsource: ru/_includes/sourcecraft/commit-message-settings.md -->

    1. Подтвердите внесение изменений.
    <!-- endsource: ru/_includes/sourcecraft/commit-message.md -->

## Запустить навык в CI/CD {#run-skill-ci-cd}

По умолчанию в любом репозитории доступны для запуска только [системные навыки](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#system). Чтобы использовать в CI/CD [навык из каталога](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#catalog) или [публичный навык](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#public), вначале [импортируйте](#import-skill) его. Чтобы использовать [пользовательский навык](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#custom), вначале [создайте](#add-custom-skill) его в репозитории.

Список доступных навыков находится в разделе ![image](../../_assets/console-icons/terminal-line.svg) **Автоматизации** в секции ![image](../../_assets/console-icons/sparkles.svg) **AI-навыки** репозитория.

Чтобы запустить навык в CI/CD-процессе:
1. В файле `.sourcecraft/ci.yaml` добавьте в новое или существующее [задание](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/ci-cd-ref/tasks.md) кубик с параметром `skill`. В значении укажите служебное имя навыка без `/` — команду для запуска из поля `name` файла [SKILL.md](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#skills).
1. Если у навыка есть параметры, передайте их в блоке `with`.

    <!-- source: ru/_includes/sourcecraft/ci-cd/config-with-skill.md -->
    В примере используется навык `issue-summary`, который создает саммари по задаче. Перед запуском [импортируйте навык из каталога](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ai-skills.md#add-from-catalog). В параметре `issue_link` укажите ссылку на нужную задачу.

    ```yaml
    workflows:
      skill-workflow:
        tasks:
          - name: skill-task
            cubes:
              - name: skill-cube
                skill: issue-summary
                with:
                  issue_link: https://sourcecraft.dev/<слаг_организации>/<слаг_репозитория>/issues/<номер_задачи>
    ```

    {% note tip %}

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

    {% endnote %}
    <!-- endsource: ru/_includes/sourcecraft/ci-cd/config-with-skill.md -->

    Подробнее о параметрах кубика в разделе [Кубики (cubes)](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/ci-cd-ref/cubes.md).

1. Сохраните изменения в репозитории.
1. [Запустите](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/run-workflow-manually.md) CI/CD-процесс вручную или дождитесь события-триггера, заданного в его конфигурации.

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

## Импортировать навык {#import-skill}

Вы можете импортировать в свой репозиторий [навык из каталога](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#catalog) или любой [публичный навык](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#public).

{% note warning %}

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

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

{% endnote %}

### Импортировать навык из каталога {#add-from-catalog}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. В верхнем центральном блоке нажмите ![image](../../_assets/console-icons/circles-3-plus.svg) **Просмотреть AI-навыки**.
1. Выберите навык, который вы хотите импортировать.

    Вы можете воспользоваться поиском по названию или ключевому слову, а также отсортировать навыки по команде или названию.
1. В карточке навыка нажмите ![image](../../_assets/console-icons/copy-plus.svg) **Подключить**.

    В каталоге также отображаются [системные навыки](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#system), импортировать их нельзя, поскольку они доступны в любом репозитории по умолчанию.

    {% note tip %}

    Чтобы протестировать навык, нажмите ![image](../../_assets/console-icons/circle-play.svg) **Запустить**.

    {% endnote %}

1. Выберите репозиторий, в который вы хотите импортировать навык.
1. Изучите инструкции и параметры навыка.
1. (опционально) Задайте **Дополнительные инструкции для модели** и **Параметры запуска**.
1. Нажмите **Сохранить**.
1. В открывшемся окне:

    <!-- source: ru/_includes/sourcecraft/commit-message-settings.md -->
    * В поле **Сообщение об изменениях** укажите комментарий, который опишет внесенные изменения.
    * В блоке **Ветка изменений** выберите, в какую ветку внести изменения. При необходимости создайте новую ветку.
    * В блоке **Действие после сохранения изменений** выберите действие после сохранения изменений: `Сохранить и создать новое предложение изменений` или `Просто сохранить`.
    <!-- endsource: ru/_includes/sourcecraft/commit-message-settings.md -->

1. Подтвердите внесение изменений.
1. [Проверьте](#run-skill) работу навыка.

### Импортировать публичный навык {#add-public-skill}

1. [Создайте](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/add-file-repo.md) в репозитории, в котором вы хотите добавить навык, файл [.sourcecraft/ai.yaml](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#ai-yaml) со следующим содержимым:

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

    Где:

    <!-- source: ru/_includes/sourcecraft/ai-skills-import-settings.md -->
    * `source.repo` — путь к публичному репозиторию, из которого импортируется навык, например `examples/skills`;
    * `source.path` — путь к директории с навыком, например `.sourcecraft/skills/issue-summary`;
    * `settings.instructions` — дополнительные инструкции для агента, например `Результат твоей работы должен быть только на английском языке`;
    * `settings.inputs` — параметры навыка по умолчанию, например `config_type: Правила для веток`.
    <!-- endsource: ru/_includes/sourcecraft/ai-skills-import-settings.md -->

1. [Проверьте](#run-skill) работу навыка.

## Настроить системный навык или импортированный навык {#configure-skill}

Для [системных](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#system), [публичных](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#public) и [навыков из каталога](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md#catalog) вы можете настроить дополнительные инструкции и параметры по умолчанию:
1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории**.
1. Выберите репозиторий, в котором вы хотите настроить навык.
1. В разделе ![image](../../_assets/console-icons/terminal-line.svg) **Автоматизации** перейдите в секцию ![image](../../_assets/console-icons/sparkles.svg) **AI-навыки**.
1. Напротив навыка, который вы хотите настроить, нажмите ![image](../../_assets/console-icons/sliders.svg).
1. Задайте **Дополнительные инструкции для модели** и **Параметры запуска**.
1. Нажмите **Сохранить**.
1. В открывшемся окне:

    <!-- source: ru/_includes/sourcecraft/commit-message-settings.md -->
    * В поле **Сообщение об изменениях** укажите комментарий, который опишет внесенные изменения.
    * В блоке **Ветка изменений** выберите, в какую ветку внести изменения. При необходимости создайте новую ветку.
    * В блоке **Действие после сохранения изменений** выберите действие после сохранения изменений: `Сохранить и создать новое предложение изменений` или `Просто сохранить`.
    <!-- endsource: ru/_includes/sourcecraft/commit-message-settings.md -->

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

## Создать пользовательский навык {#add-custom-skill}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории**.
1. Выберите репозиторий, в котором вы хотите создать навык.
1. В разделе ![image](../../_assets/console-icons/terminal-line.svg) **Автоматизации** перейдите в секцию ![image](../../_assets/console-icons/sparkles.svg) **AI-навыки**.
1. В правом верхнем углу нажмите **Новый AI-навык**.
1. В открывшемся окне задайте:
    * **Название**, которое будет отображаться в интерфейсе SourceCraft, например `Саммари по задаче`.
    * **Описание**, например `Создает краткое саммари по задаче. Можно использовать, чтобы быстро разобраться в том, что происходит в больших задачах или задачах с объемной дискуссией в комментариях`.
    * **Команда для запуска**, например `issue-summary`.
    * **Описание для модели** — текстовые инструкции для агента в разметке [Markdown](https://ru.wikipedia.org/wiki/Markdown).

      <!-- source: ru/_includes/sourcecraft/ai-skills-examples-tip.md -->
      {% note tip %}

      Примеры готовых навыков в репозиториях [sourcecraft/ai](https://sourcecraft.dev/sourcecraft/ai) и [examples/skills](https://sourcecraft.dev/examples/skills).

      {% endnote %}
      <!-- endsource: ru/_includes/sourcecraft/ai-skills-examples-tip.md -->

1. (опционально) В блоке **Параметры запуска** нажмите ![image](../../_assets/console-icons/plus.svg) **Добавить параметр** и настройте его:
    1. Выберите тип параметра:
        * ![image](../../_assets/console-icons/font-cursor.svg) **Строка**.
        * ![image](../../_assets/console-icons/list-ul.svg) **Выбор**. Для этого типа параметра добавьте возможные варианты.
        * ![image](../../_assets/console-icons/toggle-on.svg) **Булево**.
    1. Введите название параметра.
    1. (опционально) Выберите или введите значение параметра по умолчанию.
    1. (опционально) Задайте описание параметра.
    1. Укажите, должен ли быть параметр обязательным.

    Чтобы добавить еще один параметр, нажмите ![image](../../_assets/console-icons/plus.svg) **Добавить параметр**.  

    {% note info %}

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

    {% endnote %}

1. Нажмите **Сохранить**.
1. В открывшемся окне:

    <!-- source: ru/_includes/sourcecraft/commit-message-settings.md -->
    * В поле **Сообщение об изменениях** укажите комментарий, который опишет внесенные изменения.
    * В блоке **Ветка изменений** выберите, в какую ветку внести изменения. При необходимости создайте новую ветку.
    * В блоке **Действие после сохранения изменений** выберите действие после сохранения изменений: `Сохранить и создать новое предложение изменений` или `Просто сохранить`.
    <!-- endsource: ru/_includes/sourcecraft/commit-message-settings.md -->

1. Подтвердите внесение изменений.
1. [Проверьте](#run-skill) работу навыка.

## Отредактировать пользовательский навык {#edit-custom-skill}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории**.
1. Выберите репозиторий, в котором вы хотите отредактировать пользовательский навык.
1. В разделе ![image](../../_assets/console-icons/terminal-line.svg) **Автоматизации** перейдите в секцию ![image](../../_assets/console-icons/sparkles.svg) **AI-навыки**.
1. Напротив пользовательского навыка, который вы хотите отредактировать, нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите ![image](../../_assets/console-icons/pencil.svg) **Изменить**.
1. Измените параметры пользовательского навыка. Подробнее в подразделе [Создать пользовательский навык](#add-custom-skill).
1. Нажмите **Сохранить**.
1. В открывшемся окне:

    <!-- source: ru/_includes/sourcecraft/commit-message-settings.md -->
    * В поле **Сообщение об изменениях** укажите комментарий, который опишет внесенные изменения.
    * В блоке **Ветка изменений** выберите, в какую ветку внести изменения. При необходимости создайте новую ветку.
    * В блоке **Действие после сохранения изменений** выберите действие после сохранения изменений: `Сохранить и создать новое предложение изменений` или `Просто сохранить`.
    <!-- endsource: ru/_includes/sourcecraft/commit-message-settings.md -->

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

## Удалить пользовательский или импортированный навык {#remove-skill}

1. Откройте [главную страницу](https://sourcecraft.dev) SourceCraft.
1. На вкладке ![image](../../_assets/console-icons/house.svg) **Домой** в секции ![image](../../_assets/console-icons/layout-tabs.svg) **Ваша мастерская** перейдите в раздел ![image](../../_assets/console-icons/archive.svg) **Репозитории**.
1. Выберите репозиторий, в котором вы хотите удалить навык.
1. В разделе ![image](../../_assets/console-icons/terminal-line.svg) **Автоматизации** перейдите в секцию ![image](../../_assets/console-icons/sparkles.svg) **AI-навыки**.
1. Напротив навыка, который вы хотите удалить, нажмите ![image](../../_assets/console-icons/ellipsis.svg) и выберите ![image](../../_assets/console-icons/trash-bin.svg) **Удалить**.
1. В открывшемся окне:

    <!-- source: ru/_includes/sourcecraft/commit-message-settings.md -->
    * В поле **Сообщение об изменениях** укажите комментарий, который опишет внесенные изменения.
    * В блоке **Ветка изменений** выберите, в какую ветку внести изменения. При необходимости создайте новую ветку.
    * В блоке **Действие после сохранения изменений** выберите действие после сохранения изменений: `Сохранить и создать новое предложение изменений` или `Просто сохранить`.
    <!-- endsource: ru/_includes/sourcecraft/commit-message-settings.md -->

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

#### Полезные ссылки {#see-also}

* [AI-навыки в SourceCraft](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md)
* [Чат с Code Assistant в SourceCraft](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ca-chat.md)
* [Файл AGENTS.md](https://vibe.sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/agentsmd.md)
* [Команды с / (slash commands) в SourceCraft Code Assistant](https://vibe.sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/slash-commands.md)
* [Навыки (skills) в SourceCraft Code Assistant](https://vibe.sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/skills.md)