Когда это нужноWhen to reach for itКоли це потрібно
Нужно написать или переписать документ, объяснить функциональность или структуру простым языком, отполировать README, справку, онбординг или заметки к релизу либо улучшить строки, которые видит пользователь.You need a doc written or rewritten, a feature or a structure explained in plain language, a README, help text, onboarding or release notes polished, or user-facing strings improved.Потрібно написати чи переписати документ, пояснити функціональність або структуру простою мовою, відполірувати README, довідку, онбординг чи нотатки до релізу або покращити рядки, які бачить користувач.
ТребованияRequirementsВимоги
- Где доступноAvailable inДе доступно
- Каждая загрузка kitEvery download of the kitКожне завантаження kit
- К чему обращаетсяWhat it touchesДо чого звертається
- Читает файлы проектаReads the files of your projectЧитає файли проєкту
- Правит файлы проектаEdits files in your projectЗмінює файли проєкту
- Работает сWorks withПрацює з
- Сделано для Claude Code; другие агенты адаптируютBuilt for Claude Code; other agents adapt itЗроблено для Claude Code; інші агенти адаптують
- Где выполняются шагиWhere the steps happenДе виконуються кроки
- Чат вашего агента и ваши собственные файлы. Ни то ни другое не интерфейс этого сайта, поэтому шаги описаны текстом, а не скриншотами.Your agent's chat and your own files. Neither is an interface of this site, so the steps are text and not screenshots.Чат вашого агента і ваші власні файли. Ні те, ні інше не є інтерфейсом цього сайту, тому кроки описано текстом, а не скриншотами.
- Где это лежит в kitWhere it lives in the kitДе це лежить у kit
.claude/agents/doc-writer.md
Прежде чем начатьBefore you startПерш ніж почати
У тепла есть границы. Предупреждение или обязательное действие никогда не прячутся за шуткой, смысл существующего текста не меняется ради дружелюбия, а юридические тексты, условия использования и машиночитаемые артефакты остаются формальными и нейтральными.The warmth has limits. A warning or a required action is never hidden behind a joke, existing text does not change meaning just to sound friendlier, and legal text, terms of service and machine-readable artifacts stay formal and neutral.У теплоти є межі. Попередження чи обов'язкова дія ніколи не ховаються за жартом, зміст наявного тексту не змінюється заради дружності, а юридичні тексти, умови користування та машиночитні артефакти лишаються формальними й нейтральними.
ШагиStepsКроки
- Передайте ему источник и цель: заметки, код, существующий документ или строку и файл или поверхность, для которых нужен текст. Сначала убедитесь, что заполнитель с названием проекта в файле агента заполнен под ваш проект.Hand it the source and the target: notes, code, an existing doc or a string, and the file or surface the text is for. First make sure the placeholder for the project name in its file is filled in for your project.Передайте йому джерело й мету: нотатки, код, наявний документ чи рядок та файл або поверхню, для яких потрібен текст. Спершу переконайтеся, що заповнювач з назвою проєкту у файлі агента заповнений під ваш проєкт.
- Сначала он определяет аудиторию: конечный пользователь, тестировщик, сопровождающий или разработчик.It identifies the audience first: end user, tester, maintainer or developer.Спершу він визначає аудиторію: кінцевий користувач, тестувальник, супровідник або розробник.
- Он читает источник и выделяет настоящий смысл, прежде чем переписывать. Если источник слишком расплывчат, он просит у вас недостающее продуктовое решение, а не заполняет пробел стилем.It reads the source and extracts the real meaning before rewriting. If the source is too vague, it asks you for the missing product decision instead of filling the gap with style.Він читає джерело й виділяє справжній зміст, перш ніж переписувати. Якщо джерело надто розпливчасте, він просить у вас бракуюче продуктове рішення, а не заповнює прогалину стилем.
- Он переписывает так: сначала ясность, потом тон, юмор в последнюю очередь. Инструкции остаются применимыми: что произошло, почему это важно, что делать дальше. Каждый технический факт, действительно нужный тексту, например версии, флаги и имена, сохраняется.It rewrites for clarity first, tone second, humour last. Instructions stay actionable: what happened, why it matters, what to do next. Every technical fact the text genuinely needs, such as versions, flags and names, is preserved.Він переписує так: спершу ясність, потім тон, гумор в останню чергу. Інструкції лишаються придатними до дії: що сталося, чому це важливо, що робити далі. Кожен технічний факт, справді потрібний тексту, наприклад версії, прапорці та імена, зберігається.
- Для строк, которые видит пользователь, он следует политике текстов и тона вашего проекта, пишет на языке целевого файла, если вы не попросили иначе, держит юмор лёгким и никогда не за счёт пользователя и не выдумывает поведение продукта, архитектуру или детали реализации.It follows the project's copy and tone policy for user-visible strings, matches the language of the target file unless you ask otherwise, keeps humour light and never at the user's expense, and does not invent product behaviour, architecture or implementation details.Для рядків, які бачить користувач, він дотримується політики текстів і тону вашого проєкту, пише мовою цільового файлу, якщо ви не попросили інакше, тримає гумор легким і ніколи не коштом користувача та не вигадує поведінку продукту, архітектуру чи деталі реалізації.
- Для зеркальных документов, например нескольких локалей, он держит варианты согласованными. Для строк интерфейса он делает текст достаточно компактным для целевой поверхности.For mirrored docs, such as several locales, it keeps the variants aligned. For user-facing strings it keeps the copy compact enough for the target surface.Для дзеркальних документів, наприклад кількох локалей, він тримає варіанти узгодженими. Для рядків інтерфейсу він робить текст достатньо компактним для цільової поверхні.
- Он сообщает аудиторию и цель текста, изменённые файлы или точный черновик, если правку файла вы не просили, любой компромисс в формулировках, существенно влияющий на смысл или тон, и всё, что нужно доделать в зеркальных документах, строках или вёрстке.It reports the audience and goal of the text, the files changed or the exact draft if you asked for no file edit, any wording trade-off that materially affects meaning or tone, and any follow-up needed for mirrored docs, strings or layout fit.Він повідомляє аудиторію й мету тексту, змінені файли або точну чернетку, якщо правки файлу ви не просили, будь-який компроміс у формулюваннях, що суттєво впливає на зміст чи тон, і все, що треба доробити у дзеркальних документах, рядках або верстці.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити
Готовый текст в целевом файле или точный черновик, если правку файла вы не просили, и короткая заметка: аудитория, цель, любой компромисс в формулировках, меняющий смысл или тон, и что осталось доделать в зеркальных документах, строках или вёрстке.Finished text in the target file, or the exact draft when you asked for no edit, plus a short note naming the audience, the goal, any wording trade-off that changes meaning or tone, and what is left to do in mirrored docs, strings or layout.Готовий текст у цільовому файлі або точна чернетка, якщо правки файлу ви не просили, і коротка нотатка: аудиторія, мета, будь-який компроміс у формулюваннях, що змінює зміст чи тон, і що лишилося доробити у дзеркальних документах, рядках або верстці.
СоветыTipsПоради
- Для механической синхронизации зеркальных документов описание самого агента отсылает к отдельному навыку синхронизации, если он есть в вашем проекте. Этого агента берите для самого письма.For mechanical sync of mirrored docs, the agent's own description points to a dedicated sync skill, if your project has one. Use this agent for the writing.Для механічної синхронізації дзеркальних документів опис самого агента відсилає до окремої навички синхронізації, якщо вона є у вашому проєкті. Цього агента беріть для самого письма.
- Назовите аудиторию сами, если знаете её. Первый шаг агента - определить её, и одно ваше предложение избавит его от догадки.Name the audience yourself when you know it. The agent's first move is to identify one, and a sentence from you saves it the guess.Назвіть аудиторію самі, якщо знаєте її. Перший крок агента - визначити її, і одне ваше речення позбавить його здогадки.
- Прочитайте компромиссы в формулировках из его отчёта: они отмечают места, где тон и смысл тянули в разные стороны, и именно на них стоит взглянуть ещё раз.Read the wording trade-offs in its report: they mark the places where tone and meaning pulled against each other, and they are the ones worth a second look from you.Прочитайте компроміси у формулюваннях з його звіту: вони позначають місця, де тон і зміст тягнули в різні боки, і саме на них варто глянути ще раз.
- Если документация - часть большей функциональности, где нужны ещё код и ревью, начните с rd-lead: в его описании работа с текстом отдана этому агенту.If the docs are one part of a bigger feature that also needs code and review, start with rd-lead; its own description sends prose to this agent.Якщо документація - частина більшої функціональності, де потрібні ще код і рев'ю, почніть із rd-lead: у його описі робота з текстом віддана цьому агентові.
Связанные функцииRelated functionsПов'язані функції
- Поручить нетривиальную работу ведущему агентуHand a non-trivial job to a lead agentДоручити нетривіальну роботу ведучому агентовіОдин ведущий агент ведёт запрос от первого чтения до проверенной работы: оценивает задачу, выбирает самый лёгкий подходящий путь и передаёт части другим агентам.One lead agent takes a request from first read to verified work: it classifies the job, picks the lightest path that fits and hands parts to other agents.Один ведучий агент веде запит від першого читання до перевіреної роботи: оцінює завдання, обирає найлегший придатний шлях і передає частини іншим агентам.
- Поручить запланированную работу исполнителю, который держится планаHave a planned change built exactly as the plan saysДоручити заплановану роботу виконавцю, що тримається плануИсполнитель среднего уровня выполняет шаг плана, исправление с известной причиной или тесты по структуре проекта и отчитывается:
expected | actual.A mid-tier maker executes a plan step, a fix with a known cause or tests in your project's structure, and reports each check asexpected | actual.Виконавець середнього рівня виконує крок плану, виправлення з відомою причиною чи тести за структурою проєкту й звітує:expected | actual. - Разобраться, как что-то устроено, прежде чем писать спекуInvestigate how something works before you write a specЗ'ясувати, як щось працює, перш ніж писати спекуАгент только для чтения собирает файлы, приёмы, ограничения и риски области и возвращает отчёт с доказательствами. Он ничего не правит.A read-only agent maps the files, patterns, constraints and risks of an area and returns an evidence-based report. It edits nothing.Агент лише для читання збирає файли, прийоми, обмеження та ризики галузі й повертає звіт із доказами. Він нічого не правит.