Когда библиотеке Agent Skills нужна ревизия?
Проводите ревизию, когда список навыков вырос настолько, что люди не знают, какая версия активна, одинаковые задачи покрывают несколько skills или метаданные занимают контекст, хотя сами навыки не используются.
Количество папок само по себе не проблема. Риск появляется, когда коллекция перестаёт быть управляемой: одно имя встречается в нескольких областях, старые копии продолжают загружаться, а похожие description конкурируют за один запрос.
Как собрать полный реестр навыков?
Запишите для каждого skill имя, фактический путь, область видимости, источник, версию, владельца и дату последнего успешного применения. Проверяйте не только репозиторий, но и пользовательские, проектные и управляемые области клиента.
| Поле | Зачем оно нужно |
|---|---|
| Имя и путь | Находить одноимённые копии и понимать, какая из них загружается |
| Источник и версия | Отличать проверенный выпуск от случайной локальной копии |
| Область видимости | Понимать, в каких проектах skill доступен |
| Последнее использование | Не путать редко используемый навык с забытым |
| Владелец | Получить решение об обновлении, объединении или удалении |
Если одна версия должна обслуживать несколько клиентов, сначала зафиксируйте переносимое ядро Agent Skill.
Как понять, какие skills действительно используются?
Не опирайтесь только на память команды. Сопоставьте журнал активаций, реальные задачи, изменения результата и дату последнего вызова. Отсутствие вызовов — повод для проверки, а не автоматическое основание для удаления.
- Соберите задачи, для которых skill должен выбираться.
- Проверьте прямой вызов и автоматический выбор отдельно.
- Зафиксируйте фактический путь загруженного навыка, если клиент его показывает.
- Отметьте навыки без владельца, сценария или успешного запуска за выбранный период.
- Попросите владельца подтвердить редкие сезонные и аварийные сценарии.
Чтобы отличить полезный вызов от случайного совпадения, используйте тест эффективности до и после.
Как найти дубли и конфликты имён?
Сгруппируйте skills по name, назначению и ключевым условиям из description. Для каждого совпадения сравните путь, область, версию и тестовые запросы: одинаковое имя может скрывать разные инструкции, а разные имена — выполнять одну работу.
- 1. Найдите точные совпадения
Соберите одинаковые name и имена папок во всех областях установки.
- 2. Найдите смысловые дубли
Сравните результат, триггеры и границы skills, которые обещают похожую работу.
- 3. Воспроизведите выбор
Запустите одинаковые прямые, отрицательные и пограничные запросы.
- 4. Назначьте основную версию
Выберите один источник и оформите миграцию потребителей.
При пересечении условий сначала уточните description в SKILL.md, а не добавляйте ещё одно похожее имя.
Что оставить, объединить, отключить или удалить?
Оставляйте skill с подтверждённой задачей и владельцем; объединяйте настоящие дубли; отключайте спорные версии на период наблюдения; удаляйте только после проверки потребителей, ссылок и возможности восстановить прежний выпуск.
| Решение | Условие |
|---|---|
| Оставить | Есть уникальная задача, владелец и подтверждённый результат |
| Упростить | Навык полезен, но слишком широк или дорого загружается |
| Объединить | Две версии имеют один результат и одинаковые границы |
| Отключить | Спрос неясен, но немедленное удаление рискованно |
| Удалить | Нет потребителей, владельца и уникального сценария; восстановление задокументировано |
Как безопасно удалить лишний Agent Skill?
Сделайте удаление отдельным обратимым изменением: сохраните исходную версию, найдите ссылки и потребителей, отключите skill в пилотной области, прогоните контрольные задачи и только затем удалите остальные копии.
- 1. Зафиксируйте состояние
Сохраните commit, tag или архив без секретов и локальных данных.
- 2. Объявите замену
Укажите владельца, срок и основной skill для прежней задачи.
- 3. Отключите в одной области
Проверьте, не исчезли ли обязательные сценарии и не выбрался ли неожиданный дубль.
- 4. Удалите ссылки
Обновите инструкции, плагины, symlink, каталоги и документацию доставки.
- 5. Повторите диагностику
Сверьте активный список и выполните прямой и отрицательный тесты.
Как не допустить нового разрастания?
Назначьте владельца библиотеки, единый источник, минимальные поля реестра и регулярную ревизию. Новый skill должен иметь уникальную работу, тестовые запросы и план обновления или удаления.
Для командного процесса используйте схему репозитория, версий и ревью Agent Skills.
- Проверяйте конфликт имён до установки.
- Храните версию и источник рядом с записью каталога.
- Добавляйте владельца и reviewAfter.
- Считайте не число skills, а успешные задачи и стоимость их выполнения.
- Повторяйте ревизию после крупных изменений модели, клиента или структуры команды.
Что должно остаться после ревизии?
Результат ревизии — не минимальное число папок, а объяснимая библиотека: для каждого навыка понятны задача, владелец, версия, область, доказательство пользы и путь безопасного отключения.
Сохраните реестр, список решений и контрольные сценарии в системе версий. Любой найденный конфликт превращайте в правило установки, тест или проверку перед выпуском — так следующая ревизия станет короче и надёжнее.