Навык 31 из 39
HS-DEV-008-SKILLСоздание переиспользуемого AI skill для проверенного процесса
Определить, когда повторяемая работа требует технического AI skill, а не разового промпта, постоянного правила, статического шаблона, отдельного инструмента или нового агента; выделить устойчивую способность и упаковать её в минимальный версионируемый модуль с ясным описанием, условиями активации и неактивации, рабочими инструкциями, необходимыми references, scripts или assets и ограничениями безопасности. Установить skill в заранее выбранной области действия и доказать на чистых сессиях, что он активируется по назначению, не вмешивается в соседние задачи и переносится на новый пример того же класса.
Эта карточка описывает человеческую способность создавать технический AI skill. Она не превращает сам технический пакет в человеческий навык реестра Human Skill. AI skill предоставляет ограниченную вызываемую процедуру host-агенту, но не владеет собственной целью, автономным циклом, состоянием или permissions и не может расширить права host-агента. HS-FND-003-RULES отвечает за устойчивую политику, а HS-CTX-002-LOCAL — за выбор уровня размещения и проверку утечки инструкций между областями.
Тренажёр навыка
Понять.
Сделать.
Подтвердить.
Что нужно уметь
Определить, когда повторяемая работа требует технического AI skill, а не разового промпта, постоянного правила, статического шаблона, отдельного инструмента или нового агента; выделить устойчивую способность и упаковать её в минимальный версионируемый модуль с ясным описанием, условиями активации и неактивации, рабочими инструкциями, необходимыми references, scripts или assets и ограничениями безопасности. Установить skill в заранее выбранной области действия и доказать на чистых сессиях, что он активируется по назначению, не вмешивается в соседние задачи и переносится на новый пример того же класса.
Эта карточка описывает человеческую способность создавать технический AI skill. Она не превращает сам технический пакет в человеческий навык реестра Human Skill. AI skill предоставляет ограниченную вызываемую процедуру host-агенту, но не владеет собственной целью, автономным циклом, состоянием или permissions и не может расширить права host-агента. HS-FND-003-RULES отвечает за устойчивую политику, а HS-CTX-002-LOCAL — за выбор уровня размещения и проверку утечки инструкций между областями.
Как закрепить
Взять повторяемый процесс с evidence нескольких ручных прогонов, выделить инвариант и решить, оправдан ли отдельный skill. Создать первую версию пакета по контракту выбранного runtime: метаданные и описание для обнаружения, инструкции, минимальные references и только необходимые scripts или assets. Подготовить trigger-, non-trigger- и transfer-сценарии, установить skill в заданную ограниченную область, проверить его из чистого контекста на двух разных задачах, исправить один обнаруженный провал и убедиться, что пакет можно отключить или удалить без остаточного поведения.
Как проверить перенос
За 90 минут получить новый fixture с материалами повторяемого ручного процесса, совместимым agent runtime, заранее заданной project- или global-областью установки и соседними инструкциями, но без готовой структуры skill. Самостоятельно обосновать тип артефакта, создать и установить минимальный пакет в указанной области, а затем пройти независимую проверку. Набор включает прямой trigger, переформулированный trigger, похожую задачу вне семантической области skill, конфликт с более приоритетным локальным правилом, недоверенный фрагмент reference и перенос на новый пример. Проверка проводится в чистых сессиях без подсказки ожидаемой последовательности; после одного выявленного дефекта разрешена ограниченная исправляющая версия и retest.
Результат, а не ощущение
Evidence
освоения
- решение «skill / не skill» с сравнением разового промпта, правила, шаблона, инструмента и отдельного агента;
- версионируемое дерево пакета с валидными метаданными, инструкциями и только необходимыми ресурсами;
- явные условия активации и неактивации, ссылка на заданную область установки и приоритет относительно соседних правил;
- provenance и integrity включённых references, scripts и assets, а для фактических утверждений — прослеживаемость к каноническим источникам, когда они применимы;
- матрица trigger-, non-trigger-, conflict-, safety- и transfer-проверок с фактическими результатами чистых сессий;
- парные чистые прогоны одного transfer-входа с включённым и отключённым skill и разбор наблюдаемого delta;
- логи, подтверждающие корректную активацию и отсутствие вмешательства в соседние задачи;
- diff исправляющей версии и повторная проверка затронутых случаев;
- воспроизводимая установка, отключение или удаление и отсутствие остаточного поведения;
- явные границы совместимости, permissions, известные ограничения и критерий следующего обновления.
Антипаттерны
Типовые ошибки
- переименование длинного промпта в skill без повторного использования и контракта активации;
- расплывчатое описание, из-за которого skill включается почти в любой задаче;
- отсутствие non-trigger-примеров и проверки соседних сценариев;
- глобальная установка узкоспециализированного пакета без анализа области действия;
- копирование локальных правил или канонических references внутрь нескольких независимых skill;
- загрузка всего материала в основную инструкцию вместо минимального ядра и выборочных ресурсов;
- добавление script или инструмента без необходимости, валидации входов и минимальных permissions;
- тестирование только в сессии, где автор уже объяснил агенту ожидаемое поведение;
- включение секретов, персональных данных или недоверенных инструкций в пакет;
- отсутствие версии, способа отключения, transfer-проверки и evidence фактической пользы.