Что можно поручить document skill?
Document skill подходит для повторяемого маршрута: принять бриф и исходник, выбрать утверждённый шаблон, заполнить разделы, сохранить новую версию, проверить структуру и показать изменения. Он не должен молча придумывать отсутствующие факты, удалять оригинал или утверждать документ вместо владельца. Юридические, кадровые и финансовые материалы требуют профильной проверки.
Лучший первый сценарий имеет один тип входа и один наблюдаемый выход: например, превратить заметки интервью в внутренний отчёт или обновить техническую инструкцию по согласованному шаблону.
Как выбрать первый документный сценарий?
Выберите документ, который повторяется, имеет владельца, устойчивую структуру и понятный критерий готовности. Не начинайте с универсального навыка для любых PDF, таблиц и презентаций. Чем меньше форматов и вариантов согласования в первом пилоте, тем проще отличить пользу skill от случайно удачного ответа модели.
| Хороший пилот | Слабый первый пилот |
|---|---|
| Один шаблон отчёта | Любой деловой документ |
| Известный владелец | Неясно, кто утверждает результат |
| Проверяемые обязательные разделы | Критерий только «выглядит хорошо» |
| Новая копия файла | Перезапись общего оригинала |
| Пять типовых примеров | Один идеальный пример |
Какие входы должен запросить skill?
Минимальный контракт включает исходный файл или данные, цель документа, аудиторию, утверждённый шаблон, обязательные факты, ограничения и путь для результата. Если критичного входа нет, skill должен остановиться или явно пометить пробел. Молчаливое заполнение фамилий, цифр, дат и обязательств делает аккуратный документ ненадёжным.
- Что создать или изменить и для кого.
- Какой файл является исходником, а какой шаблоном.
- Какие факты подтверждены и откуда они получены.
- Какие разделы нельзя менять или удалять.
- В каком формате и под каким именем сохранить результат.
- Кто проверяет содержание перед использованием.
Если навык запускается не на тех запросах, уточните description в SKILL.md.
Что положить в SKILL.md и supporting files?
В SKILL.md оставьте порядок работы, входной контракт, правила остановки, способ сохранения и чек-лист проверки. Сам шаблон храните в assets, подробные редакционные нормы и примеры в references, а воспроизводимую проверку структуры в scripts. Не копируйте весь корпоративный справочник в основной файл, если для задачи нужен один раздел.
| Место | Содержимое |
|---|---|
| SKILL.md | Маршрут, границы, входы, выход и критерий done |
| assets/ | Шаблон, стили и пустой итоговый файл |
| references/ | Термины, редакционные правила и примеры |
| scripts/ | Проверка структуры, метаданных или формата |
Подробная схема находится в статье как разделить большой SKILL.md.
Как редактировать документ без потери оригинала?
Считайте исходник неизменяемым, если пользователь прямо не поручил другое. Создавайте новую версию в заранее указанной папке, сохраняйте понятное имя и фиксируйте краткий diff: какие разделы изменены, какие данные добавлены и какие места требуют решения человека. Перед перезаписью существующего файла нужно отдельное явное подтверждение и проверенный путь восстановления.
- 1. Зафиксируйте исходник
Запишите имя, формат и при необходимости контрольную сумму файла.
- 2. Создайте рабочую копию
Не изменяйте утверждённый оригинал во время подготовки.
- 3. Примените шаблон
Переносите подтверждённые данные и оставляйте видимые пробелы.
- 4. Сохраните новую версию
Используйте однозначное имя и отдельный путь результата.
- 5. Покажите изменения
Сформируйте краткий список правок и нерешённых вопросов.
Как проверить структуру и содержание?
Автоматически проверяйте то, что имеет однозначный ответ: наличие разделов, порядок заголовков, обязательные метаданные, формат даты, пустые поля и доступность ссылок. Смысл, тон, точность фактов и уместность формулировок оценивает человек по рубрике. Validator не должен объявлять документ верным только потому, что все заголовки на месте.
| Проверка | Механизм |
|---|---|
| Обязательные разделы | Validator или структурный parser |
| Пустые placeholders | Поиск запрещённых маркеров |
| Ссылки и вложения | Техническая проверка доступности |
| Фактическая точность | Сверка с источником и владельцем |
| Тон и полезность | Редакторская рубрика |
Детерминированный слой можно собрать по руководству как добавить самопроверку в Agent Skill.
Как протестировать document skill?
Возьмите не меньше пяти примеров: полный бриф, пропущенный обязательный факт, повреждённый или неподдерживаемый файл, документ с нестандартной структурой и запрос на опасную перезапись. Проверяйте не красоту одного результата, а сохранность оригинала, отсутствие выдуманных данных, прохождение validator, качество diff и число исправлений редактора.
- 1. Сохраните baseline
Измерьте время и ошибки текущего ручного процесса.
- 2. Запустите типовые примеры
Не меняйте одновременно модель, шаблон и критерии оценки.
- 3. Проверьте отказ
Skill должен остановиться при критично неполном входе.
- 4. Сравните файлы
Оригинал не меняется, новая версия открывается и сохраняет нужный формат.
- 5. Посчитайте правки
Сравните время редактора и критические ошибки до и после.
Общая тестовая матрица разобрана в статье как тестировать Agent Skill.
С какого document skill начать?
Начните с одного утверждённого шаблона, одного владельца и одного формата результата. Добавьте пять реальных примеров, запрет молчаливой перезаписи, проверку обязательных разделов и ручное подтверждение перед использованием. Пилот считается полезным, если сокращает повторяющуюся работу без роста фактических ошибок и не скрывает незаполненные данные за гладким текстом.
После пилота отдельно решите, добавлять ли новые форматы. Второй тип документа часто требует другого входного контракта, шаблона, проверок и владельца, поэтому не стоит автоматически превращать один удачный skill в универсальный.
Для близкого сценария посмотрите карточку to-spec или закажите адаптацию под свой шаблон.