Перепишите статью базы знаний, сохранив точность инструкции

Определите одного читателя и одну задачу

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

Составьте карточку задачи: идентификатор статьи, аудитория, версия продукта, нужная роль, точные названия элементов интерфейса, ожидаемый результат, исключения и ответственный. Используйте утверждённые материалы. Неясный шаг пометьте для проверки, не поручая модели восполнить его по памяти. Руководство Google по процедурам рекомендует шаги с конкретным действием и контекстом его выполнения.

Вымышленный пример с неизменяемыми фактами

Представим вымышленный рабочий сервис. Участник может отключить личные письма в Settings → Notifications. Только владелец меняет общие настройки организации. Сохранённое изменение влияет на будущие письма, но не удаляет сообщения, уже стоящие в очереди. Это придуманные условия примера, а не возможности Colay.

Запросите разные структуры на одних фактах. Пошаговая инструкция нужна для немедленного выполнения задачи; разбор неполадок — тому, кто не находит настройку. FAQ объяснит исключение с очередью писем. Можно запросить восемь подходов, но они должны отвечать восьми ситуациям чтения, а не умножать одинаковые предложения.

Промпт, который отделяет редактуру от фактов о продукте

Используйте Ask separately в Colay, чтобы увидеть, как выбранные агенты понимают задачу. Сравните планы до доработки полных текстов. Если один ответ убрал условие о правах, а другие оставили, проверьте утверждённый источник. Совпадение ответов не заменяет прохождения описанной процедуры в продукте.

Перепиши утверждённую статью базы знаний: [текст]. Карточка задачи: [аудитория, версия продукта, роль, точные названия элементов, результат, исключения]. Подготовь пошаговую инструкцию, разбор неполадок и короткий FAQ. Сохрани все условия, права и исключения. Не выдумывай элементы интерфейса или поведение продукта. Для каждой версии укажи исходное предложение, на которое опирается каждый шаг. Неясные и противоречивые фрагменты вынеси в список вопросов. Предложи одну структуру для [ситуация читателя] и объясни выбор. Не объединяй молча факты о разных версиях продукта.

Превратите лучший черновик в готовую редакцию

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

1. Выберите структуру, которая соответствует карточке задачи. Заимствуйте удачные предложения из других вариантов только после проверки смысла.
2. Пройдите каждый шаг в поддерживаемой версии продукта с указанной ролью. Проверьте названия, порядок, результат и описанное исключение.
3. Прочитайте статью глазами нового пользователя: условия должны появляться до момента, когда они понадобятся, а неудачный шаг — иметь понятное продолжение.
4. Зафиксируйте проверяющего, версию статьи и изменённые разделы. Опубликуйте материал обычным способом, сохранив прошлую редакцию для сравнения.

Оценивайте правки по действиям читателя

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

Вопросы и ответы