Библиотека инструментов
Abstract
Это карта возможностей (capabilities), которые skill может использовать. Карточка не означает, что инструмент установлен, доверен или нужен каждому агенту.
Сначала capability, потом продукт
В инструкции навыка лучше написать «нужен поиск с URL и датой публикации», чем жёстко привязать процесс к одному серверу. Конкретную реализацию вынеси в зависимости или адаптер среды.
| Capability | Для чего | Возможная реализация | Основной риск |
|---|---|---|---|
| Файлы | читать и менять рабочие материалы | Filesystem MCP или native filesystem tools | выход за разрешённый каталог |
| Веб-поиск | находить актуальные источники | Brave Search MCP или hosted search | недоверенный контент |
| Браузер | работать с динамическими страницами | Playwright MCP или computer use | prompt injection и side effects |
| Память | сохранять устойчивые факты | Memory MCP или собственное хранилище | утечка и устаревание данных |
| Репозитории | issues, PR, code search | GitHub MCP или GitHub API | запись не в тот repository |
| Календарь | читать доступность и создавать события | проверенный Calendar server/API | приглашения и изменение расписания |
| Выполнение кода | проверять и преобразовывать данные | shell, sandbox, code interpreter | запуск недоверенного кода |
| Декомпозиция | вести явный рабочий план | native reasoning или Sequential Thinking MCP | лишний контекст без улучшения результата |
Как описывать зависимость
## Зависимости
- Обязательно: чтение Markdown в пределах выбранной папки.
- Опционально: веб-поиск для проверки изменившихся фактов.
- Запрещено: публикация и удаление без отдельного запроса.
- Fallback: без сети пометить факты, требующие актуализации.Такой контракт переносится между клиентами лучше, чем список конкретных команд.
Полезные связки
Исследование
search → открыть первичный источник → сопоставить дату → сохранить вывод → проверить цитаты
Браузер нужен только для страниц, которые нельзя надёжно прочитать обычным fetch/search.
Работа с кодом
найти правила проекта → прочитать код → изменить минимальный scope → formatter/test → diff review
Отдельный reasoning server не обязателен: ценность создают проверяемые шаги и инструменты разработки.
Операционная задача
прочитать состояние → подготовить preview → получить подтверждение → выполнить → перечитать результат
Подтверждение должно находиться перед реальным side effect, а не в начале всей задачи.
Проверка нового инструмента
- Определи минимальную capability.
- Проверь издателя, код, зависимости и обновления.
- Ограничь каталог, account, repository, toolset или OAuth scope.
- Проверь read-only сценарием.
- Проверь ошибку и отзыв доступа.
- Только затем разрешай изменяющие операции.
Подробнее: Выбор и проверка MCP-сервера и Безопасность MCP.
Связи
- Концепция AI Skills — процедура поверх capabilities.
- Архитектура Навыка — где описывать зависимости.
- Безопасность Skills — права и доверие.
- _MCP Index — актуальный каталог MCP-интеграций.