# docs-gen

Команда docs-gen анализирует кодовую базу и собирает API-документацию, руководства и справочные материалы. Подходит для генерации сайта документации и автодеплоя.

- команда · `type=command` · Claude Code, Cursor, Codex, GitHub Copilot, Gemini CLI · ★ 788 у репозитория
- Автор: alirezarezvani
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/alirezarezvani/claude-code-tresor/tree/HEAD/commands/documentation/docs-gen.md
- Обновлён: 2026-07-03
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/docs-gen

## Что делает

\`docs-gen` анализирует структуру проекта, API и функции кода, затем собирает документацию в выбранном формате. Команда умеет готовить OpenAPI или Swagger, README, руководства, справочники, миграционные инструкции и документы по развёртыванию. Для пользовательских руководств и туториалов она подключает субагента `@docs-writer`.

Результатом может стать сайт на Docusaurus или VuePress с навигацией, поиском, примерами кода и диаграммами Mermaid. Доступны форматы `markdown`, `html`, `pdf`, `openapi`, `swagger`, `gitbook`, `docusaurus` и `vuepress`; флаг `--auto-deploy` задаёт публикацию на GitHub Pages, Netlify или Vercel. Если нужен PDF, формат нужно передать явно через `--format pdf`.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/commands/docs-gen.md` — Вызов — /docs-gen. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/docs-gen.md` — Вызов — /prompts:docs-gen. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

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

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/docs-gen.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/alirezarezvani/claude-code-tresor/tree/HEAD/commands/documentation/docs-gen.md

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

## Примеры запросов агенту
- Собери API-документацию в формате `openapi` и положи результат в `docs/api`.
- Создай руководство с примерами и диаграммами из текущей кодовой базы.
- Собери сайт документации в формате `docusaurus` и включи автодеплой.

## Похожие
- [Branch Docs](https://affpapa.org/nevibecode/mcp/branch-docs.md) — MCP-сервер · 1760 установок
- [w-api-docs](https://affpapa.org/nevibecode/skills/w-api-docs.md) — скилл · 647 установок
- [coding-agent-docs-optimization](https://affpapa.org/nevibecode/skills/coding-agent-docs-optimization.md) — скилл · 13400 установок
- [api-docs](https://affpapa.org/nevibecode/skills/api-docs.md) — скилл · 893 установки
- [Octri API Docs](https://affpapa.org/nevibecode/mcp/octri-api-docs.md) — MCP-сервер · ★ 4 у репозитория
- [doc-gen](https://affpapa.org/nevibecode/skills/sethgammon-doc-gen.md) — скилл · ★ 937 у репозитория

Из того же набора: [alirezarezvani/claude-code-tresor](https://affpapa.org/nevibecode/by/alirezarezvani/claude-code-tresor.md) — 27 карточек

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

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