IT и разработка

Технический писатель — документация и инструкции

Напишет инструкцию, README или описание API так, чтобы по ним смог пройти человек не из команды.

Открыть ассистента в чате Нужен аккаунт: регистрация через Яндекс ID или почту, новому аккаунту кладём 30 ₽ на баланс. Без аккаунта работает обычный чат — три сообщения в сутки.

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

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

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

Что умеет

  • Инструкции для сотрудников и пользователей
  • README и описание запуска проекта
  • Описание методов API с примерами запроса и ответа
  • Перевод технического текста на человеческий язык

Что пишут чаще всего

Инструкция для сотрудников

Как выгрузить отчёт, оформить заявку, подготовить рассылку. С шагами, скриншот-заглушками и типичными ошибками.

README и запуск проекта

Требования, установка, конфигурация, запуск, частые проблемы. Формат, который экономит часы новому разработчику.

Описание API

Метод, параметры, пример запроса и ответа, коды ошибок и что делать при каждой.

С чего начать

Нажмите пример — он откроется в чате уже вписанным в поле ввода, останется поправить под себя и отправить.

Как это работает и сколько стоит

Ассистент — это чат с уже настроенной ролью: системный промпт задан заранее, объяснять модели, кем ей быть, не нужно. Отвечает DeepSeek V4 Flash — самая дешёвая модель каталога: обычное сообщение с развёрнутым ответом обходится примерно в две копейки, и её хватает на подавляющее большинство задач. Нужна модель посильнее — переключите её прямо в чате, роль при этом останется.

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

Как получить инструкцию, по которой пройдут

Расскажите процесс так, как делаете сами, включая мелочи.

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

Частые ошибки

  • Пропускать очевидные для себя шаги: именно на них и спотыкаются новички
  • Писать «нажмите кнопку», не сказав, где она находится
  • Оставлять инструкцию без даты и владельца — через полгода никто не знает, актуальна ли она

Чего он не делает

  • Поведение вашей системы он не знает: недостающее пометит вопросом
  • Скриншоты и схемы не делает — только текст

Частые вопросы

Как получить инструкцию, по которой реально пройдут?

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

Подойдёт для внутренних регламентов?

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

Он сделает скриншоты?

Нет, только текст. Но разметит, где нужны изображения и что на них должно быть видно.

Подойдёт для внутренних регламентов?

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

Разборы по теме в блоге

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

Другие ассистенты

Из того же раздела «IT и разработка»: Программист · SQL-помощник · Ревьюер кода. Полный список — в каталоге ИИ-ассистентов, отдел целиком — it и разработка.

Похожие по задачам: Программист · Деловая переписка · Редактор-корректор.