Recipe: Add Integration Tests

Deriva test di integrazione/E2E dal tuo Design Doc invece che dal codice

di shinpr · shinpr/codex-workflows

Richiede configurazione ★ 8.0/10

Recipe: Add Integration Tests — Deriva test di integrazione/E2E dal tuo Design Doc invece che dal codice

Cosa fa

Una ricetta orchestrator che trasforma un Design Doc esistente in scheletri di test di integrazione ed E2E, li implementa un livello alla volta e esegue un ciclo di revisione e qualità prima del commit. Si attiva quando chiedi di aggiungere copertura di integrazione o E2E a codice che ha già un documento di design. Scritto per OpenAI Codex CLI, quindi i suoi cinque subagenti nominati non esistono in Claude Code.

Rapporto di test

Eseguito su una piccola API HTTP in memoria con un design doc la cui tabella dei contratti affermava che il completamento ripetuto doveva essere idempotente, mentre l'implementazione restituiva 409. La baseline senza skill ha letto prima il sorgente e ha scritto sette test che sono tutti passati — incluso uno che asseriva il 409, bloccando permanentemente il bug. Seguendo la ricetta, lo scheletro proveniva dal design doc piuttosto che dal codice, e la suite risultante è fallita esattamente su quella riga (409 !== 200), inoltre ha asserito un error.code leggibile dalla macchina su cinque percorsi di fallimento dove la baseline non ne asseriva nessuno. Il costo è un setup reale: necessita di un Design Doc già presente in docs/design con un nome file backend/frontend, quattro skill sorelle copiate accanto ad esso, e chiama cinque subagenti Codex CLI (acceptance-test-generator, task-executor, integration-test-reviewer, quality-fixer) che un utente di Claude Code non ha.

Testato il: 2026-07-28 · Claude Code 2.x (agent harness)

Installazione

git clone --depth 1 https://github.com/shinpr/codex-workflows.git
mkdir -p ~/.claude/skills
cd codex-workflows && for s in recipe-add-integration-tests testing integration-e2e-testing documentation-criteria llm-friendly-context; do cp -r .agents/skills/$s ~/.claude/skills/$s; done

Comandi e prompt di esempio

  • /recipe-add-integration-testsDeriva test di integrazione/E2E dal tuo Design Doc invece che dal codice

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Add integration tests to this API using our existing design doc
  • Generate E2E tests from docs/design/auth-design.md for the auth service
  • We have no integration coverage, build it from the tasks API design doc