---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://sourcecraft.dev/portal/docs/en/code-assistant/operations/chat-rules.md
  - https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/chat-rules.md
title: Пользовательские правила в SourceCraft Code Assistant
description: Как создавать и использовать пользовательские правила в SourceCraft Code Assistant для персонализации поведения ассистента.
---
> **Documentation Index:** Fetch the complete configuration index at https://sourcecraft.dev/portal/docs/ru/llms.txt


# Пользовательские правила в SourceCraft Code Assistant

<!-- source: ru/_includes/code-assistant/only-in-vscode.md -->
{% note warning %}

Функциональность доступна только в Visual Studio Code.

{% endnote %}
<!-- endsource: ru/_includes/code-assistant/only-in-vscode.md -->

Пользовательские правила позволяют персонализировать поведение Code Assistant, предоставляя конкретные указания, которые формируют ответы, стиль написания кода, процессы принятия решений, стандарты документации, требования к тестированию, рекомендации по рабочему процессу и прочее.

## Расположение файлов правил {#rules-location}

Вы можете предоставлять пользовательские правила с помощью глобальных правил (применяются ко всем проектам), правил рабочей области (специфичных для проекта) или через интерфейс чата (в верхней панели нажмите <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 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg> и выберите **Modes**).

### Директория с глобальными правилами {#global-rules-location}

Правила из этих директорий применяются ко всем проектам автоматически:
* Linux/macOS: `~/.codeassistant/rules/` и `~/.codeassistant/rules-{modeSlug}/`
* Windows: `%USERPROFILE%\.codeassistant\rules\` и `%USERPROFILE%\.codeassistant\rules-{modeSlug}\`

### Директория для правил рабочей области {#workspace-rules-location}

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

* Предпочтительный метод — директория `.codeassistant/rules/`:

  ```text
  .
  ├── .codeassistant/
  │   └── rules/ # Правила для всей рабочей области
  │       ├── 01-general.md
  │       └── 02-coding-style.txt
  └── ... (другие файлы проекта)
  ```

* Дополнительный метод — файл `.codeassistantrules`:

  ```text
  .
  ├── .codeassistantrules # Правила для всей рабочей области в виде единого файла
  └── ... (другие файлы проекта)
  ```

### Правила для конкретного режима {#mode-rules-location}

Правила из этих директорий применяются только к определенному [режиму](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/chat-prompts.md), например `code`.

* Предпочтительный метод — директория `.codeassistant/rules-{modeSlug}/`:

  ```text
  .
  ├── .codeassistant/
  │   └── rules-code/ # Правила для режима code
  │       ├── 01-js-style.md
  │       └── 02-ts-style.md
  └── ... (другие файлы проекта)
  ```

* Дополнительный метод — файл `.codeassistantrules-{modeSlug}`:

  ```text
  .
  ├── .codeassistantrules-code # Правила для режима code в виде единого файла
  └── ... (другие файлы проекта)
  ```

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

## Установка глобальных пользовательских правил {#install-global-rules}

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


1. На верхней панели чата нажмите нажмите <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 9.5a1.5 1.5 0 1 0 0-3 1.5 1.5 0 0 0 0 3M9.5 8a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0m5 0a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0" clip-rule="evenodd"/></svg> и выберите **Modes**.
1. В блоке **Custom Instructions for All Modes** введите ваши правила.

## Как правила объединяются {#how-rules-are-merged}

Правила размещаются в системном запросе в следующем формате:

```text
====
ПОЛЬЗОВАТЕЛЬСКИЕ ПРАВИЛА

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

Предпочтение языка:
[Предпочтение языка, если установлено]

Глобальные правила:
[Глобальные правила из вкладки Modes]

Правила для конкретного режима:
[Правила для конкретного режима из вкладки Modes для текущего режима]

Правила:

# Правила из директорий rules-{modeSlug}:
[Содержимое ВСЕХ файлов из ~/.codeassistant/rules-{modeSlug}/ И .codeassistant/rules-{modeSlug}/, если они существуют]

# Правила из .codeassistantrules-{modeSlug}:
[Содержимое файла .codeassistantrules-{modeSlug}, если директории для конкретного режима не содержат файлов]

# Правила из .codeassistantignore:
[Правила, связанные с .codeassistantignore, если применимо]

# Стандарт правил агентов (AGENTS.md):
[Содержимое AGENTS.md или AGENT.md из корня рабочей области, если присутствует и включено]

# Правила из директорий rules:
[Содержимое ВСЕХ файлов из ~/.codeassistant/rules/ И .codeassistant/rules/, если они существуют]

# Правила из .codeassistantrules:
[Содержимое файла .codeassistantrules, если директории общих правил не содержат файлов]
====
```

{% note info %}

Система загружает правила из всех применимых директорий (как глобальных `~/.codeassistant/`, так и рабочих `.codeassistant/`), а не только из первой, содержащей файлы. Правила для конкретного режима появляются перед общими правилами. Директории имеют приоритет над резервными файлами только при определении метода, но все применимые директории читаются.

{% endnote %}

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

* [Навыки (skills) в SourceCraft Code Assistant](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/skills.md)
* [Команды с / (slash commands) в SourceCraft Code Assistant](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/agent/slash-commands.md)
* [Использование режимов (modes) в SourceCraft Code Assistant](https://sourcecraft.dev/portal/docs/ru/code-assistant/operations/chat-prompts.md)