Компоненты¶
Компоненты — строительные части сетапа. Каждый компонент имеет вид, версию, происхождение, ограничения совместимости и паспорт.
Один вид не подменяет другой. Например, MCP-сервер остаётся mcp, а инструкция
по его использованию остаётся содержимым instruction или skill.
Быстрый выбор¶
| Если нужно | Вид компонента | Почему |
|---|---|---|
| Добавить правила, память или стиль работы | instruction |
Это текстовая политика для агента или харнесса |
| Описать повторяемый агентский workflow | skill |
Skill хранит процедуру, материалы и вспомогательные скрипты |
| Подключить внешний инструмент к агенту | mcp |
MCP даёт агенту управляемый интерфейс к сервису или локальному tool |
| Выполнить действие на событии харнесса | hook |
Hook привязан к жизненному циклу и требует осторожности |
| Дать человеку или агенту именованную команду | command |
Command делает повторяемый вход понятным и проверяемым |
| Добавить роль или специализированного subagent | agent |
Agent описывает область ответственности и ограничения роли |
| Расширить сам харнесс пакетом | plugin |
Plugin устанавливает нативное расширение харнесса |
| Зафиксировать параметры и режимы | setting |
Setting хранит конфигурацию без секретов и без поведения |
Матрица компонентов¶
| Вид | Что содержит | Что проверяет ai_stp |
Типичный риск |
|---|---|---|---|
instruction |
Markdown, правила, память, ограничения | происхождение, версию, совместимость, область действия | слишком широкие или противоречивые правила |
skill |
SKILL.md, assets, scripts, references |
структуру, совместимость, исполняемые помощники | скрытые side effects в скриптах |
mcp |
описание MCP-сервера и способ запуска | источник, разрешения, отсутствие секретов в паспорте | внешний доступ к данным или инструментам |
hook |
событие, действие, условия запуска | событие, target, восстановление, подтверждение | автоматическое изменение состояния |
command |
slash/CLI-команду и аргументы | имя, область, help, конфликт команд | неоднозначный или опасный shortcut |
agent |
роль, инструкции, ограничения | границы роли, совместимость, права | слишком широкие полномочия subagent |
plugin |
нативное расширение харнесса | пакет, версию, источник, install route | supply-chain и post-install поведение |
setting |
параметры, режимы, preferences | допустимые значения и отсутствие секретов | утечка приватных данных или дрейф конфигурации |
Как компонент попадает в сетап¶
Компонент описывается паспортом: вид, версия, источник, совместимость, ограничения и результаты проверок. Паспорт — это то, что может читать CLI, каталог и agent.
ai_stp выбирает кандидатов из публичного каталога, локального реестра или
точно закреплённых пользовательских объектов. Линия доверия влияет на то,
можно ли показывать и устанавливать объект автоматически.
Сборщик сетапа строит граф компонентов и проверяет, что версии, харнесс, зависимости и ограничения совместимы между собой.
Итоговое состояние target пишет только публичный provider конкретного харнесса. Перед изменением создаются план, digest и резервная копия.
Почему нельзя просто скопировать файлы в target
У разных харнессов отличаются форматы, каталоги, правила безопасности и
жизненный цикл. Прямое копирование ломает provenance и rollback. Поэтому
ai_stp сначала строит проверяемый план, а уже затем передаёт применение
provider-слою.
Версии¶
Публикуемая версия компонента неизменяема и имеет формат X.Y. Если меняется
содержимое, появляется новая версия.
Совместимость¶
Компонент может подходить одному харнессу и быть недопустимым для другого. Механические ограничения совместимости применяются до рассуждений агента.
Подробнее про статусы: поддерживаемые харнессы.