Агент Writer — текст под конкретную аудиторию
Как агент Writer в Datarim создаёт техническую документацию, статьи для блога и контент для социальных сетей — с учётом формата, регистра и ограничений платформы.
Pull request требует записи в changelog. Новая функция — раздел в README. Завершённый спринт — пост в блоге. Каждая из этих задач предполагает разный вид текста, и один универсальный промпт редко даёт правильный результат для всех трёх. Агент Writer охватывает весь диапазон — от документации API до поста в Telegram — рассматривая аудиторию и платформу как основные вводные.
Агент запускается на /dr-write и участвует в /dr-archive, где на шаге рефлексии готовит финальный обзор документации.
Что он создаёт
По технической части: файлы README, справочная документация по API (OpenAPI, JSDoc, docstrings), записи о решениях по архитектуре, changelogs, руководства по миграции, документы для устранения неполадок. По контентной: статьи с проверкой фактов, практические руководства, посты для Telegram, LinkedIn, Twitter/X и Facebook, адаптированные под каждую платформу. Вывод на двух языках — английском и русском — входит в стандартные возможности, а не является отдельным режимом.
Каждый тип вывода имеет свои ограничения. Текстовый пост в Telegram обрезается примерно после 4 000 символов. Docstring должен оставаться рядом с описываемым кодом. Writer применяет эти ограничения в процессе написания, а не после.
Один конкретный пример
Возьмём новый эндпоинт аутентификации. Writer создаёт из одного источника три вещи: блок JSDoc с описанием параметров и возвращаемых значений для разработчика, читающего код; раздел руководства по миграции с объяснением изменений для команд, обновляющихся с предыдущей версии; короткое объявление в Telegram для широкой технической аудитории. Три аудитории, три регистра, одна задача.
Применяемые принципы письма
Агент следует набору правил, которые противодействуют типичным паттернам ИИ-текстов. Одна идея на абзац. Конкретное вместо абстрактного — название конкретной технологии, реальное число. Активный залог там, где возможно. Никаких слов-заполнителей. Для контента в социальных сетях есть дополнительное правило: ссылки выносятся в первый комментарий, а не в тело поста — это платформенная конвенция Facebook, LinkedIn и Telegram, которая сохраняет читаемость текста.
Место в пайплайне
Writer работает на модели класса Sonnet — достаточно структурированной для дисциплинированного вывода и достаточно быстрой для итеративных черновиков. Когда черновик требует проверки фактов, агент загружает скил factcheck. Когда есть риск механического звучания, скил humanize предоставляет справочник конкретных паттернов, которых нужно избегать.
Полный список возможностей — на карточке агента Writer, а общую картину даёт пост что такое Datarim.