---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://sourcecraft.dev/portal/docs/en/sourcecraft/concepts/ai-skills.md
  - https://sourcecraft.dev/portal/docs/ru/sourcecraft/concepts/ai-skills.md
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt

# AI-навыки в SourceCraft

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

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

{% endnote %}

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

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

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

Например, с помощью AI-навыков вы можете:
* Пройти интерактивное обучение работе с SourceCraft.
* Запросить помощь с конфигурацией репозитория.
* Декомпозировать [задачу](https://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 -->

В SourceCraft доступны следующие типы AI-навыков:
* _Системные навыки_ — сразу доступны для запуска в любом репозитории без предварительной настройки. Их параметры и инструкции размещены в репозитории [sourcecraft/ai](https://sourcecraft.dev/sourcecraft/ai). {#system}

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

  В пользовательских репозиториях дополнительные инструкции для агента и значения параметров по умолчанию для системных навыков содержатся в файле [.sourcecraft/ai.yaml](#ai-yaml).

* _Навыки из каталога_ — публичные AI-навыки, собранные командой SourceCraft и доступные для запуска после [импорта](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ai-skills.md#add-from-catalog) в конкретный репозиторий. Их параметры и инструкции размещены в репозитории [examples/skills](https://sourcecraft.dev/examples/skills). {#catalog}

  Изменить конфигурацию и инструкции навыков из каталога нельзя, но можно дописать дополнительные инструкции для агента и выбрать значения параметров по умолчанию. 
  
  В пользовательских репозиториях конфигурация импорта содержится в файле [.sourcecraft/ai.yaml](#ai-yaml).

* _Публичные навыки_ — размещенные в любых публичных репозиториях. Доступны после [импорта](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ai-skills.md#add-public-skill) в конкретный репозиторий. {#public}

  Изменить конфигурацию и инструкции импортированных навыков нельзя, но можно дописать дополнительные инструкции для агента и выбрать значения параметров по умолчанию. 
  
  В пользовательских репозиториях конфигурация импорта содержится в файле [.sourcecraft/ai.yaml](#ai-yaml).

* _Пользовательские навыки_ — созданные непосредственно пользователем. Доступны в том репозитории, в котором были созданы. Если репозиторий публичный, то навыки также могут быть [импортированы](https://sourcecraft.dev/portal/docs/ru/sourcecraft/operations/ai-skills.md#add-public-skill) в другой репозиторий. {#custom}

  Вы можете изменить конфигурацию и инструкции в пользовательских навыках. 
  
  Параметры и инструкции размещаются в директории [.sourcecraft/skills/](#skills).

{% note info %}

Системные навыки и навыки из каталога доступны на [главной странице](https://sourcecraft.dev) SourceCraft по кнопке <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" fill="none" viewBox="0 0 16 16"><path fill="currentColor" fill-rule="evenodd" d="M3.047 7.125A3 3 0 1 0 4.5 1.5a3 3 0 0 0-1.453 5.625M4.5 6a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3m-1.453 8.125A3 3 0 1 0 4.5 8.5a3 3 0 0 0-1.453 5.625M4.5 13a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3m7 1.5a3 3 0 1 1 0-6 3 3 0 1 1 0 6m1.5-3a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m-.75-9.25a.75.75 0 0 0-1.5 0v1.501h-1.5a.75.75 0 1 0 0 1.5h1.501v1.502a.75.75 0 0 0 1.5 0V5.25h1.501a.75.75 0 0 0 0-1.5h-1.5z" clip-rule="evenodd"/></svg> **Просмотреть AI-навыки**.

{% endnote %}

## Конфигурационные файлы навыков {#ai-skills-config}

Системные навыки не отображаются в файлах пользовательских репозиториев, их конфигурацию и инструкции вы можете посмотреть в репозитории [sourcecraft/ai](https://sourcecraft.dev/sourcecraft/ai).

Импортированные навыки из каталога или других публичных репозиториев, а также дополнительные инструкции для агента и значения параметров по умолчанию отображаются в файле [.sourcecraft/ai.yaml](#ai-yaml).

Пользовательские навыки размещаются в директории [.sourcecraft/skills/](#skills).

### Конфигурация импортированных навыков {#ai-yaml}

Общий вид файла `.sourcecraft/ai.yaml`:

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

Где:
* `source.name` — команда для запуска системного навыка, например `configs-helper`. Используется, только если надо задать дополнительные инструкции для агента или параметры по умолчанию;

<!-- 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 -->

### Конфигурация пользовательских навыков {#skills}

AI-навык размещается в репозитории по пути `.sourcecraft/skills/<команда_для_запуска>/SKILL.md`. 

Общий вид файла `SKILL.md`:

```text
---
name: <команда_для_запуска>
description: "<описание>"
metadata:
  inputs:
    <параметр_навыка>:
      type: <тип_параметра>
      description: "<описание_параметра>"
      required: <true_или_false>
      options:
        - "<возможное_значение_1>"
        - "<возможное_значение_2>"
  title: <название_навыка>
---

<Текстовые_инструкции_для_агента_в_разметке_Markdown>

```

Где:
* `name` — команда для запуска навыка, например `issue-summary`.
* `description` — описание навыка, например `Создает краткое саммари по задаче. Можно использовать, чтобы быстро разобраться в том, что происходит в больших задачах или задачах с объемной дискуссией в комментариях`.
* `metadata.inputs` — (опционально) параметры навыка, например `issue_link`:
  * `type` — тип параметра, возможные значения:
    * `string` — строка.
    * `bool` — логическое значение `true` или `false`.
    * `choice` — выбор из предустановленных значений. 

    {% note info %}

    Если в конфигурации указан параметр `options`, необязательно задавать параметр `type: choice`.

    Если тип не указан и нет параметра `options`, то тип параметра по умолчанию — `string`.

    {% endnote %}

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

  * `description` — произвольное описание параметра, которое будет отображаться в интерфейсе SourceCraft.
  * `required` — обязательность параметра. Возможные значения: `true` или `false`.
  * `options` — возможные значения для типа параметра `choice`.
* `title` — название навыка, которое будет отображаться в интерфейсе SourceCraft, например `Саммари по задаче`.

<!-- 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 -->

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

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