# api-test-mode-design

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 7800 установок · ★ 7
- Автор: Samuel Berthe
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/samber/developer-platform-skills/tree/HEAD/skills/api-test-mode-design/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/api-test-mode-design

## Что делает

Скилл помогает спроектировать изолированную среду для публичного API. В отличие от мок-серверов, здесь создаётся среда с сохранением состояния между последовательными вызовами. Статичный мок этого не умеет. Разница вскрывается примерно на третьей неделе интеграции, когда внешние разработчики сталкиваются со скрытыми сбоями.

Процесс разбит на пять этапов. Сначала определяется модель изоляции: мягкий переключатель либо структурно отдельная копия окружения. Затем проектируются детерминированные тестовые значения, манипуляции временем и правила перевода в боевой режим. Перед стартом агент задаёт семь уточняющих вопросов о домене и бюджете времени.

Скилл не предназначен для изоляции выполнения кода или юнит-тестов. Это повод проверить границы задачи перед запуском. Для раздачи партнёрских песочниц автор рекомендует пакет `partner-app-onboarding`, а вопросы ротации ключей относит к `api-auth-key-management`. Память проекта можно вести в файле `developer-platform-context.md`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill api-test-mode-design -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/api-test-mode-design/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/api-test-mode-design/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill api-test-mode-design -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/api-test-mode-design/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill api-test-mode-design -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/api-test-mode-design/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install samber/developer-platform-skills api-test-mode-design
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/api-test-mode-design/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill api-test-mode-design -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/samber/developer-platform-skills --path skills/api-test-mode-design
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/api-test-mode-design/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add samber/developer-platform-skills --skill api-test-mode-design -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/samber/developer-platform-skills/tree/HEAD/skills/api-test-mode-design/SKILL.md

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

## Примеры запросов агенту
- Помоги спроектировать тестовый режим и песочницу для нашего платёжного API
- Спланируй симуляцию событий и детерминированные тестовые значения для песочницы API
- Опиши модель изоляции и правила перевода интеграций в боевой режим

## Похожие
- [api-test-suite-generator](https://affpapa.org/nevibecode/skills/api-test-suite-generator.md) — скилл · 303 установки
- [api-integration-specialist](https://affpapa.org/nevibecode/skills/api-integration-specialist.md) — скилл · 2978 установок
- [loops-api](https://affpapa.org/nevibecode/skills/loops-api.md) — скилл · 1600 установок
- [bfl-api](https://affpapa.org/nevibecode/skills/bfl-api.md) — скилл · 1000 установок
- [api-connector-builder](https://affpapa.org/nevibecode/skills/api-connector-builder.md) — скилл · 4500 установок
- [api-authorization-and-bola](https://affpapa.org/nevibecode/skills/api-authorization-and-bola.md) — скилл · 3700 установок

Из того же набора: [samber/developer-platform-skills](https://affpapa.org/nevibecode/by/samber/developer-platform-skills.md) — 29 карточек

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

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