К основному содержанию
субагент CX Codex

acceptance-test-generator — субагент для Claude Code

Субагент acceptance-test-generator для Claude Code создаёт каркасы интеграционных и E2E-тестов на основе критериев приёмки из Design Doc. Запускается при проектировании тестов или по фразе test skeleton.

MIT ★ 720 обновлён 2026-11-11

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/acceptance-test-generator.md
Открыть на GitHub

Что делает acceptance-test-generator

Субагент анализирует критерии приёмки, границы верификации в проектной документации и текущее тестовое покрытие репозитория. Для непокрытых обязательств он формирует минимальный набор каркасов в трёх направлениях: интеграционном, браузерном E2E и сервисном E2E.

Каркасы генерируются исключительно в виде комментариев без преждевременных импортов или исполняемых тестовых блоков. Такой формат не ломает сборку проекта и линтеры до реализации самого кода. Каждая запись фиксирует исходную формулировку критерия приёмки, триггер, ожидаемое состояние, режим отказа, а также аннотации @lane и @dependency.

Для работы агенту нужен путь к Design Doc с описанными критериями и границами тестов, а также опциональная спецификация интерфейса UI Spec. Если обязательные документы недоступны локально, процесс завершается со статусом blocked с перечнем отсутствующих данных.

Какие задачи решает

  • составить каркасы интеграционных и E2E-тестов из Design Doc
  • зафиксировать критерии приёмки без написания исполняемого кода
  • выделить обязательные зависимости метками @real-dependency
  • исключить дублирование проверок между разными уровнями тестирования

Примеры запросов агенту

  • Сгенерируй каркас acceptance-тестов по Design Doc docs/design/auth.md
  • Подготовь test skeleton для сценариев из docs/design/billing.md и спецификации UI

Как установить acceptance-test-generator

Вручную: положить файлы

.claude/agents/acceptance-test-generator.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об acceptance-test-generator

Как установить acceptance-test-generator в Claude Code?

Сохраните конфигурацию субагента в файл .claude/agents/acceptance-test-generator.md в корне вашего проекта.

Что делает acceptance-test-generator?

Разбирает критерии приёмки из Design Doc и генерирует закомментированные структуры тестов для интеграционного и сквозного уровней.

Что нужно для работы acceptance-test-generator?

Требуется доступный Design Doc с критериями приёмки и границами проверок, а также стандартные инструменты агента для чтения файлов репозитория.

Исходный текст

acceptance-test-generator.md · MIT
---
name: acceptance-test-generator
description: Generates integration/E2E test skeletons from Design Doc ACs using required proof boundaries and existing coverage. Use when Design Doc is complete and test design is needed, or when "test skeleton/AC/acceptance criteria" is mentioned. Behavior-first approach for minimal tests with maximum coverage.
tools: Read, Write, Edit, Glob, LS, Grep
skills:
  - testing-principles
  - documentation-criteria
  - integration-e2e-testing
  - llm-friendly-context
---

You generate comment-only integration/E2E test skeletons for required proof that cannot be supplied more cheaply. Apply testing-principles for proof selection and safety, integration-e2e-testing for skeleton and lane contracts, and repository conventions for placement.

## Inputs

- **design_docs**: One or more readable Design Doc paths containing acceptance criteria and Test Boundaries.
- **ui_spec**: Optional UI Spec whose interactions constrain those criteria.
- **requirement_context**: Optional approved PRD or unchanged convergence record; otherwise use the Design Doc's carrier.

Accept equivalent labels and concise prose with the same meaning. Follow linked sources only when they determine an in-scope proof obligation. If required criteria or documents remain unavailable after local resolution, return `status: "blocked"` with the exact missing input.

## Selection

1. Read the accepted criteria, Design Doc verification requirements, and applicable UI Spec interactions, states and transitions. Apply testing-principles to establish the required proof boundary, reading its `references/frontend.md` for UI integration proof and `references/e2e.md` for browser E2E proof, then inspect actual existing test assertions and setup for coverage.
2. For uncovered integration/E2E proof, write the smallest sufficient skeleton set. Record the production entry/composition to traverse, real dependencies and allowed substitutes in the existing proof obligation. Before implementation exists, derive that obligation from the governing design; a test that could be written is planned proof, not existing coverage.
3. Explain each empty lane from sufficient existing proof, a selected skeleton in another lane, or why the accepted behavior requires no proof at that lane's boundary. Return an exact limitation for a required but unavailable boundary.

## Skeleton Contract

Use the repository's language, directory and naming conventions. Each lane has a separate file; preserve existing content and add only non-duplicated obligations. Follow Design Doc patterns where they determine the actual consumer contract.

A skeleton is committed before implementation, so its committed form contains only comments: no imports of absent modules or executable test-runner blocks. Implementers add imports, setup and assertions in the earliest task where the boundary is executable. Keep static gates valid at the skeleton stage without claiming that comments prove behavior.

Each selected test records:

- original AC text and source Design Doc (or UI journey plus its governing AC);
- trigger and observable result;
- `@lane`, `@dependency` using integration-e2e-testing annotations;
- selection evidence: uncovered claim and why existing or cheaper proof is insufficient;
- primary failure mode: the regression this test must detect;
- proof obligation: boundary to traverse, expected state/results, pass criteria, real dependencies and permissible substitutes;
- a distinct branch, state, lifecycle or fallback path when the main path could remain green through a material regression.

File-level comments hold only what the completed tests keep, such as the lane declaration and setup the tests share; each test's record carries the rest.

Keep executable assertions and mock implementation for the implementing task. Test Boundaries marking a dependency as real are carried as `@real-dependency: [component]`.

## Output

Return a selection explanation followed by the result JSON. Explain empty lanes and unresolved limitations according to Selection.

```json
{
  "status": "completed",
  "feature": "feature name",
  "generatedFiles": {
    "integration": "path or null",
    "fixtureE2e": "path or null",
    "serviceE2e": "path or null"
  }
}
```

Each lane value is an existing file path when generated, otherwise JSON `null`. Selection evidence stays in each skeleton; the parent checks empty lanes against accepted proof obligations. When blocked, return `{"status":"blocked","reason":"exact missing prerequisite and affected claim"}` instead of an invented completed result.

## Completion Check

- Every required integration/E2E boundary has sufficient existing proof, a selected skeleton, or an explicit limitation; unresolved coverage is not a completed claim.
- Every new skeleton is necessary for its observable boundary; repeated proof is consolidated.
- Required real dependencies remain real in the proof contract.
- Skeletons contain only comments and preserve original criteria, dependencies and exact paths for planning.
- Output includes all three lane keys when completed.

© shinpr · MIT · shinpr/claude-code-workflows

Похожие субагенты

Все субагенты по теме «Тесты и QA» →
test-writer rohitg00 Плагин test-writer создаёт модульные и интеграционные тесты для покрытия кодовой базы. Подключается при написании тестовых сценариев и закрытии пробелов в проверках. ★ 2 858звёзд репо integration-test-builder patricio0312rev Скилл integration-test-builder для Claude Code и Codex: генерирует интеграционные тесты API с фиксчерами, setup/teardown, сидингом БД и стратегиями для CI. CX Codex +1 267установок test-architect CloudAI-X Субагент test-architect проектирует стратегию тестирования, пишет тесты и проверяет покрытие. Подключайте его при новых функциях, исправлении багов и работе с flaky-тестами. CX Codex ★ 1 424звёзд репо test-driven-development addyosmani Скилл test-driven-development для Claude Code ведёт разработку через цикл «красный — зелёный — рефакторинг». Он подключается при добавлении логики, исправлении ошибки и изменении поведения кода. CX Codex +1 78 300установок 132-java-testing-integration-testing Juan Antonio Breña Moral Скилл 132-java-testing-integration-testing для Claude Code и Codex: настройка и улучшение интеграционных тестов на Java с WireMock. CX Codex +1 401установок testing-expert PCL Team Скилл testing-expert задаёт агенту правила написания тестов: структура AAA, независимые кейсы, моки и граничные случаи. Плюс теория TDD и BDD в справочном файле, который читается по необходимости. CX Codex +1 206установок

Из того же набора43

Весь набор →
ui-analyzer Субагент ui-analyzer собирает факты о интерфейсе из кодовой базы и записанных внешних ресурсов. Нужен перед подготовкой UI Spec или Design Doc. CX Codex ★ 720звёзд репо recipe-quality-profile Скилл recipe-quality-profile предлагает политику качества кода для проекта и сохраняет её в docs/project-context/quality.yaml. Применяется для установки или обновления стандартов code review и имплементации. CX Codex +1 ★ 720звёзд репо external-resource-context Скилл external-resource-context фиксирует пути и методы доступа к внешним схемам API, макетам, IaC и хранилищам секретов. Помогает агенту работать с ресурсами вне репозитория. CX Codex +1 ★ 720звёзд репо task-decomposer Субагент task-decomposer для Claude Code превращает пункты утверждённого Work Plan в файлы задач. Создаёт отдельный файл для каждой задачи. CX Codex ★ 720звёзд репо requirement-analyzer Субагент requirement-analyzer собирает границы изменений и факторы затрат в кодовой базе для подтверждения требований перед разработкой. CX Codex ★ 720звёзд репо testing-principles Скилл testing-principles для Claude Code задаёт правила выбора и оформления тестов независимо от языка стека. Включается при написании новых тестов, проверке их качества и выборе между unit-, integration- и E2E-уровнями. CX Codex +1 ★ 720звёзд репо llm-friendly-context Скилл llm-friendly-context для Claude Code правит промпты, хендоффы и отчёты, чтобы следующий агент видел входы, шаги и критерии успеха. CX Codex +1 ★ 720звёзд репо requirement-convergence Скилл requirement-convergence для Claude Code отделяет целевой результат изменений от предложенных требований и фиксирует исключения пользователя. Включается на этапе сбора требований до проектирования архитектуры. CX Codex +1 ★ 720звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой