Навыки

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

Навык (living skill) — переиспользуемая процедура агента: что умеет, когда применимо, какие инструменты требует, как проверить результат. В отличие от промпта, навык версионируется, имеет контракт и набор оценок качества. Страница Навыки (/skills), детали — docs/living-skills.md.

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

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

Манифест (SKILL.md + метаданные) описывает:

• процедуру — шаги, которые агент выполняет;
• предусловия — когда применять, что должно быть на входе;
• требуемые инструменты и права — навык не может получить больше, чем есть у агента;
• постусловия и проверки — как убедиться, что выполнено;
• артефакты — справочные документы (регламенты, инструкции), которые агент подгружает по требованию через artifact_read, а не держит в промпте.

#Как создаётся

1. Из описания — опишите словами повторяющуюся процедуру; сборщик составит черновик навыка, ссылаясь только на реально существующие инструменты.
2. Импорт — папка или архив в формате agentskills.io ↗.
3. Вручную — редактор манифеста.
4. Майнинг — супервайзер находит повторяющиеся три-граммы вызовов инструментов между ранами (детерминированный гейт отсекает read-only последовательности и повторы подряд), судья выносит вердикт worth_skill с обоснованием; кандидат появляется в очереди на странице Навыков как предзаполненный черновик — остаётся прочитать и утвердить или отклонить.

Новый навык — черновик (0.x). В продакшн он попадает после human review. В списке навыков бейджи показывают незавершённое: draft — черновики, «↺ N» — ожидающие черновики-редакции; применение/отклонение версии — решение человека.

#Оценки качества (evaluations)

К навыку привязываются golden-кейсы: вход → ожидаемый ответ. Прогон оценки (вручную или по расписанию) проверяет ответы паттернами и LLM-судьёй с калибровкой согласия. Результат виден в карточке навыка и на дашборде качества.

#Эволюция

Навык живёт: агент может предложить изменение (тул skill_propose) на основе повторяющегося трения. Версии накапливаются; применение новой версии проходит через тот же контур качества. Инструменты skill_history, skill_diff, skill_executions дают полную картину: кто, когда и как менял, где навык применялся и что он «запомнил» из выполнений (skill_memory).

Артефакты едут вместе с эволюцией. Предложение изменений (skill_propose) принимает список артефакт-ссылок artifact_refs — документов, которые навыку нужны как справочные. Каждая ссылка проверяется по реестру при отправке: в манифест попадают только утверждённые артефакты, а выдуманные или неутверждённые id отбрасываются и перечисляются в ответе — модель видит, что именно выжило. Серверная проверка на границе сохранения не даст навыку сослаться на неутверждённый документ. Редактируются ссылки и вручную — во вкладке «Артефакты» редактора навыка: поиск по реестру, привязка и условие применения каждого документа.

#Как агент работает с навыками

В ране агенту доступны skill_search (найти подходящий), skill_inspect (прочитать контракт), skill_validate (проверить применимость). Загрузка навыка в контекст — по требованию, а не постоянным промптом.