---
title: "Навыки"
id: "347"
type: "page"
slug: "skills"
published_at: "2026-05-19T11:30:45+00:00"
modified_at: "2026-07-06T11:59:17+00:00"
url: "https://pastukhov.com/agent/docs/skills"
markdown_url: "https://pastukhov.com/agent/docs/skills.md"
excerpt: "Навыки — это основной механизм управления тем, что ИИ знает о вашей задаче. Каждое взаимодействие…"
---

# Навыки

[https://pastukhov.com/agent/docs/skills.md](https://pastukhov.com/agent/docs/skills.md)

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

## Использование контекста

У ИИ-моделей есть ограниченное окно контекста — фиксированный объём текста, который они могут обработать за один раз. Всё, что вы хотите, чтобы ИИ знал о вашей задаче, должно уместиться в этот лимит. Это делает управление контекстом самым важным фактором для получения хороших результатов.

Две противоположные проблемы усложняют это:

- **Слишком мало контекста** — Если у ИИ недостаточно информации о вашем проекте, соглашениях и целях, он сделает неверные предположения и выдаст неправильный результат.
- **Слишком много контекста** — Если вы запихнёте в контекст нерелевантную информацию, внимание ИИ размывается на слишком много тем. Он перестаёт уделять достаточно внимания тем частям, которые действительно важны, что приводит к небрежным ошибкам.

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

## CLAUDE.md — Контекст по умолчанию

По умолчанию файл `CLAUDE.md` всегда загружается в контекст в начале каждого чата. Этот файл обычно содержит общую информацию о вашем проекте — что это, как он структурирован, и любые соглашения, которые ИИ должен соблюдать независимо от задачи.

CLAUDE.md хорошо работает для универсальных правил, применимых ко всему. Но по мере роста вашего проекта и работы с всё более разнообразными задачами — редактирование веб-сайта, операции с базой данных, деплой, аналитика — помещение всего этого в CLAUDE.md создаёт именно проблему «слишком большого контекста». ИИ тратит внимание на чтение о скриптах деплоя, когда вы просите его отредактировать страницу.

## Что такое навыки?

Навыки — это динамическая замена статическому подходу с CLAUDE.md. Вместо одного монолитного файла вы создаёте коллекцию специализированных навыков — каждый focussed на определённый тип задач. Когда вы начинаете чат, вы загружаете только тот навык, который соответствует тому, что вы собираетесь делать.

Навык — это **не один markdown-файл** — это **папка**, содержащая:

- `SKILL.md` — Основной файл, загружаемый в контекст ИИ при активации навыка
- Дополнительные файлы документации — Справочные документы, примеры, шаблоны
- Скрипты — Python или другие исполняемые файлы для автоматизации задач специфичных для навыка
- Примеры — Образцы входных данных, выходных данных и тестовые данные

Такая структура папок организует всё, связанное с типом задач, в одном месте. Документация говорит ИИ, что делать. Скрипты дают ему инструменты для этого. Примеры показывают, как должен выглядеть хороший результат.

## Хранение в проекте

Навыки находятся внутри папки вашего проекта по адресу `.claude/skills/{skill-name}/` и хранятся **вместе с проектом** в едином Git-репозитории. Коммиты навыков и кода проекта имеют общую историю, и все операции — push, pull, переключение веток — применяются к репозиторию целиком.

## Итеративное улучшение

Практический способ улучшения навыков — не редактировать их вручную — а попросить ИИ сделать это. Когда ИИ совершает ошибку, скажите ему: *«исправь это, затем добавь правило в навык, чтобы избежать этого в будущем.»* ИИ применяет исправление и обновляет навык в том же сеансе.

Кривая улучшения крута в начале:

- **Из коробки** — ИИ работает без какого-либо специфичного для проекта контекста. Результаты общие и часто неправильные.
- **20–30 улучшений** — Обычно достигает около 85% точности для большинства задач. Именно здесь собирается большинство низко висящих плодов.
- **100+ улучшений** — Может подойти к почти безупречной производительности, даже для задач, которые трудно формализовать строгими правилами.

Самое важное правило, когда вы просите ИИ обновлять навыки: **держите правки маленькими, а файлы навыков короткими**. Каждое обновление должно менять только необходимое — несколько строк, а не переписывание. Модели склонны добавлять много дополнительной информации, объяснений и документации к каждому правилу, что раздувает навык и ухудшает использование контекста. Вам нужно явно инструктировать их сохранять изменения минимальными и избегать добавления ненужного контента.

## Загрузка навыка

ИИ не может надёжно выбрать, какой навык загрузить, самостоятельно — по крайней мере пока. Чтобы гарантировать загрузку правильного навыка, Pastukhov Agent предоставляет ручной переключатель навыков.

Вот как это работает:

- **Новый чат** — Когда вы выбираете навык перед отправкой первого сообщения, система автоматически добавляет `start with loading {skill name} skill` в начало вашего сообщения. Это сообщает ИИ, какой навык активировать.
- **Переключение в процессе чата** — Если вы выбираете другой навык во время ongoing разговора, система добавляет `load {skill name} skill` в ваше следующее сообщение. Это переключает контекст без потери истории разговора.

Выберите навык с помощью селектора навыков в области ввода чата перед вводом вашего сообщения. Имя и цвет выбранного навыка отображаются там.

## Управление навыками

Откройте диалог навыков для просмотра, редактирования, создания и организации ваших навыков. Диалог имеет две панели: список всех навыков слева и редактор для выбранного навыка справа.

Все навыки всегда активны и доступны в селекторе навыков — включение и отключение не предусмотрено. Каждый навык имеет настраиваемый цвет для визуальной идентификации. Список навыков и их цвета хранятся в файле `.xedant/skills.yml` в секции `settings` (формат: имя навыка и свойство `color`). Файл синхронизируется между сеансами через SignalR — изменения, внесённые на одном устройстве, мгновенно появляются на всех остальных.

Сами файлы навыков находятся в `.claude/skills/{skill-name}/` внутри вашего проекта и коммитятся вместе с ним в едином Git-репозитории.

## Редактор навыков

Редактор в правой панели диалога навыков показывает все файлы в папке выбранного навыка как вкладки. Первая вкладка всегда `SKILL.md` — основной файл инструкций, который загружается в контекст ИИ. Дополнительные вкладки показывают любые другие файлы в папке навыка.

Возможности редактора:

- **Вкладки** — Навигация между всеми файлами в папке навыка
- **Подсветка синтаксиса** — Форматирование кода для скриптов и конфигурационных файлов
- **Автосохранение** — Изменения сохраняются автоматически по мере работы
- **Интеграция с Git** — Коммитить изменения навыков напрямую из редактора

Изменения в навыках отслеживаются тем же Git-репозиторием, что и проект. В панели Git вы увидите изменения файлов навыков вместе с изменениями кода проекта — единая история коммитов.

Редактор также может **запускать скрипты** напрямую из папок навыков. Это делает удобным управление инфраструктурой — деплой, операции с базой данных, процессы сборки — через навыки. Это также безопасно: специфичные для проекта переменные, такие как учётные данные auth и строки подключения, хранятся в конфигурации окружений проекта, а не в навыке.

Тем не менее, вы должны привыкнуть к **не редактировать файлы навыков или скрипты вручную**. Вместо этого, обучите себя и ваши модели — используя навык управления навыками, такой как `demo.skills` — создавать и обновлять навыки для вас. ИИ лучше понимает структуру и соглашения, чем вы можете после нескольких сеансов, и сохранение людей вне цикла редактирования предотвращает проникновение несоответствий.

**← Назад:** [Настройки](/agent/docs/settings)

**Далее:** [Окружения](/agent/docs/environments)
 →