Рекомендации по оперативному проектированию
Относитесь к подсказкам как к коду: дайте им структуру, версионируйте их, оценивайте. Ниже приведены шесть практик, которые пережили десятки производственных путей на Starsg — те, которые последовательно двигали иглу, в том порядке, в котором они имеют значение.
1. Установите роль и цель
Первые одна или две строки должны зафиксировать перспективу модели: кто она, для кого она пишет, как выглядит успех. Плотность терминов, тон и выбор того, что включать, — все это выходит из этого якоря — гораздо дешевле, чем потом возвращать модель обратно с «не слишком многословием» или «не слишком академичностью». Солидное начало отвечает на три вещи: идентичность, аудитория, цель.
Шаблон настройки ролей
Вы инженер по связям с разработчиками. Аудитория: бэкэнд-инженеры, знакомые с API-интерфейсами HTTP, но плохо знакомые с LLM и ценообразованием на основе токенов. Цель: за три минуты помочь читателю решить, стоит ли интегрировать Starsg, и рассказать ему, что делать дальше. Используйте простой, но профессиональный тон. Избегайте маркетинговой чепухи.
2. Пишите задачу явно
«Напишите аннотацию о продукте» передает каждое решение модели — каждый запуск — это предположение. Многоразовая инструкция состоит как минимум из пяти элементов: действие (написать/обобщить/перевести), объект (что), аудитория (для кого), тон/стиль и длина или форма. Произнесите их по буквам, и ваша выходная стабильность сразу же поднимется на новый уровень.
❌ Слишком расплывчато
Напишите мне аннотацию о продукте.
✅ Все пять элементов
Говоря словами ~200, для серверных инженеров представьте три отличительных признака Starsg (унифицированный шлюз, биллинг по ключам, резервный вариант для нескольких моделей). Тон: профессиональный и сдержанный. Избегайте таких слов, как «расширение возможностей» или «следующее поколение». Закончите одним конкретным призывом к действию.
3. Предоставьте контекст и примеры (несколько кадров)
Чем более абстрактно требование, тем больше примеров зарабатывают на жизнь. Одна-три пары «вход → ожидаемый результат» стоят десяти строк объяснения. Небольшое количество кадров особенно важно, когда формат фиксирован (классификация, извлечение, JSON), когда стиль трудно описать словами или когда в предметной области существуют свои собственные соглашения (юридические, медицинские, внутренние системы). Пусть примеры охватывают реальное распределение, а не только простые случаи.
Пример извлечения нескольких кадров
Из текста заявки в службу поддержки ниже извлеките три поля: «type / scope / severity». Вывод только JSON.
Пример 1:
Данные: пользователи сообщают об ошибках входа в систему по всему региону Гуанчжоу; поддержка по телефону перегружена.
Вывод: {"type":"login","scope":"Guangzhou region","severity":"P1"}
Пример 2:
Ввод: тестовый аккаунт показывает неверный баланс; затрагивается только внутренний контроль качества.
Вывод: {"type":"account","scope":"internal QA","severity":"P3"}
Теперь обработайте:
Ввод: шлюз Пекина API возвращает 502; затронуты все платные пользователи.4. Ограничить выходной формат
Все, что потребляет нижестоящая система, должно быть доступно для анализа. JSON? Предоставьте схему и примечания к полям. Список? Закрепите количество и форму каждого предмета. Длина шапочки? Скажи так. Добавьте оговорку типа «если поле отсутствует, установите его в ноль — не выдумывайте» и вы измеримо сократите галлюцинации.
Ограничение вывода JSON
Преобразуйте приведенное ниже резюме в JSON, строго в соответствии с этой схемой:
{
"name": string,
"yearsOfExperience": number,
"skills": string[], // at most 5, lowercase
"summary": string // <= 60 words
}
Если в источнике не упоминается поле, установите его в значение null — не выдумывайте. Вывод только JSON, без окружающего текста.5. Декомпозировать сложные задачи (с помощью цепочки мыслей)
Если попросить модель «проанализировать + спланировать + произвести» за один раз, обычно теряются детали или рассуждения рассматриваются как окончательный ответ. Два варианта: позволить ему думать поэтапно внутри себя или самому разбить работу на несколько ходов. Для проверяемых рабочих процессов мы предпочитаем последнее — сохраняйте все промежуточные этапы, чтобы позже можно было определить, какой шаг не удался.
Пошаговый шаблон
Я дам вам спецификацию продукта. Обработайте его в три этапа и отделите каждый заголовком ##: ## 1. Ключевая информация Маркированный список: целевой пользователь, основной сценарий, обязательные функции, вещи, явно выходящие за рамки. ## 2. Риски и неясные моменты Перечислите в спецификации все двусмысленное или противоречивое, по одному предложению на каждое. ## 3. Следующие шаги Дайте премьер-министру три конкретных, выполнимых следующих действия, упорядоченных по приоритету. Спецификация: <<< >>>
6. Повторяем и оцениваем
Хорошие подсказки не пишутся, они повторяются. Создайте фиксированный оценочный набор (случаи 20–50, охватывающие нормальный + крайний + состязательный). Запускайте его при каждом изменении приглашения и записывайте частоту попаданий, среднюю длину и стоимость токена. Версируйте свои подсказки как код — каждое изменение имеет причину и базовую линию регрессии, никаких «на этот раз кажется лучше».
- Фиксированный набор данных, охватывающий обычные, крайние и состязательные случаи.
- Меняйте одну переменную на итерацию (инструкцию, количество примеров, ограничение формата) — иначе атрибуция будет мутной.
- Отслеживайте частоту попаданий/среднее количество токенов/режимы сбоев для каждой версии на одном листе.
- Тестируйте разные модели: на Claude/GPT/Gemini одна и та же подсказка часто ведет себя по-разному.