Приложение E. Карточка skill
Skill — это рабочий протокол, который дополняет промпт контекстом, источниками, ограничениями и правилами качества.
Это рабочий протокол ассистента: что он делает, на каких данных, в каких границах, как проверяет качество и какой результат должен вернуть.
1. Паспорт skill
| Поле | Значение |
|---|
| Название | |
| Короткое описание | |
| Роль пользователя | |
| Контур | |
| Владелец | |
| Статус | Черновик, пилот, утвержден, устарел |
| Версия | |
| Дата обновления | |
2. Когда использовать
| Вопрос | Ответ |
|---|
| Использовать, когда | |
| Не использовать, когда | |
3. Цель
| Вопрос | Ответ |
|---|
| Какую работу улучшает skill | |
| Какой результат должен получить пользователь | |
| Какой эффект ожидается | |
4. Входные данные
| Вход | Обязательный? | Откуда берется | Комментарий |
|---|
| Да или нет | | |
| Да или нет | | |
| Да или нет | | |
5. Source of truth
| Тип данных | Источник | Что брать | Что не брать |
|---|
| | | |
| | | |
| | | |
6. Шаги выполнения
- ...
- ...
- ...
- ...
- ...
7. Ограничения
Ассистент не должен:
8. Delegate / Review / Act
| Режим | Разрешено | Требует подтверждения | Запрещено |
|---|
| Delegate | | | |
| Review | | | |
| Act | | | |
9. Правило остановки
Ассистент должен остановиться и вернуть управление человеку, если:
- нет доступа к source of truth;
- данные противоречат друг другу;
- не хватает обязательных входов;
- найден высокий риск;
- действие затрагивает деньги, юридические обязательства или персональные данные;
- confidence низкий;
- другое.
10. Формат результата
| Поле | Описание |
|---|
| Результат должен быть в формате | |
| Обязательные разделы | |
| Тон и стиль | |
| Что вывести отдельно | |
11. Правила качества
Результат считается хорошим, если:
- ...
- ...
- ...
- ...
- ...
12. Пример хорошего результата
13. Типовые ошибки
| Ошибка | Как обнаружить | Как исправить skill |
|---|
| | |
| | |
| | |
14. Метрики
| Метрика | Как измеряем | Цель |
|---|
| Время выполнения | | |
| Возвраты на доработку | | |
| Ошибки качества | | |
| Использование | | |
15. История изменений
| Версия | Дата | Что изменилось | Кто утвердил |
|---|
| | | |