Почему это важно

Каждая тема этого руководства заканчивается промптами и навыками. Они существуют, потому что многие задачи управления услугами хорошо подходят помощнику, который может прочитать груду заявок, составить ранбук или превратить заметки в план. Они также существуют потому, что расплывчатая просьба к ИИ порождает расплывчатые, а иногда неверные результаты. Разница между полезным ответом и правдоподобным, но пустым часто лежит в том, как написана просьба и какой материал к ней приложен.

Эта тема объясняет, как использовать промпты и навыки руководства, почему они написаны так, как написаны, и как писать собственные для вашей команды. Она больше о привычках, чем о трюках: предоставлять реальный материал, говорить, чего вы хотите, просить помощника отмечать то, чего он не знает, и проверять то, что вернулось. Она опирается на предостережения предыдущей темы, описывающей, где ИИ помогает и где может навредить (см. Тема 6.2 — ИИ в управлении ИТ-услугами).

Источники практичны. Собственный навык руководства skills/prompt-engineering описывает написание промптов как осознанную практику проектирования и итерации инструкций, даваемых языковой модели, относясь к промпту как к небольшому программному изделию, которое пишется, проверяется на реальных случаях и пересматривается. Документация Claude Code описывает, как навыки строятся как каталоги с файлом SKILL.md. Статья Wikipedia о больших языковых моделях дает справку. Ни один источник, прочитанный для этого руководства, не предлагает свидетельств о том, какие приемы промптинга работают лучше всего; относитесь к приемам здесь как к привычкам для проверки.

Основные понятия

Промпты, навыки и для чего они

Промпт (prompt) это инструкция и материал, которые вы даете ИИ-помощнику для одной задачи. Навык (skill) в формате, используемом в папке skills/ этого руководства, это повторно используемый пакет знаний для вида задач: каталог, содержащий файл SKILL.md, в котором сказано, когда его использовать и как выполнять работу. В документации Claude Code навык это каталог с обязательным файлом SKILL.md, у которого во вступительной части (frontmatter) указаны имя и описание, а в теле даны инструкции; помощник использует описание, чтобы решить, когда применять навык, и загружает тело целиком только когда он используется.

Промпт Навык
Область Одна задача, сейчас Вид задач, многократно
Где живет В чате или документе В папке, например skills/ или каталоге навыков проекта
Кто меняет Вы, каждый раз Команда, с рецензированием
Лучше всего для Конкретного анализа вашего собственного материала Повторяемых методов, таких как проведение ретроспективы

Как построены промпты руководства

Промпты в этом руководстве следуют простой схеме, изложенной в руководстве по стилю:

  1. Жирная однострочная цель говорит, для чего промпт.
  2. Блок в ограждении содержит текст, который можно скопировать и вставить.
  3. Заполнители в квадратных скобках отмечают, что вы должны предоставить, с подсказкой, что туда поместить.
  4. Задача, называющая желаемый результат.
  5. Границы: не выдумывать числа, источники, цитаты или заявления о соответствии; использовать только вставленный материал.
  6. Просьба сначала спросить, если информации не хватает, и отметить допущения.
  7. Заключительная проверка: «List what you are unsure of» («Перечислите, в чем вы не уверены»).

У этих частей есть причины. Заполнители заставляют вас приносить реальный материал. Граница мешает помощнику заполнять пробелы выдумкой. Просьба об уточняющих вопросах превращает однократную догадку в короткий разговор. Последняя строка заставляет помощника отмечать собственные слабые места, что помогает вам решить, что проверять.

Приемы, которые помогают

Навык руководства prompt-engineering перечисляет приемы, которые это руководство кратко излагает своими словами:

  • Будьте конкретны в желаемом результате, например таблица с названными столбцами или нумерованный перечень не более чем из пяти пунктов, чтобы помощник не гадал о форме.
  • Давайте примеры, когда инструкции двусмысленны, показывая нужный шаблон в коротком образце.
  • Предоставляйте контекст, которого помощник знать не может, такой как ваша терминология, ограничения и рассматриваемый документ, и говорите, чего ему не следует предполагать.
  • Итерируйте на реальных тестовых случаях, запуская промпт на разнообразных реальных входных данных и пересматривая там, где он не срабатывает, вместо суждения по одному хорошему примеру.

Промпт, настроенный на одни входные данные, может не сработать на других. Навык подчеркивает, что короткий, странно сформулированный ввод или ввод с отсутствующим полем может сломать промпт, справлявшийся с исходным примером.

Привычки проверки

Каждый результат нуждается в проверке соразмерно цене ошибки. Привычки, которые помогают:

  • Сверяйте факты с вставленным вами источником. Просите помощника цитировать часть вашего материала, подтверждающую каждое утверждение.
  • Никогда не принимайте ссылки, которых вы не видели. Случаи, описанные в предыдущей теме, включают выдуманные судебные цитаты; не повторяйте их.
  • Отделяйте то, что помощник видел, от того, что он предположил. Промпты руководства об этом просят.
  • Проверяйте расчеты сами или просите ход вычислений и проверяйте его.
  • Используйте второй взгляд для всего, что покидает команду, например ответа заказчику или политики.
  • Ведите записи значимых использований, как описано в Тема 6.2 — ИИ в управлении ИТ-услугами.

Защита данных

Прежде чем вставлять что-либо в промпт, спросите, что это содержит и куда пойдет. Удаляйте персональные данные, учетные данные и конфиденциальные коммерческие подробности, если инструмент и его условия не утверждены для них (см. Тема 3.13 — Управление информационной безопасностью). Промпты руководства просят вас обезличивать, но ответственность ваша. В сомнении описывайте ситуацию в общих терминах.

Как выглядит навык

По документации Claude Code и навыкам этого руководства, навык это каталог вроде skills/runbook/, содержащий SKILL.md. Файл начинается с вступительной части YAML между маркерами ---, содержащей как минимум name и description. Документация говорит, что описание сообщает помощнику, что делает навык и когда его использовать, и рекомендует ставить ключевой случай использования первым. Тело излагает метод в markdown. Другие файлы, такие как справочные документы или сценарии, могут находиться рядом и загружаться при необходимости; документация советует держать сам SKILL.md коротким, менее 500 строк.

Скопированные навыки этого руководства следуют той же форме. Их описания начинаются с «Use when asked to…» («Используйте, когда просят…»), что ясно показывает, когда каждый применим.

Где живут навыки

Документация описывает личные навыки в домашнем каталоге навыков пользователя, навыки проекта в каталоге навыков репозитория, которые можно фиксировать и разделять с командой, и другие места, такие как плагины. Для команды естественное место это папка проекта под управлением версий: навыки рецензируются, меняются тем же процессом, что и другая работа, и доступны всем.

Написание собственных командных навыков

Командный навык фиксирует практику, которую команда повторяет и хочет выполнять последовательно. Примеры для управления услугами: как написать постмортем в вашем стиле, как сортировать определенный вид заявок, как подготовить запрос на изменение, как провести вашу пятничную проверку. Чтобы написать его:

  1. Выберите задачу, которую повторяете и для которой известен хороший способ выполнения.
  2. Сначала напишите описание, начав с «Use when…» и ключевого случая использования, чтобы помощник и ваши коллеги знали, когда он применим.
  3. Напишите метод короткими шагами, с форматом результата, проверками и тем, чего следует избегать.
  4. Добавьте примеры хорошего результата с удаленными чувствительными подробностями.
  5. Скажите, чего он делать не должен, например выдумывать цифры или отправлять что-либо без проверки.
  6. Проверьте на реальных случаях и пересмотрите.
  7. Дайте ему владельца и дату пересмотра, как любому другому общему документу.

Навыки в этом руководстве

Папка skills/ в этом репозитории содержит копии навыков из коллекции skills-on-ai, перечисленных в skills/README.md, и два навыка, написанных для этого руководства: один для читателей и один для сопровождающих. Каждая тема ссылается на навыки, наиболее полезные для ее предмета, с предложением о том, когда использовать каждый. Скопированные навыки общие, не привязанные к содержанию этого руководства, поэтому используйте их как отправные точки и адаптируйте их результат к вашему контексту.

Пределы

Ни один источник, прочитанный для этого руководства, не измеряет, насколько хорошо работает любой прием промптинга, а инструменты ИИ быстро меняются. Прочитанная документация Claude Code была длинной и прочитана лишь частично. Далее практические советы, которые держались при общем использовании, предлагаемые как привычки для проверки, а не как гарантии.

Лучшие практики

  1. Начинайте с реальной задачи и реального материала. Выберите то, что вам нужно сделать, и вставьте фактические данные, а не их описание. Заполняйте каждый заполнитель конкретикой.
  2. Формулируйте цель в одной строке. Скажите, для чего результат и кто им будет пользоваться. Это помогает помощнику выбрать правильный уровень детализации.
  3. Определите результат. Назовите формат, длину и структуру, которые вам нужны. Просите таблицу, когда хотите сравнить, и перечень, когда хотите шаги.
  4. Задайте границы. Скажите, чего помощник делать не должен: выдумывать числа, источники или цитаты; предполагать факты, которые не даны; утверждать, что правило применимо, без текста.
  5. Сначала просите уточняющие вопросы. Скажите помощнику, чтобы он спросил, что ему нужно, прежде чем отвечать. Отвечайте кратко, затем просите продолжить.
  6. Просите отделять факты от допущений. Пусть он отмечает, что взял из вашего материала и что предположил. Промпты этого руководства заканчиваются «List what you are unsure of».
  7. Запрашивайте свидетельства. Просите цитаты из вашего материала, подтверждающие каждое утверждение, чтобы вы могли быстро проверить.
  8. Итерируйте. Относитесь к первому ответу как к черновику. Скажите, что неверно, и попросите пересмотр или измените промпт и попробуйте снова.
  9. Проверяйте промпты на нескольких случаях. Прежде чем полагаться на промпт, прогоните его на трех-четырех реальных входных данных, включая необычные. Отметьте, где он не срабатывает.
  10. Защищайте данные. Удаляйте персональные и конфиденциальные подробности перед вставкой. Используйте утвержденные инструменты. Следуйте политике вашей организации.
  11. Проверяйте перед использованием. Сверяйте факты, числа и ссылки. Пусть человек просматривает все, что идет заказчикам или меняет систему.
  12. Делитесь тем, что работает. Помещайте промпты, оказавшиеся полезными, с заметками в командный навык или документ под управлением версий с владельцем.

Вопросы для обсуждения с командой

Какие повторяющиеся задачи могла бы помочь выполнить помощник и что нам нужно было бы проверять?

Попросите каждого перечислить задачи и отметить риск, если бы результат был неверным. Сгруппируйте их по низкому, среднему и высокому риску. Начните с низкорисковой. Ведущий может спросить, каким будет шаг проверки. Выберите одну задачу для испытания.

Что мы вставляем в инструменты ИИ сегодня и стоит ли?

Будьте честны и не осуждайте. Перечислите примеры. Сравните с политикой данных и утвержденными инструментами. Договоритесь о быстрой проверке, которую люди могут применять перед вставкой: «содержит ли это персональные данные, секреты или конфиденциальные подробности?»

Какие из промптов этого руководства мы попробовали бы первыми и с каким реальным материалом?

Вместе просмотрите промпты и выберите один. Определите реальный материал для вставки, удалите чувствительные подробности и запустите. Сравните результаты и обсудите, что изменить в промпте. Это быстрый способ усвоить схему.

Как мы узнаем, что промпт работает?

Попросите тестовый набор: несколько реальных входных данных с известными хорошими результатами. Обсудите, как оценивать ответы и кто решает. Промпт без тестового набора это надежда. Договоритесь о небольшом наборе для одного промпта.

Какую практику мы повторяем, заслуживающую стать командным навыком?

Перечислите кандидатов: формат пересмотра, рутина сортировки, шаблон отчетов. Выберите один и вместе составьте описание и шаги. Решите, кто им владеет и когда он будет пересмотрен.

Что мы никогда не хотели бы, чтобы ИИ делал самостоятельно?

Перечислите действия: отправка заказчикам, изменение промышленной среды, согласование доступа, решение о приоритете. Обсудите почему. Ответы это границы, которые надо записать в ваши промпты и навыки. Договоритесь о коротком перечне.

На практике: пример agile ITIL

В службе поддержки ИТ региональной больницы четырнадцать аналитиков. Руководитель службы заметила, что коллеги пользуются ИИ-помощником по-разному: один вставляет целые заявки, включая имена пациентов, в публичный чат-бот; другой пишет сложные промпты и получает полезные сводки; большинство не пользуется вовсе. Недавняя статья базы знаний, составленная помощником, содержала шаг процедуры, которого не существовало.

Руководитель проводит часовую сессию в подходе этого руководства. Она начинает с данных: группа договаривается о правиле, что никакие данные пациентов или учетные данные не вводятся ни в один инструмент и что утвержденный помощник, лицензированный больницей на подходящих условиях, единственный, которым пользуются с текстом заявок. Она выбирает одну задачу, составление статьи базы знаний по решенной заявке, и использует схему из промптов этого руководства: однострочную цель, заполнитель для обезличенной заявки, инструкции использовать только содержание заявки, отмечать любой выведенный шаг тегом и перечислять, в чем он не уверен. Двое аналитиков запускают промпт на пяти прошлых заявках, и группа вместе читает результаты. В одном случае промпт выдумывает шаг; они добавляют строку с просьбой привести цитату из заявки для каждого шага.

Руководитель пишет улучшенный промпт как командный навык в общей папке службы, с описанием, начинающимся с «Use when…», владельцем и датой пересмотра, и добавляет правило, что каждую составленную статью проверяет второй аналитик перед публикацией. Через два месяца число статей, составляемых в неделю, удвоилось, а рецензенты находят меньше ошибок, чем прежде. Некоторые вопросы остаются. Двое аналитиков по-прежнему вставляют подробности в публичный инструмент под давлением, навык порождает слишком официальные формулировки, которые аналитики переписывают, а один рецензент признается, что пролистывает. Руководитель повторяет правило данных на каждой встрече команды, добавляет в навык пример стиля и просит рецензентов отмечать короткий контрольный список.

Четыре точки зрения

Продуктовые команды и команды поставки

Команды поставки используют помощников для кода, тестов и документации. Применяйте те же привычки: реальный материал, ясные границы, проверка и рецензирование. Держите секреты вне промптов и храните полезные промпты и навыки вместе с кодом.

Сервисные и операционные команды

Команды эксплуатации могут использовать промпты для анализа заявок, составления ранбуков и подготовки разборов. Держите персональные данные вне, сверяйте результаты с журналами и записями и пишите навыки для рутин, которые команда повторяет, таких как постмортемы и передачи смен.

Руководство и управление

Руководители задают правила того, что можно использовать, с какими данными и кто отвечает. Просите инвентарь, политику данных и свидетельства из пилотов. Поддерживайте время для команд на написание и проверку промптов и навыков и позаботьтесь, чтобы у общих навыков были владельцы.

Заказчики и пользователи

Заказчики и пользователи могут видеть результаты промптов и навыков в ответах, статьях и сводках. Ожидайте, что поставщики их проверяют и сообщают вам, когда используют автоматические инструменты там, где это важно. Сообщайте об ошибках, которые помогают улучшать лежащий в основе материал.

Типичные причины неудач

  • Расплывчатые просьбы. Помощник гадает. Вместо этого предоставляйте материал, цель и желаемый результат.
  • Вставка чувствительных данных. Персональные или конфиденциальные подробности покидают организацию. Вместо этого удаляйте их и используйте утвержденные инструменты.
  • Принятие выдуманного содержания. Используются сфабрикованные шаги, числа или ссылки. Вместо этого задавайте границы, просите цитаты и проверяйте.
  • Настройка по одному примеру. Промпт сработал один раз и не срабатывает в других случаях. Вместо этого проверяйте на нескольких реальных входных данных.
  • Навыки без владельцев. Общие промпты устаревают. Вместо этого назначьте владельца и дату пересмотра и храните их под управлением версий.
  • Чрезмерное доверие к скопированным промптам. Промпт из интернета или этого руководства используется без изменений. Вместо этого адаптируйте к вашему контексту и проверяйте результаты.
  • Нет второго взгляда. Результат ИИ идет прямо заказчикам. Вместо этого пусть человек просматривает все, что покидает команду.
  • Восприятие помощника как авторитета. Его уверенность принимают за правильность. Вместо этого просите указать, в чем он не уверен, и проверяйте.

Модель зрелости

Измерение Инициация Развитие Стандартизация Управление Оркестрация
Практика промптов Люди пишут произвольные промпты Некоторые люди делятся промптами Команды используют общую схему с целью, материалом, границами и проверками Качество промптов проверяется на наборах реальных случаев Промпты улучшаются между командами по общим результатам тестов
Навыки Нет общих навыков Существуют некоторые личные навыки Командные навыки с владельцами и датами пересмотра живут в системе контроля версий Использование и результаты навыков пересматриваются Навыки разделяются и поддерживаются между командами и партнерами
Проверка и данные Результату доверяют; данные вставляют свободно Есть некоторые проверки и правила данных Привычки проверки и политика данных рутинны Ошибки и инциденты с данными отслеживаются, по ним действуют Проверка и практика данных координируются по организации
Обучение Обучение индивидуально Разделяются некоторые советы Команды проводят регулярные сессии по улучшению промптов и навыков Улучшения отслеживаются и измеряются Обучение непрерывно распространяется между командами

Контрольный список

  • У команды есть короткое правило о том, какие данные можно вводить в какие инструменты ИИ.
  • У промптов, на которые мы полагаемся, есть заявленная цель, реальный материал, границы и просьба указать, в чем помощник не уверен.
  • Каждый промпт, на который мы полагаемся, проверен как минимум на трех реальных входных данных.
  • Результат, идущий за пределы команды, просматривает человек.
  • Ссылки и числа из результатов ИИ сверяются с источниками.
  • Полезные промпты сохраняются с заметками в общем месте под управлением версий.
  • У командных навыков есть ясное описание «Use when…», владелец и дата пересмотра.
  • Команда перечислила действия, которые ИИ никогда не должен выполнять самостоятельно.
  • Сотрудники знают, какие инструменты утверждены.
  • Мы пересматриваем промпты и навыки не реже двух раз в год.

ИИ-промпты

Назначение: улучшить промпт, которым вы уже пользуетесь.

Here is a prompt I use: [paste it].
Here is an example of an input I give it, with sensitive details removed: [paste].
Here is what I got: [paste].
Here is what I wanted: [describe].

Diagnose why the output fell short, using only the text above. Suggest a revised prompt that: states the purpose, names the output format, sets boundaries (no invented facts, numbers, or sources), asks for clarifying questions first, requests quotes from the supplied material as evidence, and ends by asking you to list what you are unsure of. Keep placeholders in [square brackets]. Do not change the task. List what you are unsure of.

Назначение: превратить повторяющуюся задачу в черновик командного навыка.

Help me draft a team skill in SKILL.md format for this task: [name and describe the task].

How we do it today, step by step: [paste].
What a good result looks like (an example with sensitive details removed): [paste].
What must never happen (for example inventing figures or sending without review): [list].

Write a SKILL.md with YAML frontmatter containing a name and a description that starts with "Use when" and puts the key use case first, then a body with the purpose, short method steps, output format, checks, and things to avoid. Keep it under 150 lines. Mark every item you added as an assumption. Ask clarifying questions first, and list what you are unsure of.

Назначение: построить небольшой тестовый набор для промпта.

I have a prompt that [describe what it does]: [paste it].

Help me design a test set of 5 to 10 inputs: typical cases, an unusual case, a case with a missing field, and a case where the right answer is "not enough information." Tell me what to collect from real examples (with sensitive details removed), how to record the expected output, and how to score results (correct, partly correct, wrong, confidently wrong, correctly declined). Do not invent test content; give me the categories and what to look for. Ask clarifying questions first, and list what you are unsure of.

Назначение: сверить черновик, написанный ИИ, с его источником.

Here is the source material: [paste].
Here is a draft produced by an AI tool from that material: [paste].

List every statement in the draft, say whether the source supports it (quote the supporting text), contradicts it, or does not mention it, and suggest edits to remove unsupported statements. Do not add facts of your own. Give a short summary of how reliable the draft is. List what you are unsure of.

ИИ-навыки

  • prompt-engineering: используйте, чтобы писать, проверять и улучшать промпты, чтобы они давали надежные результаты.
  • machine-learning-model-card: используйте, чтобы документировать, для чего служит модель и каковы ее пределы, когда ваша команда на нее полагается.
  • agile-coaching: используйте, когда помогаете команде выстроить привычки вокруг промптов и навыков со временем.
  • agile-itil-guide-skill: используйте, чтобы найти темы в этом руководстве, провести командную беседу по его вопросам или адаптировать один из его промптов.
  • agile-itil-guide-maintainer-skill: используйте при написании или проверке темы, промпта или ссылки на навык для этого руководства.

Ключевые источники

  • Claude Code skills documentation (code.claude.com): описание того, как навыки строятся как каталоги с файлом SKILL.md.
  • Prompt engineering (skills/prompt-engineering/SKILL.md этого руководства): краткое изложение приемов и довод в пользу проверки промптов на реальных входных данных.
  • Large language model (Wikipedia): справка о том, как строятся эти системы и где они могут отказывать.
  • AI Risk Management Framework (NIST): добровольная рамочная программа управления рисками ИИ, полезная для командной политики.

Источники

  1. Skills (Claude Code documentation) — Anthropic — https://code.claude.com/docs/en/skills
  2. Large language model — Wikipedia — https://en.wikipedia.org/wiki/Large_language_model
  3. Prompt engineering — Wikipedia — https://en.wikipedia.org/wiki/Prompt_engineering
  4. AI Risk Management Framework — NIST — https://www.nist.gov/itl/ai-risk-management-framework
  5. Hallucination (artificial intelligence) — Wikipedia — https://en.wikipedia.org/wiki/Hallucination_(artificial_intelligence)
  6. Retrieval-augmented generation — Wikipedia — https://en.wikipedia.org/wiki/Retrieval-augmented_generation
  7. Artificial intelligence — Wikipedia — https://en.wikipedia.org/wiki/Artificial_intelligence
  8. Version control — Wikipedia — https://en.wikipedia.org/wiki/Version_control
  9. Information security — Wikipedia — https://en.wikipedia.org/wiki/Information_security