# docs-specialist

Субагент docs-specialist для Claude Code проверяет документацию по исходному коду и помогает обновлять файлы проекта. Проверяет README, API-справки и руководства.

- субагент · `type=agent` · Claude Code, Codex, OpenCode, Cursor, GitHub Copilot · ★ 539 у репозитория
- Автор: ZaxbyHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.github/agents/docs-specialist.agent.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/docs-specialist

## Что делает

docs-specialist сначала изучает существующие документы и код, затем составляет аудит: отмечает устаревшие сведения, сломанные ссылки и пробелы. Он сверяет описания поведения с реализацией, чтобы не переносить в документацию непроверенные утверждения. В работе использует инструменты `read`, `search` и `edit`.

Субагент умеет планировать структуру документации, писать и править тексты, проверять Markdown, ссылки и примеры кода. Исходный код он не меняет без прямого указания, а перед крупной переработкой предлагает план. Для широкого аудита сначала потребуется просмотреть файлы проекта; изменение документации начинается после согласования аудита, если задача не узкая и очевидная.

## Установка

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

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

### Claude Code

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.github/agents/docs-specialist.agent.md

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

## Примеры запросов агенту
- Проведи аудит документации проекта и сначала покажи найденные пробелы.
- Сверь описание публичных функций в документации с исходным кодом и исправь расхождения.
- Подготовь README с установкой и быстрым стартом, не меняя исходный код.

## Похожие
- [code-documentation](https://affpapa.org/nevibecode/skills/code-documentation.md) — скилл · 2000 установок
- [technical-documentation](https://affpapa.org/nevibecode/skills/technical-documentation.md) — скилл · 1900 установок
- [dd-docs](https://affpapa.org/nevibecode/skills/dd-docs.md) — скилл · 2000 установок
- [looking-up-docs](https://affpapa.org/nevibecode/skills/looking-up-docs.md) — скилл · 106 установок
- [find-docs](https://affpapa.org/nevibecode/skills/find-docs.md) — скилл · 10600 установок
- [context7-docs](https://affpapa.org/nevibecode/plugins/context7-docs.md) — плагин · ★ 2858 у репозитория

Из того же набора: [zaxbyhub/opencode-swarm](https://affpapa.org/nevibecode/by/zaxbyhub/opencode-swarm.md) — 121 карточка

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

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