# SE: Tech Writer

Субагент пишет технические руководства и проектную документацию, включая архитектурные решения (ADR). Пригодится, когда нужно структурировать базу знаний без лишней рутины.

- субагент · `type=agent` · GitHub Copilot · ★ 40451
- Автор: github · официальный репозиторий GitHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/github/awesome-copilot/tree/HEAD/agents/se-technical-writer.agent.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/agents/se-tech-writer

## Что делает

Субагент спроектирован под модель GPT-5 и использует встроенные инструменты окружения: `codebase`, `edit/editFiles`, `search` и `web/fetch`. Это позволяет ему изучать файлы репозитория, проверять внешние источники и сразу вносить правки в проектные тексты.

Внутри заложены шаблоны для популярных форматов материалов. Он умеет собирать пошаговые туториалы, пользовательские гайды, справочники по API и архитектурные решения по формату Майкла Нигарда (Michael Nygard ADR). Под каждый тип документа субагент адаптирует стиль изложения, разделяя подачу для новичков, опытных разработчиков или тимлидов.

При работе он напрямую опирается на доступ к файлам репозитория. Если у агента нет прав на редактирование через инструмент `edit/editFiles`, сохранять сгенерированные файлы на диск придётся вручную.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/agents/se-technical-writer.agent.md`

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/agents/se-technical-writer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию. Поле tools у Copilot перечисляет инструменты по-своему — уберите его или перепишите под Claude Code

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/se-technical-writer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/se-technical-writer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/github/awesome-copilot/tree/HEAD/agents/se-technical-writer.agent.md

## Когда брать
- оформить архитектурную запись решения по стандарту ADR
- написать пошаговое руководство для пользователей продукта
- подготовить черновик технической статьи на основе кода в репозитории
- документировать интерфейсы и параметры API по готовым шаблонам

## Примеры запросов агенту
- Опиши архитектурное решение по переходу на PostgreSQL в формате ADR, указав контекст и последствия
- Напиши пошаговый туториал по настройке аутентификации в нашем проекте на базе текущего кода
- Подготовь техническую статью для блога о решении проблемы с утечкой памяти в сервисе

## Похожие
- [Tech Writer](https://affpapa.org/nevibecode/prompts/tech-writer.md) — промпт · ★ 174676
- [documentation-and-adrs](https://affpapa.org/nevibecode/skills/documentation-and-adrs.md) — скилл · 63800 установок
- [adev-writing-guide](https://affpapa.org/nevibecode/skills/adev-writing-guide.md) — скилл · 912 установок
- [architecture-decision-records](https://affpapa.org/nevibecode/skills/affaan-m-architecture-decision-records.md) — скилл · 4900 установок
- [prompt-engineer](https://affpapa.org/nevibecode/agents/voltagent-community-prompt-engineer.md) — субагент · 16078 установок
- [context-manager](https://affpapa.org/nevibecode/agents/context-manager.md) — субагент · 10638 установок
- [code-explorer](https://affpapa.org/nevibecode/agents/code-explorer.md) — субагент · 1172 установки
- [search-specialist](https://affpapa.org/nevibecode/agents/search-specialist.md) — субагент · 6886 установок

Из того же набора: [github/awesome-copilot](https://affpapa.org/nevibecode/by/github/awesome-copilot.md) — 949 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md