Мой дэйли дайджест

одно техническое понятие в день

Мастер Claude · Блок 3. Субагенты

Урок 26 из 93 · ~10 мин чтения

Агент-редактор документов

Урок пока закрыт

Курс проходится последовательно.

К текущему уроку

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

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

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

Агент-редактор решает конкретную задачу: вы бросаете ему файл, он проверяет текст по вашим правилам стиля и возвращает исправленный документ. Не «советы что улучшить», а уже готовый текст с пометками «было → стало». Правила задаёте один раз в самом агенте — и больше к этому не возвращаетесь.

Что это такое

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

Агент-редактор в Claude Code устроен ровно так же. В его конфигурационном файле вы прописываете правила — любые, которые важны именно вам. Активный залог вместо пассивного. Конкретные цифры вместо расплывчатых «значительный рост». Короткие предложения вместо придаточных на три строки. Агент читает ваш документ через инструмент Read, применяет правила и вносит правки через Edit.

Ключевое отличие от «попросить Claude в браузере» — воспроизводимость. Когда вы в следующий раз попросите агента проверить другое письмо, он применит ровно те же правила, с той же строгостью. Ничего не нужно объяснять заново.

Второе важное отличие — разграничение ответственности. Вы принимаете решение о правилах один раз, когда пишете стайлгайд агента. Агент механически проверяет по ним текст. Вы принимаете финальное решение: оставить правку или откатить. Это другая структура работы, чем «попросить переписать» — и она даёт другой уровень контроля над результатом.

Технически агент — это файл .md в папке .claude/agents/ с двумя частями: frontmatter (конфигурация в YAML-блоке) и тело (промпт с инструкциями). Frontmatter указывает, какую модель использовать и какие инструменты доступны. Тело — это буквально инструкция, что делать с документом. Никакого кода, никаких скриптов — только текст.

Правила в агенте — это ваш корпоративный стиль, сохранённый в файле

Один раз сформулировали требования к деловым текстам — и теперь каждое письмо проверяется по ним автоматически. Это живёт в .claude/agents/doc-editor.md, а не в вашей голове.

Как работает на практике

Шаг 1. Создаём файл агента

Перейдите в корень вашего рабочего проекта (или в домашнюю папку, если агент нужен глобально) и создайте файл:

.claude/agents/doc-editor.md

Если папки .claude/agents/ ещё нет — создайте её. Это стандартное место для всех субагентов (об этом был День 22).

Шаг 2. Пишем конфигурацию агента

Вот рабочий файл агента-редактора с объяснением каждой секции:

---
name: doc-editor
description: Редактирует деловые документы по правилам стиля. Вызывать, когда нужно проверить письмо, служебную записку, ТЗ или отчёт перед отправкой.
model: opus
tools:
  - Read
  - Edit
---

Ты редактор деловых документов. Твоя задача — не советовать, а вносить правки.

## Правила стиля

**1. Активный залог**
Запрещено: «была проведена встреча», «было принято решение», «осуществляется контроль»
Требуется: «провели встречу», «решили», «контролируем»

**2. Конкретность вместо воды**
Запрещено: «значительный рост», «в ближайшее время», «ряд мер», «существенные изменения»
Требуется: конкретные цифры, даты, имена, названия

**3. Одна мысль — одно предложение**
Если предложение длиннее 25 слов — разбить на два. Придаточные через «который», «что», «поскольку» — по одному на предложение.

**4. Убрать канцелярит**
Слова под замену: «осуществлять» → делать/проводить/выполнять, «в целях» → чтобы, «в рамках» → в/по/при, «на сегодняшний день» → сейчас/сегодня, «является» → есть/—

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

## Алгоритм работы

1. Прочитай документ через Read
2. Найди все нарушения правил
3. Для каждого нарушения: запиши «было → стало» и причину (одно слово: залог/вода/длина/канцелярит/действие)
4. Внеси все правки через Edit
5. После правок выведи список изменений в формате:
   - [тип] «было» → «стало»
6. Если нарушений нет — скажи об этом явно

Шаг 3. Подготавливаем тестовый документ

Создайте файл ~/Документы/письмо-гд.md с текстом, который типично пишут перед редактурой:

# Письмо генеральному директору

Уважаемый Андрей Викторович,

В целях информирования вас о текущем состоянии дел по проекту интеграции 
CRM-системы, а также в рамках согласования дальнейших шагов, данное письмо 
было подготовлено.

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

Просим вас рассмотреть данный вопрос.

С уважением,
Павел

Это намеренно плохой текст: пассивный залог, вода, канцелярит, нет конкретного действия.

Шаг 4. Запускаем агента

claude "используй агента doc-editor, отредактируй ~/Документы/письмо-гд.md"

Claude Code автоматически найдёт агента по описанию в поле description и передаст ему задачу. Агент прочитает файл, применит правила, внесёт правки и выведет список изменений.

Обратите внимание на формулировку запроса: «используй агента doc-editor». Это явное указание на конкретного агента. Можно написать и без этого — «отредактируй письмо по правилам делового стиля» — тогда Claude Code сам выберет подходящего агента по полю description. Явное указание надёжнее, особенно когда у вас несколько агентов с похожими задачами.

Шаг 5. Смотрим результат

После работы агента файл будет изменён. Список изменений в терминале будет выглядеть примерно так:

Внесённые правки:

- [залог] «данное письмо было подготовлено» → «я подготовил это письмо»
- [залог] «нами было установлено» → «мы установили»
- [вода] «в ближайшее время» → «до 15 июня» (поставьте реальную дату)
- [вода] «значительный объём работ» → «60% задач первого этапа»
- [канцелярит] «в целях информирования» → «чтобы сообщить»
- [канцелярит] «осуществить ряд мероприятий» → «выполнить три задачи»
- [действие] добавлен явный призыв: «Прошу подтвердить встречу на 16 июня в 14:00»

Пометки «поставьте реальную дату» и «60% задач» — агент сигнализирует, что правку нужно уточнить

Агент не выдумывает конкретику, которой нет в тексте. Он ставит заглушку и помечает её. Ваша задача — заменить заглушку реальными данными.

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

Ошибка 1: Слишком много правил в одном агенте

Начинающие добавляют в стайлгайд агента всё подряд: стиль, структуру, тон, форматирование, SEO, юридические оговорки. Агент начинает «плавать» — правила конфликтуют между собой, приоритеты неясны, результат непредсказуем.

Как правильно: пять-семь чётких правил с примерами «запрещено / требуется». Это максимум для стабильной работы. Если нужно больше — создайте двух агентов с разными специализациями: один для стиля, второй для структуры.

Ошибка 2: Правила без примеров

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

Любое правило стиля должно содержать либо измеримый критерий, либо список запрещённых / разрешённых конструкций. Иначе агент будет применять его по-разному в зависимости от контекста — и вы не сможете предсказать результат.

Ошибка 3: Путать Edit с полной перезаписью

Инструмент Edit в агентах работает как точечные правки — он меняет конкретные фрагменты, не переписывает файл целиком. Если вы хотите, чтобы агент «написал письмо заново» — это другая задача, не редактура. Агент-редактор улучшает ваш текст, но сохраняет вашу логику и структуру.

Если агент начинает переписывать слишком много — скажите ему явно в промпте: «Сохраняй структуру и логику автора. Меняй только то, что нарушает правила стиля».

Ошибка 4: Забыть про список изменений

Агент, который молча правит файл, — бесполезен. Вы не знаете, что изменилось, не можете проверить, не можете решить, оставить ли правку. Всегда требуйте в промпте агента явный список «было → стало».

Если агент сделал правки без списка — это не баг, это недостаток инструкции. Добавьте в промпт пятый шаг алгоритма: «Выведи список всех изменений».

Хорошая практика — запросить у агента отдельно «сколько нарушений нашёл» и «какой тип чаще всего встречается». Это превращает редактуру в диагностику: если в пяти письмах подряд чаще всего встречается «канцелярит», значит это системный паттерн в вашем стиле письма — и его можно целенаправленно выработать.

Агент с Edit изменяет файл на диске немедленно

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

Когда нужно / когда нет

Агент-редактор нужен, если:

Агент-редактор не нужен, если:

Отдельный случай — многостраничные отчёты на 10+ страниц. Агент с Edit технически справится, но список изменений станет очень длинным и трудночитаемым. Для таких документов полезнее разбить работу: сначала прогнать агента по каждому разделу отдельно, потом собрать итоговую версию.

Правила стиля — это актив компании, а не инструкция для Claude

Когда вы формулируете стайлгайд для агента, вы на самом деле формулируете требования к деловым коммуникациям в вашей зоне ответственности. Этот файл можно показать новому сотруднику — он поймёт, как здесь принято писать.

Связь с другими уроками

День 22 — первый агент: структура .claude/agents/имя.md, поля name, description, model, tools. День 26 строится на том же фундаменте — если ещё не читали, прочитайте сначала его.

День 24 — ограничение инструментов: агенту-редактору нужны только Read и Edit. Никакого Bash, никакого WebSearch. Именно это обсуждалось на День 24 — минимальный набор инструментов как принцип безопасности и предсказуемости.

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

Задание на сегодня

Создайте агента-редактора и прогоните через него одно реальное письмо или служебную записку из своей почты.

Конкретно:
1. Создайте .claude/agents/doc-editor.md по шаблону из урока (адаптируйте правила под свой стиль — можно убрать или изменить любое из пяти)
2. Возьмите любое письмо, которое вы уже отправили на этой неделе — скопируйте текст в отдельный .md файл
3. Запустите: claude "используй агента doc-editor, отредактируй <путь к файлу>"
4. Посмотрите список изменений

Критерий «выполнено»: агент вывел список изменений в формате «было → стало» хотя бы с тремя пунктами. Если нарушений не нашёл — значит письмо уже было чистым, это тоже хороший результат.

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

Пять правил из урока — универсальные, но не обязательные. Если у вас другие требования к документам — замените. Агент будет работать с любым набором правил, которые вы ему дадите.

Резюме

Следующий урок откроется после отметки.