Skip to main content

Система навыков

ℹ️Note

Skills is an experimental feature. Enable it in Settings → Features → "Enable Skills".

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

В отличие от правил (которые всегда активны), навыки загружаются по запросу. Вы можете установить десятки навыков без влияния на контекст или производительность, потому что Careti видит только имя и описание навыка до тех пор, пока оно не понадобится.

Почему навыки?​

Подумайте, как вы onboard нового члена команды: вы бы не сбросили на них все документы сразу. Вы бы дали им краткий обзор, затем указали бы им подробные руководства, когда они работают над определёнными задачами.

Навыки работают так же:

  • При запуске: Careti видит только краткое описание каждого навыка
  • При срабатывании: Полные инструкции для этого навыка загружаются
  • По мере необходимости: Дополнительные файлы, встроенные в навыки, читаются только при ссылке

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

Создание навыка​

Каждый навык — это каталог, содержащий файл SKILL.md:

my-skill/
├── SKILL.md          # Требуется: основные инструкции
├── docs/             # Опционально: дополнительная документация
│   └── advanced.md
└── scripts/          # Опционально: служебные скрипты
    └── helper.sh

Файл SKILL.md имеет две части: YAML frontmatter и инструкции.

---
name: my-skill
description: Brief description of what this skill does and when to use it.
---

# My Skill

Detailed instructions for Careti to follow when this skill is activated.

## Steps

1. First, do this
2. Then do that
3. For advanced usage, see [advanced.md](docs/advanced.md)

Требуемые поля:

  • name: Должно точно совпадать с именем каталога
  • description: Говорит Careti, когда использовать этот навык (максимум 1024 символа)

Описание критично, потому что это то, как Careti решает, активировать ли навык. Будьте конкретны о том, что делает навык и когда его следует использовать.

Где живут навыки​

Навыки могут быть сохранены в двух местах:

Глобальные навыки применяются ко всем вашим проектам:

  • macOS/Linux: ~/Documents/.agents/skills/
  • Windows: C:\Users\USERNAME\Documents\.agents\skills\

Навыки проекта применяются только к текущей рабочей области:

  • .agents/skills/ (рекомендуется)

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

ℹ️Note

Стандартизация Careti: Careti использует двухкаталоговую архитектуру.

  • .agents/ - Для AI (оптимизировано по токенам)
  • .users/ - Для людей (подробные объяснения)

Используйте команду /init для инициализации стандартной структуры. Смотрите Система расширенных правил и Паритет знаний ИИ-разработчика для подробностей.

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

Щелкните на значок весов под полем ввода чата, чтобы открыть панель правил и рабочих процессов. Когда навыки включены, вы увидите вкладку "Навыки", где вы можете:

  • Просмотреть все доступные навыки (глобальные и проектные)
  • Включать или отключать отдельные навыки
  • Создавать новые навыки из шаблона
  • Удалять навыки, которые больше не нужны

Навыки включены по умолчанию при обнаружении. Отключите их, если вы хотите, чтобы они были доступны, но не активны для текущего проекта.

Как Careti использует навыки​

Когда вы отправляете сообщение, Careti видит список доступных навыков с их описаниями. Если ваш запрос соответствует описанию навыка, Careti активирует его с помощью инструмента use_skill, который загружает полные инструкции.

Например, если у вас есть навык для развертывания на AWS:

---
name: aws-deploy
description: Deploy applications to AWS using CDK. Use when deploying, updating infrastructure, or managing AWS resources.
---

Запрос "deploy this to AWS" заставит Careti активировать навык, загрузить его подробные инструкции и выполнить их для выполнения вашего запроса.

Пример: навык анализа данных​

Вот практический навык для задач анализа данных. Создайте каталог с именем data-analysis/ с этим файлом SKILL.md: