# api-docs-wasp-drone

Субагент api-docs-wasp-drone помогает выбрать инструмент для API-документации, дополнить OpenAPI-примерами и подготовить публикацию или SDK. Работает в Claude Code и Codex.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 96 у репозитория
- Автор: Legion Code Inc.
- Лицензия: AGPL-3.0-or-later · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/documentation-tools/agents/api-docs-wasp-drone.md
- Обновлён: 2026-10-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/api-docs-wasp-drone

## Что делает

api-docs-wasp-drone ведёт API-документацию от OpenAPI-спецификации до опубликованной reference-страницы. Он помогает сравнить Swagger UI, Redoc, Scalar, Mintlify, Stoplight и Bump.sh, добавить JSON-примеры запросов и ответов, а затем настроить размещение через GitHub Pages, Netlify, Vercel или Docker.

Субагент также разбирает генерацию SDK для TypeScript, Python и Go и помогает оформить changelog с пометкой `[BREAKING]` для несовместимых изменений. В Claude Code он устанавливается через маркетплейс, а в Codex подключается файлом `.codex/agents/api-docs-wasp-drone.toml`.

Работа начинается со спецификации: при ошибках валидации рендеринг блокируется, а при отсутствии спецификации субагент останавливается и запрашивает её путь, URL или описание API. Это важно учесть до выбора инструмента.

## Требования
- Работает с: GitHub, Docker

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
В чате агента (не в терминале):
```text
/plugin install documentation-tools@wasp-nest
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/documentation-tools/agents/api-docs-wasp-drone.md

## Когда брать
- выбрать рендерер для OpenAPI-документации
- добавить JSON-примеры к endpoint’ам
- опубликовать API-документацию через GitHub Pages или Docker
- сгенерировать SDK для TypeScript, Python или Go
- оформить changelog с пометкой `[BREAKING]`

## Примеры запросов агенту
- Настрой API-документацию для `openapi.yaml` и сравни подходящие рендереры.
- Добавь примеры JSON-запросов и ответов ко всем endpoint’ам в моей OpenAPI-спецификации.
- Сгенерируй SDK для TypeScript и подготовь changelog для изменения API.

## Похожие
- [docker-docs](https://affpapa.org/nevibecode/skills/docker-docs.md) — скилл · 623 установки
- [neo4j-docker-client-generator](https://affpapa.org/nevibecode/agents/neo4j-docker-client-generator.md) — субагент · 183 установки
- [cloudrun-development](https://affpapa.org/nevibecode/skills/cloudrun-development.md) — скилл · 991 установка
- [api-docs](https://affpapa.org/nevibecode/skills/api-docs.md) — скилл · 893 установки
- [w-api-docs](https://affpapa.org/nevibecode/skills/w-api-docs.md) — скилл · 647 установок
- [adding-api-docs](https://affpapa.org/nevibecode/skills/adding-api-docs.md) — скилл · 455 установок

Из того же набора: [legioncodeinc/vibe-coding-tools](https://affpapa.org/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 карточки

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