Перейти к содержимому
AI-агенты

Cowork не видит локальные навыки: что он читает вместо них

Cowork не видит локальные навыки: что он читает вместо них

Частый сценарий: человек полгода настраивал папку .claude на своём компьютере, открывает Cowork и обнаруживает, что агент не знает ни одного его правила и ни одного навыка. Причина не в настройках, а в устройстве продукта: задачи Cowork выполняются в облаке, а не на вашей машине, и локальные каталоги ему просто недоступны.

Четыре слоя, которые он действительно читает

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

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

Третий — проект. Проекты в Cowork собирают связанные задачи в отдельное пространство со своими файлами, ссылками и инструкциями. У проекта включена память: контекст выполненных задач переносится на следующие задачи того же проекта и не смешивается с обычными чатами.

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

Что это меняет на практике

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

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

Навык для Cowork: чем он отличается от локального

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

Ограничение, на котором спотыкаются: при загрузке в аккаунт допустим короткий набор полей фронтматтера — имя, описание, лицензия, совместимость, метаданные и список разрешённых инструментов. Лишнее поле не игнорируется, а роняет упаковку с ошибкой. Поэтому навык, написанный под расширенный набор возможностей локального агента, в аккаунт не загрузится без чистки.

Второе ограничение касается динамического контекста. Приём, когда навык подставляет в тело результат шелл-команды, в синхронизированном навыке не выполняется: вместо результата приходит заглушка. Навык, построенный на такой подстановке, теряет половину смысла, и это надо учитывать до переноса, а не после.

Как разложить правила без дублей

Дубли — главный источник конфликтов между слоями. Один и тот же пункт в глобальных инструкциях и в инструкциях папки рано или поздно расходится в формулировках, и агент выбирает одну из версий произвольно. Работающее разделение простое: в глобальном слое только то, что не зависит от задачи; в слое папки только то, что нельзя перенести в другую папку; в проекте — данные и ссылки, а не стиль; в навыке — шаги, а не факты.

Проверять каждый пункт стоит тем же тестом, что и обычный файл контекста: строка остаётся, если её удаление меняет результат. Подробный разбор теста — в материале Каждая строка меняет поведение.

Что проверить перед первой задачей

Убедитесь, что подписка даёт доступ к Cowork: он доступен на платных тарифах, состав которых меняется, поэтому смотрите справку на дату запуска. Проверьте, включён ли нужный навык в аккаунте. Положите в рабочую папку файлы, на которые ссылаются инструкции. Задайте режим согласования действий осознанно: полностью автоматический режим экономит ваше время, но расходует лимит быстрее и лишает вас точки, где можно остановить неверный ход.

Первую задачу имеет смысл сделать заведомо маленькой — привести один документ к вашему формату. Так вы увидите, какие слои контекста действительно доехали до агента, до того как поручите ему что-то большое.