Что можно поручить onboarding skill?
Onboarding skill подходит для стабильной части адаптации: знакомство с понятиями компании, навигация по материалам, проверка обязательных шагов, подготовка заявок на доступ и фиксация вопросов. Решения о найме, правах, оценке человека и исключениях должны оставаться у назначенных сотрудников согласно внутренней политике компании.
Хороший первый сценарий имеет ясное начало, повторяется для каждой роли и заканчивается наблюдаемым результатом. Не стоит переносить в skill весь испытательный срок: там слишком много живой обратной связи, меняющихся целей и управленческих решений.
Где провести границу первого сценария?
Ограничьте первый skill одним завершённым отрезком, например первым рабочим днём или настройкой базовой среды. Входом будут роль и подтверждённые данные сотрудника, выходом - заполненный чек-лист, рабочая среда и список нерешённых вопросов с ответственными, сроками и понятным следующим действием для каждого блока.
| Внутри skill | Оставить человеку |
|---|---|
| Показать маршрут и материалы | Объяснить культуру и контекст команды |
| Проверить наличие стандартных настроек | Одобрить чувствительные права |
| Подготовить заявки на доступ | Выдать или расширить доступ |
| Собрать повторяющиеся вопросы | Разобрать личную или конфликтную ситуацию |
| Сохранить статус шагов | Оценить работу сотрудника |
Как собрать карту адаптации?
Сначала пройдите текущий onboarding вместе с ответственным и запишите действия, источники, решения и исключения. Затем удалите шаги без понятной пользы, назначьте владельца каждому доступу и сформулируйте критерий завершения. В skill переносится очищенный процесс, а не исторически сложившийся список ссылок без владельцев и даты пересмотра.
- 1. Запишите реальный маршрут
Фиксируйте действия HR, руководителя, IT и сотрудника в порядке выполнения.
- 2. Назовите входы
Роль, команда, дата старта, рабочее устройство и уже одобренные права.
- 3. Отметьте решения
Для каждого ветвления укажите правило и человека, который принимает исключение.
- 4. Привяжите источники
Используйте владельцев и даты пересмотра, а не копии политик внутри skill.
- 5. Определите done
Список выполненных шагов, подтверждённая среда и открытые вопросы с ответственными.
Базовый способ переноса процесса описан в руководстве как превратить регламент в Agent Skill.
Что положить в SKILL.md и supporting files?
В SKILL.md оставьте триггер, маршрут, точки подтверждения, критерий готовности и правила остановки. Ролевые чек-листы, словарь компании, шаблоны заявок и карту систем вынесите в references и assets. Так основной процесс читается быстро, а подробности загружаются только для нужной роли и конкретного шага адаптации.
- SKILL.md: цель, входы, основной порядок и остановки.
- references/roles.md: различия по ролям и командам.
- references/systems.md: назначение систем, владельцы и ссылки на актуальные инструкции.
- assets/access-request.md: шаблон заявки без секретов.
- assets/first-day-checklist.md: итоговый чек-лист сотрудника.
- scripts/check-environment.*: только безопасные проверки без выдачи прав.
Чтобы основной файл не превратился в справочник, используйте схему SKILL.md, references, scripts и assets.
Как работать с доступами и персональными данными?
Для пилота согласуйте с HR, IT и владельцем системы, какие данные и действия допустимы по внутренней политике. Skill использует только необходимые сведения и не хранит пароли или токены. При наличии утверждённой интеграции он может проверить статус доступа или подготовить заявку; выдача прав остаётся в отдельном процессе.
| Действие | Безопасная граница |
|---|---|
| Подготовить учётную запись | При наличии интеграции сформировать заявку с ролью и владельцем |
| Проверить инструмент | По согласованному сценарию проверить только статус входа |
| Настроить локальную среду | Использовать утверждённые команды и сохранить краткий результат проверки |
| Работать с секретом | Следовать внутренней политике и не записывать значение в skill или общий лог |
| Расширить права | Передать запрос владельцу системы по принятому процессу |
Практика минимальных прав разобрана в статье секреты и разрешения в Agent Skills.
Как обрабатывать вопросы и исключения?
Каждое исключение должно закончиться понятной передачей: что произошло, какой шаг заблокирован, что уже проверено и кто отвечает дальше. Не заставляйте skill угадывать кадровую политику или выдавать лишние права ради завершения чек-листа. Повторяющиеся исключения становятся материалом для следующей версии после согласования с владельцем процесса.
- Нет нужного устройства - остановить техническую настройку и назначить IT.
- Роль отсутствует в матрице - запросить решение руководителя, не выбирать похожую роль.
- Инструкция устарела - сохранить ссылку и симптом, уведомить владельца материала.
- Нужен чувствительный доступ - подготовить заявку и дождаться одобрения.
- Возник личный вопрос - передать HR без записи деталей в общий журнал.
Как протестировать onboarding skill до запуска?
Проверьте skill на фиктивных профилях и тестовой среде: стандартная роль, неполные данные, отсутствующий доступ, устаревшая ссылка и запрос лишних прав. Успех означает не только завершённый счастливый путь, но и корректную остановку с понятной передачей ответственного, причиной сбоя и сохранённым статусом уже выполненных шагов.
- 1. Используйте синтетические данные
Не проводите первый прогон на реальном новом сотруднике и рабочих секретах.
- 2. Пройдите основной путь
Сверьте порядок, длительность, ссылки и итоговый чек-лист.
- 3. Сломайте каждый доступ
Проверьте, что skill останавливается и не расширяет права самовольно.
- 4. Проверьте передачу
Получатель должен понять проблему без повторного интервью сотрудника.
- 5. Запустите ограниченный пилот
Одна роль, один ответственный и короткое окно обратной связи.
Общую матрицу позитивных и негативных сценариев возьмите из статьи как тестировать Agent Skill.
Что измерять после первого запуска?
Смотрите на время до готовой среды, долю завершённых обязательных шагов, число ручных вмешательств, повторяющиеся вопросы и ошибки доступа. Скорость сама по себе недостаточна: более короткий onboarding вреден, если сотрудник не понимает следующий шаг или получает права без нужного контроля со стороны HR, IT и владельца системы.
- Время от старта до минимально рабочей среды.
- Доля шагов, завершённых без повторного ввода данных.
- Число и тип исключений на одного сотрудника.
- Количество устаревших или недоступных источников.
- Ручная нагрузка HR, руководителя и IT.
- Оценка понятности маршрута сотрудником после завершения.
Назначьте владельца skill и короткий цикл обновления после каждой группы новичков. Вносите изменение только вместе с примером исключения или тестом, который показывает, зачем оно нужно.