@neurocode-ai/web 1.18.8

package/src/content/docs/ru/server.mdx

@@ -0,0 +1,287 @@
+---
+title: Сервер
+description: Взаимодействуйте с сервером opencode через HTTP.
+---
+
+import config from "../../../../config.mjs"
+export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
+
+Команда `opencode serve` запускает автономный HTTP-сервер, который предоставляет конечную точку OpenAPI, которую может использовать клиент с открытым кодом.
+
+---
+
+### Использование
+
+```bash
+opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]
+```
+
+#### Параметры
+
+| Флаг            | Описание                                    | По умолчанию     |
+| --------------- | ------------------------------------------- | ---------------- |
+| `--port`        | Порт для прослушивания                      | `4096`           |
+| `--hostname`    | Имя хоста для прослушивания                 | `127.0.0.1`      |
+| `--mdns`        | Включить обнаружение mDNS                   | `false`          |
+| `--mdns-domain` | Пользовательское доменное имя для mDNS      | `opencode.local` |
+| `--cors`        | Разрешенные дополнительные источники (CORS) | `[]`             |
+
+`--cors` можно передать несколько раз:
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### Аутентификация
+
+Установите `OPENCODE_SERVER_PASSWORD`, чтобы защитить сервер с помощью базовой аутентификации HTTP. Имя пользователя по умолчанию — `opencode` или установите `OPENCODE_SERVER_USERNAME`, чтобы переопределить его. Это относится как к `opencode serve`, так и к `opencode web`.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### Как это работает
+
+Когда вы запускаете `opencode`, он запускает TUI и сервер. Где находится TUI
+клиент, который общается с сервером. Сервер предоставляет спецификацию OpenAPI 3.1.
+конечная точка. Эта конечная точка также используется для создания файла [SDK](/docs/sdk).
+
+:::tip
+Используйте сервер opencode для программного взаимодействия с открытым кодом.
+:::
+
+Эта архитектура позволяет открытому коду поддерживать несколько клиентов и позволяет программно взаимодействовать с открытым кодом.
+
+Вы можете запустить `opencode serve`, чтобы запустить автономный сервер. Если у вас есть
+TUI с открытым кодом запущен, `opencode serve` запустит новый сервер.
+
+---
+
+#### Подключиться к существующему серверу
+
+Когда вы запускаете TUI, он случайным образом назначает порт и имя хоста. Вместо этого вы можете передать `--hostname` и `--port` [flags](/docs/cli). Затем используйте это для подключения к его серверу.
+
+Конечную точку [`/tui`](#tui) можно использовать для управления TUI через сервер. Например, вы можете предварительно заполнить или запустить подсказку. Эта настройка используется плагинами opencode [IDE](/docs/ide).
+
+---
+
+## Спецификация
+
+Сервер публикует спецификацию OpenAPI 3.1, которую можно просмотреть по адресу:
+
+```
+http://<hostname>:<port>/doc
+```
+
+For example, `http://localhost:4096/doc`. Use the spec to generate clients or inspect request and response types. Or view it in a Swagger explorer.
+
+---
+
+## API
+
+Сервер opencode предоставляет следующие API.
+
+---
+
+### Глобальный
+
+| Метод | Путь             | Описание                                | Ответ                                |
+| ----- | ---------------- | --------------------------------------- | ------------------------------------ |
+| `GET` | `/global/health` | Получить состояние и версию сервера     | `{ healthy: true, version: string }` |
+| `GET` | `/global/event`  | Получить глобальные события (поток SSE) | Поток событий                        |
+
+---
+
+### Проект
+
+| Метод | Путь               | Описание                | Ответ                                         |
+| ----- | ------------------ | ----------------------- | --------------------------------------------- |
+| `GET` | `/project`         | Список всех проектов    | <a href={typesUrl}><code>Project[]</code></a> |
+| `GET` | `/project/current` | Получить текущий проект | <a href={typesUrl}><code>Project</code></a>   |
+
+---
+
+### Путь и система контроля версий
+
+| Метод | Путь    | Описание                                       | Ответ                                       |
+| ----- | ------- | ---------------------------------------------- | ------------------------------------------- |
+| `GET` | `/path` | Получить текущий путь                          | <a href={typesUrl}><code>Path</code></a>    |
+| `GET` | `/vcs`  | Получить информацию о VCS для текущего проекта | <a href={typesUrl}><code>VcsInfo</code></a> |
+
+---
+
+### Экземпляр
+
+| Метод  | Путь                | Описание                  | Ответ     |
+| ------ | ------------------- | ------------------------- | --------- |
+| `POST` | `/instance/dispose` | Удалить текущий экземпляр | `boolean` |
+
+---
+
+### Конфигурация
+
+| Метод   | Путь                | Описание                                  | Ответ                                                                                    |
+| ------- | ------------------- | ----------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `GET`   | `/config`           | Получить информацию о конфигурации        | <a href={typesUrl}><code>Config</code></a>                                               |
+| `PATCH` | `/config`           | Обновить конфигурацию                     | <a href={typesUrl}><code>Config</code></a>                                               |
+| `GET`   | `/config/providers` | Список провайдеров и моделей по умолчанию | `{ providers: `<a href={typesUrl}>Provider[]</a>`, default: { [key: string]: string } }` |
+
+---
+
+### Поставщик
+
+| Метод  | Путь                             | Описание                                  | Ответ                                                                               |
+| ------ | -------------------------------- | ----------------------------------------- | ----------------------------------------------------------------------------------- |
+| `GET`  | `/provider`                      | Список всех провайдеров                   | `{ all: `<a href={typesUrl}>Provider[]</a>`, default: {...}, connected: string[] }` |
+| `GET`  | `/provider/auth`                 | Получить методы аутентификации провайдера | `{ [providerID: string]: `<a href={typesUrl}>ProviderAuthMethod[]</a>` }`           |
+| `POST` | `/provider/{id}/oauth/authorize` | Авторизация провайдера через OAuth        | <a href={typesUrl}><code>ProviderAuthAuthorization</code></a>                       |
+| `POST` | `/provider/{id}/oauth/callback`  | Обработка callback OAuth для провайдера   | `boolean`                                                                           |
+
+---
+
+### Сессии
+
+| Метод    | Путь                                     | Описание                                 | Примечания                                                                            |
+| -------- | ---------------------------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------- |
+| `GET`    | `/session`                               | Список всех сессий                       | Возвращает <a href={typesUrl}><code>Session[]</code></a>                              |
+| `POST`   | `/session`                               | Создать новую сессию                     | body: `{ parentID?, title? }`, возвращает <a href={typesUrl}><code>Session</code></a> |
+| `GET`    | `/session/status`                        | Получить статус всех сессий              | Возвращает `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }`          |
+| `GET`    | `/session/:id`                           | Получить детали сессии                   | Возвращает <a href={typesUrl}><code>Session</code></a>                                |
+| `DELETE` | `/session/:id`                           | Удалить сессию и все её данные           | Возвращает `boolean`                                                                  |
+| `PATCH`  | `/session/:id`                           | Обновить свойства сессии                 | body: `{ title? }`, возвращает <a href={typesUrl}><code>Session</code></a>            |
+| `GET`    | `/session/:id/children`                  | Получить дочерние сессии                 | Возвращает <a href={typesUrl}><code>Session[]</code></a>                              |
+| `GET`    | `/session/:id/todo`                      | Получить список задач для сессии         | Возвращает <a href={typesUrl}><code>Todo[]</code></a>                                 |
+| `POST`   | `/session/:id/init`                      | Анализ приложения и создание `AGENTS.md` | body: `{ messageID, providerID, modelID }`, возвращает `boolean`                      |
+| `POST`   | `/session/:id/fork`                      | Ответвление сессии от сообщения          | body: `{ messageID? }`, возвращает <a href={typesUrl}><code>Session</code></a>        |
+| `POST`   | `/session/:id/abort`                     | Прервать запущенную сессию               | Возвращает `boolean`                                                                  |
+| `POST`   | `/session/:id/share`                     | Поделиться сессией                       | Возвращает <a href={typesUrl}><code>Session</code></a>                                |
+| `DELETE` | `/session/:id/share`                     | Отменить общий доступ к сессии           | Возвращает <a href={typesUrl}><code>Session</code></a>                                |
+| `GET`    | `/session/:id/diff`                      | Получить diff для этой сессии            | query: `messageID?`, возвращает <a href={typesUrl}><code>FileDiff[]</code></a>        |
+| `POST`   | `/session/:id/summarize`                 | Суммировать сессию                       | body: `{ providerID, modelID }`, возвращает `boolean`                                 |
+| `POST`   | `/session/:id/revert`                    | Отменить сообщение                       | body: `{ messageID, partID? }`, возвращает `boolean`                                  |
+| `POST`   | `/session/:id/unrevert`                  | Восстановить все отмененные сообщения    | Возвращает `boolean`                                                                  |
+| `POST`   | `/session/:id/permissions/:permissionID` | Ответить на запрос разрешения            | body: `{ response, remember? }`, возвращает `boolean`                                 |
+
+---
+
+### Сообщения
+
+| Метод  | Путь                              | Описание                                      | Примечания                                                                                                                                                               |
+| ------ | --------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `GET`  | `/session/:id/message`            | Список сообщений в сессии                     | query: `limit?`, возвращает `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}[]`                                                        |
+| `POST` | `/session/:id/message`            | Отправить сообщение и ждать ответа            | body: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, возвращает `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
+| `GET`  | `/session/:id/message/:messageID` | Получить детали сообщения                     | Возвращает `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                                                           |
+| `POST` | `/session/:id/prompt_async`       | Отправить сообщение асинхронно (без ожидания) | body: как в `/session/:id/message`, возвращает `204 No Content`                                                                                                          |
+| `POST` | `/session/:id/command`            | Выполнить слэш-команду                        | body: `{ messageID?, agent?, model?, command, arguments }`, возвращает `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`               |
+| `POST` | `/session/:id/shell`              | Запустить команду оболочки                    | body: `{ agent, model?, command }`, возвращает `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                       |
+
+---
+
+### Команды
+
+| Метод | Путь       | Описание           | Ответ                                         |
+| ----- | ---------- | ------------------ | --------------------------------------------- |
+| `GET` | `/command` | Список всех команд | <a href={typesUrl}><code>Command[]</code></a> |
+
+---
+
+### Файлы
+
+| Метод | Путь                     | Описание                             | Ответ                                                                                        |
+| ----- | ------------------------ | ------------------------------------ | -------------------------------------------------------------------------------------------- |
+| `GET` | `/find?pattern=<pat>`    | Поиск текста в файлах                | Массив объектов совпадения с `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
+| `GET` | `/find/file?query=<q>`   | Поиск файлов и директорий по имени   | `string[]` (пути)                                                                            |
+| `GET` | `/find/symbol?query=<q>` | Поиск символов рабочего пространства | <a href={typesUrl}><code>Symbol[]</code></a>                                                 |
+| `GET` | `/file?path=<path>`      | Список файлов и директорий           | <a href={typesUrl}><code>FileNode[]</code></a>                                               |
+| `GET` | `/file/content?path=<p>` | Прочитать файл                       | <a href={typesUrl}><code>FileContent</code></a>                                              |
+| `GET` | `/file/status`           | Получить статус отслеживаемых файлов | <a href={typesUrl}><code>File[]</code></a>                                                   |
+
+#### `/find/file` параметры запроса
+
+- `query` (обязательно) — строка поиска (нечеткое совпадение)
+- `type` (необязательно) — ограничить результаты `"file"` или `"directory"`.
+- `directory` (необязательно) — переопределить корень проекта для поиска.
+- `limit` (необязательно) — максимальное количество результатов (1–200)
+- `dirs` (необязательно) — устаревший флаг (`"false"` возвращает только файлы)
+
+---
+
+### Инструменты (Экспериментальные)
+
+| Метод | Путь                                        | Описание                                       | Ответ                                        |
+| ----- | ------------------------------------------- | ---------------------------------------------- | -------------------------------------------- |
+| `GET` | `/experimental/tool/ids`                    | Список всех идентификаторов инструментов       | <a href={typesUrl}><code>ToolIDs</code></a>  |
+| `GET` | `/experimental/tool?provider=<p>&model=<m>` | Список инструментов со схемами JSON для модели | <a href={typesUrl}><code>ToolList</code></a> |
+
+---
+
+### LSP, форматтеры и MCP
+
+| Метод  | Путь         | Описание                        | Ответ                                                    |
+| ------ | ------------ | ------------------------------- | -------------------------------------------------------- |
+| `GET`  | `/lsp`       | Получить статус сервера LSP     | <a href={typesUrl}><code>LSPStatus[]</code></a>          |
+| `GET`  | `/formatter` | Получить статус форматера       | <a href={typesUrl}><code>FormatterStatus[]</code></a>    |
+| `GET`  | `/mcp`       | Получить статус сервера MCP     | `{ [name: string]: `<a href={typesUrl}>MCPStatus</a>` }` |
+| `POST` | `/mcp`       | Добавить сервер MCP динамически | body: `{ name, config }`, возвращает статус объекта MCP  |
+
+---
+
+### Агенты
+
+| Метод | Путь     | Описание                      | Ответ                                       |
+| ----- | -------- | ----------------------------- | ------------------------------------------- |
+| `GET` | `/agent` | Список всех доступных агентов | <a href={typesUrl}><code>Agent[]</code></a> |
+
+---
+
+### Ведение журнала
+
+| Метод  | Путь   | Описание                                                              | Ответ     |
+| ------ | ------ | --------------------------------------------------------------------- | --------- |
+| `POST` | `/log` | Записать запись в журнал. Body: `{ service, level, message, extra? }` | `boolean` |
+
+---
+
+### TUI
+
+| Метод  | Путь                    | Описание                                              | Ответ                     |
+| ------ | ----------------------- | ----------------------------------------------------- | ------------------------- |
+| `POST` | `/tui/append-prompt`    | Добавить текст в подсказку                            | `boolean`                 |
+| `POST` | `/tui/open-help`        | Открыть диалог помощи                                 | `boolean`                 |
+| `POST` | `/tui/open-sessions`    | Открыть селектор сессий                               | `boolean`                 |
+| `POST` | `/tui/open-themes`      | Открыть селектор тем                                  | `boolean`                 |
+| `POST` | `/tui/open-models`      | Открыть селектор моделей                              | `boolean`                 |
+| `POST` | `/tui/submit-prompt`    | Отправить текущую подсказку                           | `boolean`                 |
+| `POST` | `/tui/clear-prompt`     | Очистить подсказку                                    | `boolean`                 |
+| `POST` | `/tui/execute-command`  | Выполнить команду (`{ command }`)                     | `boolean`                 |
+| `POST` | `/tui/show-toast`       | Показать уведомление (`{ title?, message, variant }`) | `boolean`                 |
+| `GET`  | `/tui/control/next`     | Ожидание следующего запроса управления                | Объект запроса управления |
+| `POST` | `/tui/control/response` | Ответить на запрос управления (`{ body }`)            | `boolean`                 |
+
+---
+
+### Авторизация
+
+| Метод | Путь        | Описание                                                                               | Ответ     |
+| ----- | ----------- | -------------------------------------------------------------------------------------- | --------- |
+| `PUT` | `/auth/:id` | Установить учетные данные аутентификации. Body должен соответствовать схеме провайдера | `boolean` |
+
+---
+
+### События
+
+| Метод | Путь     | Описание                                                                                      | Ответ                                |
+| ----- | -------- | --------------------------------------------------------------------------------------------- | ------------------------------------ |
+| `GET` | `/event` | Поток событий, отправляемых сервером. Первое событие — `server.connected`, затем события шины | Поток событий, отправляемых сервером |
+
+---
+
+### Документы
+
+| Метод | Путь   | Описание                 | Ответ                                  |
+| ----- | ------ | ------------------------ | -------------------------------------- |
+| `GET` | `/doc` | Спецификация OpenAPI 3.1 | HTML-страница со спецификацией OpenAPI |

package/src/content/docs/ru/share.mdx

@@ -0,0 +1,128 @@
+---
+title: Делиться
+description: Поделитесь своими разговорами об opencode.
+---
+
+Функция общего доступа opencode позволяет вам создавать общедоступные ссылки на ваши беседы opencode, чтобы вы могли сотрудничать с товарищами по команде или получать помощь от других.
+
+:::note
+Общие беседы общедоступны для всех, у кого есть ссылка.
+:::
+
+---
+
+## Как это работает
+
+Когда вы делитесь беседой, opencode:
+
+1. Создает уникальный общедоступный URL-адрес для вашего сеанса.
+2. Синхронизирует историю ваших разговоров с нашими серверами
+3. Делает беседу доступной по общей ссылке — `opncd.ai/s/<share-id>`.
+
+---
+
+## Совместное использование
+
+opencode поддерживает три режима общего доступа, которые контролируют общий доступ к разговорам:
+
+---
+
+### Ручной (по умолчанию)
+
+По умолчанию opencode использует режим совместного использования вручную. Сессии не передаются автоматически, но вы можете поделиться ими вручную с помощью команды `/share`:
+
+```
+/share
+```
+
+Это создаст уникальный URL-адрес, который будет скопирован в буфер обмена.
+
+Чтобы явно установить ручной режим в вашем [файле конфигурации](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "manual"
+}
+```
+
+---
+
+### Автоматическая публикация
+
+Вы можете включить автоматический общий доступ для всех новых разговоров, установив для параметра `share` значение `"auto"` в вашем [файле конфигурации](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto"
+}
+```
+
+Если функция автоматического обмена включена, каждый новый разговор будет автоматически опубликован и будет создана ссылка.
+
+---
+
+### Отключено
+
+Вы можете полностью отключить общий доступ, установив для параметра `share` значение `"disabled"` в вашем [файле конфигурации](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+Чтобы обеспечить соблюдение этого правила для всей вашей команды в конкретном проекте, добавьте его в `opencode.json` вашего проекта и зарегистрируйтесь в Git.
+
+---
+
+## Отменить совместное использование
+
+Чтобы прекратить делиться беседой и удалить ее из общего доступа:
+
+```
+/unshare
+```
+
+Это приведет к удалению ссылки общего доступа и удалению данных, связанных с разговором.
+
+---
+
+## Конфиденциальность
+
+Есть несколько вещей, которые следует учитывать при общении.
+
+---
+
+### Хранение данных
+
+Общие разговоры остаются доступными до тех пор, пока вы явно не отмените общий доступ к ним. Этот
+включает в себя:
+
+- Полная история разговоров
+- Все сообщения и ответы
+- Метаданные сеанса
+
+---
+
+### Рекомендации
+
+- Делитесь только разговорами, которые не содержат конфиденциальной информации.
+- Прежде чем поделиться, просмотрите содержимое разговора.
+- Отмените общий доступ к разговорам после завершения сотрудничества.
+- Избегайте обмена разговорами с проприетарным кодом или конфиденциальными данными.
+- Для конфиденциальных проектов полностью отключите общий доступ.
+
+---
+
+## Для предприятий
+
+Для корпоративных развертываний функция общего доступа может быть:
+
+- **Отключено** полностью из соображений безопасности.
+- **Доступно только** для пользователей, прошедших аутентификацию посредством единого входа.
+- **Автономное размещение** в вашей собственной инфраструктуре
+
+[Узнайте больше](/docs/enterprise) об использовании opencode в вашей организации.

package/src/content/docs/ru/skills.mdx

@@ -0,0 +1,222 @@
+---
+title: Навыки агента
+description: Определите повторно используемое поведение с помощью определений SKILL.md
+---
+
+Навыки агента позволяют opencode обнаруживать многократно используемые инструкции из вашего репозитория или домашнего каталога.
+Навыки загружаются по требованию с помощью встроенного инструмента `skill`: агенты видят доступные навыки и при необходимости могут загрузить весь контент.
+
+---
+
+## Разместить файлы
+
+Создайте одну папку для каждого имени навыка и поместите в нее `SKILL.md`.
+opencode выполняет поиск в следующих местах:
+
+- Конфигурация проекта: `.opencode/skills/<name>/SKILL.md`
+- Глобальная конфигурация: `~/.config/opencode/skills/<name>/SKILL.md`.
+- Совместимость с Project Claude: `.claude/skills/<name>/SKILL.md`
+- Глобальная совместимость с Claude: `~/.claude/skills/<name>/SKILL.md`
+- Совместимость с агентом проекта: `.agents/skills/<name>/SKILL.md`
+- Совместимость с глобальным агентом: `~/.agents/skills/<name>/SKILL.md`
+
+---
+
+## Понимание обнаружения
+
+Для локальных путей проекта opencode переходит из вашего текущего рабочего каталога, пока не достигнет рабочего дерева git.
+Он загружает все соответствующие `skills/*/SKILL.md` в `.opencode/` и все соответствующие `.claude/skills/*/SKILL.md` или `.agents/skills/*/SKILL.md` по пути.
+
+Глобальные определения также загружаются из `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` и `~/.agents/skills/*/SKILL.md`.
+
+---
+
+## Напишите заголовок
+
+Каждый `SKILL.md` должен начинаться с заголовка YAML.
+Распознаются только эти поля:
+
+- `name` (required)
+- `description` (required)
+- `license` (необязательно)
+- `compatibility` (необязательно)
+- `metadata` (необязательно, преобразование строк в строки)
+
+Неизвестные поля заголовка игнорируются.
+
+---
+
+## Проверка имен
+
+`name` должен:
+
+- Длина от 1 до 64 символов.
+- Используйте строчные буквы и цифры с одинарным дефисом.
+- Не начинаться и не заканчиваться на `-`.
+- Не содержать последовательных `--`
+- Сопоставьте имя каталога, содержащее `SKILL.md`.
+
+Эквивалентное регулярное выражение:
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## Соблюдайте правила длины
+
+`description` должно содержать от 1 до 1024 символов.
+Держите его достаточно конкретным, чтобы агент мог сделать правильный выбор.
+
+---
+
+## Используйте пример
+
+Создайте `.opencode/skills/git-release/SKILL.md` следующим образом:
+
+```markdown
+---
+name: git-release
+description: Create consistent releases and changelogs
+license: MIT
+compatibility: opencode
+metadata:
+  audience: maintainers
+  workflow: github
+---
+
+## What I do
+
+- Draft release notes from merged PRs
+- Propose a version bump
+- Provide a copy-pasteable `gh release create` command
+
+## When to use me
+
+Use this when you are preparing a tagged release.
+Ask clarifying questions if the target versioning scheme is unclear.
+```
+
+---
+
+## Распознавание описания инструмента
+
+opencode перечисляет доступные навыки в описании инструмента `skill`.
+Каждая запись включает название и описание навыка:
+
+```xml
+<available_skills>
+  <skill>
+    <name>git-release</name>
+    <description>Create consistent releases and changelogs</description>
+  </skill>
+</available_skills>
+```
+
+Агент загружает навык, вызывая инструмент:
+
+```
+skill({ name: "git-release" })
+```
+
+---
+
+## Настройка разрешений
+
+Контролируйте, к каким навыкам агенты могут получить доступ, используя разрешения на основе шаблонов в `opencode.json`:
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+| Разрешение | Поведение                                 |
+| ---------- | ----------------------------------------- |
+| `allow`    | Skill loads immediately                   |
+| `deny`     | Skill hidden from agent, access rejected  |
+| `ask`      | User prompted for approval before loading |
+
+Шаблоны поддерживают подстановочные знаки: `internal-*` соответствует `internal-docs`, `internal-tools` и т. д.
+
+---
+
+## Переопределить для каждого агента
+
+Предоставьте конкретным агентам разрешения, отличные от глобальных настроек по умолчанию.
+
+**Для пользовательских агентов** (в заголовке агента):
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+**Для встроенных агентов** (в формате `opencode.json`):
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## Отключить инструмент навыков
+
+Полностью отключить навыки для агентов, которым не следует их использовать:
+
+**Для индивидуальных агентов**:
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+**Для встроенных агентов**:
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+Если этот параметр отключен, раздел `<available_skills>` полностью опускается.
+
+---
+
+## Устранение неполадок с загрузкой
+
+Если навык не отображается:
+
+1. Убедитесь, что `SKILL.md` написано заглавными буквами.
+2. Убедитесь, что заголовок включает `name` и `description`.
+3. Убедитесь, что названия навыков уникальны во всех локациях.
+4. Проверьте разрешения — навыки с `deny` скрыты от агентов.