> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/ai-assistenty-i-skill.md).

# AI-ассистенты и SKILL

`SKILL.md` позволяет добавить в AI-ассистент постоянные правила работы с документацией iEXExchanger.

После установки навыка ассистент сможет:

* искать инструкции по iEXExchanger;
* открывать полное содержимое найденных страниц;
* сохранять точные названия разделов, полей и параметров;
* учитывать версию продукта и используемое окружение;
* подготавливать инструкции с проверкой результата;
* прикладывать ссылки на использованные страницы;
* сообщать, если в документации нет подтверждённого ответа.

`SKILL.md` не содержит всю документацию внутри себя. Он объясняет ассистенту, где искать информацию, как проверять источники и какие правила соблюдать при подготовке ответа.

{% hint style="info" %}
Навык предназначен для работы с документацией. Он не предоставляет доступ к административной панели, серверу, базе данных, заявкам или другим данным обменного пункта.
{% endhint %}

## Как работает навык

Для полноценной работы используются три компонента:

| Компонент             | Назначение                                           | Обновление                                          |
| --------------------- | ---------------------------------------------------- | --------------------------------------------------- |
| `SKILL.md`            | Задаёт правила поиска, ответа и безопасности         | Скопированную версию нужно обновлять вручную        |
| MCP документации      | Позволяет искать и открывать опубликованные страницы | Использует актуальное содержимое при каждом запросе |
| `llms.txt` и Markdown | Используются, если клиент не поддерживает MCP        | Загруженные копии нужно периодически заменять       |

Рекомендуемый вариант — установить `SKILL.md` и подключить MCP документации. В этом случае навык определяет порядок работы, а MCP предоставляет актуальное содержимое страниц.

{% hint style="warning" %}
Один файл `SKILL.md` не загружает документацию автоматически. Ассистенту также нужен MCP, доступ к страницам документации через интернет или заранее загруженные файлы.
{% endhint %}

## Готовый SKILL.md

Создайте папку `iexexchanger-docs`, добавьте в неё файл `SKILL.md` и скопируйте следующее содержимое.

{% code title="SKILL.md" expandable="true" %}

```markdown
---
name: iexexchanger-docs
description: Используй при вопросах об установке, настройке, эксплуатации, обновлении или диагностике iEXExchanger. Ищи подтверждённые сведения в документации iEXExchanger, сохраняй точные названия элементов и отвечай на русском языке, если пользователь не попросил другой язык.
---

# Документация iEXExchanger

Используй опубликованную документацию iEXExchanger как основной источник информации о продукте.

Не отвечай по памяти, когда точный порядок действий, название настройки, команда, путь, ограничение или поведение можно проверить в документации.

# Источники

Основные источники документации:

- MCP: `https://docs.iexexchanger.com/~gitbook/mcp`
- Индекс документации: `https://docs.iexexchanger.com/llms.txt`
- Полная документация, часть 1: `https://docs.iexexchanger.com/llms-full.txt`
- Полная документация, часть 2: `https://docs.iexexchanger.com/llms-full.txt/2`
- Полная документация, часть 3: `https://docs.iexexchanger.com/llms-full.txt/3`
- Полная документация, часть 4: `https://docs.iexexchanger.com/llms-full.txt/4`

Markdown-версию опубликованной страницы обычно можно открыть, добавив `.md` в конец её адреса.

# Порядок работы

1. Определи точную задачу пользователя.
2. Установи, влияет ли на ответ версия iEXExchanger, операционная система, панель управления сервером или способ установки.
3. Найди относящиеся к задаче страницы документации.
4. Полностью прочитай выбранные страницы, а не только фрагменты поиска.
5. Сопоставь сведения из связанных страниц.
6. Сохрани точные названия разделов, кнопок, полей, вкладок, статусов, команд, файлов, переменных и параметров.
7. Отдели подтверждённое поведение продукта от диагностических предположений.
8. Подготовь конкретную инструкцию и объясни, как проверить результат.
9. Приложи прямые ссылки на использованные страницы.
10. Если подтверждённого ответа нет, прямо укажи, каких сведений не хватает.

# Работа через MCP

Когда доступны инструменты MCP:

- используй `searchDocumentation`, чтобы найти подходящие страницы;
- используй `getPage`, чтобы полностью открыть каждую выбранную страницу;
- используй `askQuestion` только для быстрого поиска ответа с источниками;
- не ограничивайся `askQuestion` при подготовке подробной, многоэтапной или потенциально опасной инструкции;
- вызывай `sendFeedback` только по прямому запросу пользователя.

Перед подробным ответом сначала выполни `searchDocumentation`, затем открой найденные страницы через `getPage`.

Не вызывай `sendFeedback` автоматически. Не передавай через него конфиденциальные или персональные данные.

# Работа без MCP

Если MCP недоступен:

1. Открой `https://docs.iexexchanger.com/llms.txt`.
2. Найди страницу, относящуюся к задаче.
3. Открой Markdown-версию выбранной страницы.
4. Полностью прочитай все связанные страницы.
5. Используй `llms-full.txt` только для задач, охватывающих несколько разделов, или при создании локальной базы знаний.

Не утверждай, что страница изучена, если используемый клиент не может открывать внешние адреса.

# Правила ответа

- Отвечай на русском языке, если пользователь не попросил другой язык.
- Пиши простым техническим языком.
- Сохраняй точные названия элементов интерфейса.
- Не переименовывай кнопки, поля, вкладки, статусы и права.
- Не смешивай разные версии iEXExchanger.
- Не смешивай разные операционные системы, панели управления сервером и способы установки.
- Не придумывай маршруты, команды, порты, пути, переменные, значения по умолчанию, права, ограничения или статусы.
- Не добавляй функцию только потому, что она обычно встречается в похожих продуктах.
- Для последовательных действий используй нумерованный список.
- Для каждой практической инструкции указывай ожидаемый результат и конкретный способ проверки.
- В конце ответа перечисляй использованные страницы со ссылками.

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

# Работа с сервером

Перед рекомендацией действия, которое может изменить рабочий сервер:

1. Начни с безопасной диагностики без изменения данных.
2. Объясни назначение команды или настройки.
3. Укажи ожидаемый результат.
4. Предупреди о подтверждённых рисках.
5. Потребуй актуальную резервную копию, если действие может повлиять на данные или доступность проекта.
6. Добавь способ проверки результата.
7. Укажи способ возврата только тогда, когда он подтверждён документацией.

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

# Ограничения доступа

Документация не предоставляет доступ к:

- административной панели iEXExchanger;
- SSH и системным службам;
- панели управления сервером;
- базе данных;
- рабочему файлу `.env`;
- файлам Frontend и Backend;
- заявкам и данным клиентов;
- резервам и реквизитам;
- API-ключам и токенам;
- лицензии;
- персональным и платёжным данным.

Не создавай впечатление, что MCP или документация позволяют изменить обменный пункт.

# Безопасность

Никогда не проси пользователя передавать реальные:

- пароли;
- seed-фразы;
- приватные ключи;
- SSH-ключи;
- API-токены;
- данные мерчантов;
- пароли базы данных;
- данные SMTP;
- платёжные реквизиты;
- персональные документы;
- данные клиентов;
- содержимое реальных заявок.

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

{% endcode %}

Название папки должно совпадать со значением `name`:

```
iexexchanger-docs
```

Итоговая структура:

```
iexexchanger-docs/
└── SKILL.md
```

Не добавляйте в `SKILL.md` пароли, токены, приватные адреса или другие секретные данные.

## Установка навыка

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

{% tabs %}
{% tab title="Claude" icon="claude" %}
Для использования навыка только в одном проекте сохраните файл по пути:

```
.claude/skills/iexexchanger-docs/SKILL.md
```

Для использования во всех проектах текущего пользователя:

```
~/.claude/skills/iexexchanger-docs/SKILL.md
```

После добавления файла откройте Claude Code и явно запустите навык:

```
/iexexchanger-docs
```

Claude Code также может применить навык автоматически, когда запрос соответствует его описанию.

Если каталог `.claude/skills` был создан после запуска текущей сессии и навык не появился, перезапустите Claude Code.

Подробнее: [навыки Claude Code](https://code.claude.com/docs/en/skills).
{% endtab %}

{% tab title="Codex" icon="openai" %}
Для использования навыка в одном проекте сохраните файл по пути:

```
.agents/skills/iexexchanger-docs/SKILL.md
```

Для использования во всех проектах текущего пользователя:

```
~/.agents/skills/iexexchanger-docs/SKILL.md
```

Откройте Codex и выполните:

```
/skills
```

Убедитесь, что `iexexchanger-docs` появился в списке.

Для явного применения навыка укажите его в запросе:

```
$iexexchanger-docs
```

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

Изменения в навыках обычно обнаруживаются автоматически. Если новый файл не появился, перезапустите Codex.

Подробнее: [навыки Codex](https://developers.openai.com/codex/build-skills).
{% endtab %}

{% tab title="Cursor" icon="cursor" %}
Для использования в текущем проекте сохраните файл по пути:

```
.cursor/skills/iexexchanger-docs/SKILL.md
```

Для использования во всех проектах текущего пользователя:

```
~/.cursor/skills/iexexchanger-docs/SKILL.md
```

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

```
.agents/skills/iexexchanger-docs/SKILL.md
```

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

После добавления файла:

1. Откройте настройки Cursor.
2. Перейдите в раздел **Skills**.
3. Найдите `iexexchanger-docs`.
4. Откройте новый Agent Chat.
5. Выполните `/iexexchanger-docs`.

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

Подробнее: [навыки Cursor](https://cursor.com/docs/skills).
{% endtab %}

{% tab title="VS Code" icon="vscode" %}
Для текущего проекта рекомендуется использовать путь:

```
.agents/skills/iexexchanger-docs/SKILL.md
```

Также VS Code поддерживает проектный путь:

```
.github/skills/iexexchanger-docs/SKILL.md
```

Для использования во всех проектах текущего пользователя:

```
~/.agents/skills/iexexchanger-docs/SKILL.md
```

Также поддерживается пользовательский путь:

```
~/.copilot/skills/iexexchanger-docs/SKILL.md
```

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

После добавления файла:

1. Откройте Chat.
2. Введите `/skills`.
3. Откройте список доступных навыков.
4. Найдите `iexexchanger-docs`.
5. Начните новый диалог.

Для явного запуска выберите навык из списка команд или введите его название после `/`.

Подробнее: [Agent Skills в VS Code](https://code.visualstudio.com/docs/agent-customization/agent-skills).
{% endtab %}

{% tab title="Другой клиент" %}
Если клиент поддерживает стандарт Agent Skills, сохраните папку `iexexchanger-docs` в каталоге навыков, указанном в его документации.

Структура должна выглядеть так:

```
папка_навыков/
└── iexexchanger-docs/
    └── SKILL.md
```

Если клиент не поддерживает навыки:

1. Прикрепите `SKILL.md` к проекту или диалогу.
2. Добавьте его содержимое в постоянные инструкции.
3. Укажите, что правила относятся ко всем вопросам по iEXExchanger.
4. Подключите MCP или предоставьте нужные страницы документации.

Наличие файла с именем `SKILL.md` само по себе не означает, что клиент его использует. Клиент должен поддерживать навыки или получить прямое указание прочитать файл.
{% endtab %}
{% endtabs %}

## Подключение документации

После установки навыка подключите MCP документации iEXExchanger.

Используйте следующий адрес:

```
https://docs.iexexchanger.com/~gitbook/mcp
```

Через MCP ассистент сможет:

* искать страницы;
* открывать полное содержимое найденных материалов;
* получать актуальную опубликованную версию;
* прикладывать ссылки на источники.

Если MCP не поддерживается, используйте индекс:

```
https://docs.iexexchanger.com/llms.txt
```

Для загрузки полного содержимого доступны:

```
https://docs.iexexchanger.com/llms-full.txt
https://docs.iexexchanger.com/llms-full.txt/2
https://docs.iexexchanger.com/llms-full.txt/3
https://docs.iexexchanger.com/llms-full.txt/4
```

Не загружайте все части без необходимости. Для одного вопроса обычно достаточно `llms.txt` и нескольких связанных Markdown-страниц.

## Проверка навыка

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

{% prompt description="Проверка навыка iEXExchanger" icon="file-code" %}

```markdown
Примени навык iexexchanger-docs.

Найди в документации iEXExchanger инструкцию по созданию валюты.

Укажи:

1. Что нужно подготовить до создания.
2. Точные названия действий и полей.
3. Как проверить результат.
4. Прямые ссылки на использованные страницы.

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

{% endprompt %}

Навык работает корректно, если ассистент:

* обратился к документации iEXExchanger;
* прочитал полную страницу;
* сохранил точные названия элементов интерфейса;
* не добавил неподтверждённые параметры;
* объяснил способ проверки;
* приложил прямые ссылки на источники;
* сообщил о недостатке информации, если точного ответа нет.

## Примеры запросов

{% prompt description="Найти настройку" %}

```markdown
Примени навык iexexchanger-docs.

Найди в документации iEXExchanger, где настраивается автоматическое обновление курсов.

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

Не добавляй настройки, которых нет в документации.
```

{% endprompt %}

{% prompt description="Подготовить инструкцию" icon="list-check" %}

```markdown
Примени навык iexexchanger-docs.

Подготовь инструкцию по настройке Nginx для Frontend и Backend iEXExchanger.

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

Для каждого этапа укажи ожидаемый результат и конкретный способ проверки.
```

{% endprompt %}

{% prompt description="Найти причину проблемы" icon="triangle-exclamation" %}

```markdown
Примени навык iexexchanger-docs.

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

Сначала перечисли безопасные проверки.

Отдели сведения из документации от диагностических предположений и приложи ссылки на использованные страницы.
```

{% endprompt %}

{% prompt description="Проверить инструкцию" icon="shield-check" %}

```markdown
Примени навык iexexchanger-docs.

Проверь следующую инструкцию по iEXExchanger по актуальной документации.

Отдельно укажи:

1. Какие действия подтверждены.
2. Какие действия противоречат документации.
3. Какие сведения не удалось проверить.
4. Какие страницы использовались.

Не исправляй инструкцию предположениями.
```

{% endprompt %}

## Обновление навыка

Скопированный `SKILL.md` не обновляется автоматически.

После публикации новой версии навыка:

1. Замените старый файл `SKILL.md`.
2. Проверьте, что имя папки осталось `iexexchanger-docs`.
3. Удалите лишние копии навыка.
4. Начните новый диалог.
5. Повторите проверочный запрос.

Документация, которую ассистент получает через MCP, обновляется отдельно и не хранится внутри `SKILL.md`.

## Безопасность

Не передавайте AI-ассистенту реальные:

* пароли;
* seed-фразы;
* приватные ключи;
* SSH-ключи;
* API-токены;
* данные мерчантов;
* пароли базы данных;
* данные SMTP;
* платёжные реквизиты;
* документы клиентов;
* персональные данные;
* данные реальных заявок;
* рабочий файл `.env`.

Проверяйте прикреплённые файлы, снимки экрана, журналы и вывод терминала. Они также могут содержать секретные значения.

{% hint style="danger" %}
Не разрешайте ассистенту автоматически удалять файлы, восстанавливать базу данных, изменять SSH, Firewall или рабочую конфигурацию сервера без проверки человеком, понимания последствий и актуальной резервной копии.
{% endhint %}

## Решение проблем

### Навык не появился в клиенте

**Симптом:** `iexexchanger-docs` отсутствует в списке навыков.

**Что проверить:**

* файл называется точно `SKILL.md`;
* файл находится внутри папки `iexexchanger-docs`;
* выбран правильный каталог для используемого клиента;
* во frontmatter указаны `name` и `description`;
* значение `name` совпадает с названием папки;
* файл сохранён в формате Markdown;
* нет второй копии навыка с тем же именем.

Для Codex итоговый путь должен выглядеть так:

```
.agents/skills/iexexchanger-docs/SKILL.md
```

Для Claude Code:

```
.claude/skills/iexexchanger-docs/SKILL.md
```

Для Cursor:

```
.cursor/skills/iexexchanger-docs/SKILL.md
```

После проверки начните новую сессию или перезапустите клиент.

**Проверка результата:** `iexexchanger-docs` должен появиться в списке доступных навыков.

### Навык установлен, но не применяется автоматически

**Симптом:** ассистент отвечает без поиска в документации.

**Причина:** запрос не совпал с описанием навыка или клиент выбрал другой источник.

**Как исправить:** запустите навык явно.

Для Claude Code и Cursor:

```
/iexexchanger-docs
```

Для Codex:

```
$iexexchanger-docs
```

Затем повторите вопрос.

**Проверка результата:** ассистент должен обратиться к документации и приложить ссылки на использованные страницы.

### Ассистент отвечает общими словами

**Симптом:** ответ не содержит точных названий, действий и ссылок.

**Что проверить:**

* навык действительно загружен;
* MCP подключён;
* клиент имеет доступ к интернету;
* страницы были полностью открыты;
* запрос содержит конкретную задачу;
* ассистенту передана версия iEXExchanger и окружение, если они влияют на ответ.

Явно укажите:

```
Примени навык iexexchanger-docs.
Сначала найди страницы документации, затем полностью прочитай их и приложи ссылки.
```

**Проверка результата:** ответ должен содержать подтверждённую инструкцию и прямые ссылки.

### MCP недоступен

**Симптом:** ассистент не может использовать `searchDocumentation` или `getPage`.

**Причина:** MCP-сервер не подключён, отключён или не поддерживается клиентом.

**Как исправить:** подключите MCP по инструкции «MCP документации iEXExchanger».

Если клиент не поддерживает MCP, передайте ему:

```
https://docs.iexexchanger.com/llms.txt
```

Затем добавьте Markdown-страницы, относящиеся к задаче.

**Проверка результата:** ассистент должен открыть страницы документации и сослаться на них в ответе.

### Используется устаревшая копия навыка

**Симптом:** ассистент применяет старые источники или правила.

**Причина:** в проекте или пользовательском каталоге осталась предыдущая версия `SKILL.md`.

**Что проверить:**

* проектный каталог навыков;
* пользовательский каталог навыков;
* другие совместимые каталоги;
* одинаковые навыки с именем `iexexchanger-docs`.

Удалите лишние копии и оставьте только актуальную версию.

После замены файла начните новый диалог.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/nachalo-raboty/rabota-s-ai/ai-assistenty-i-skill.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.