Recipe: Add Integration Tests

Leitet Integrations-/E2E-Tests aus Ihrem Design Doc ab, anstatt aus dem Code

von shinpr · shinpr/codex-workflows

Funktioniert mit Setup ★ 8.0/10

Recipe: Add Integration Tests — Leitet Integrations-/E2E-Tests aus Ihrem Design Doc ab, anstatt aus dem Code

Was es kann

Ein Orchestrator-Rezept, das ein bestehendes Design Doc in Integrations- und E2E-Test-Skelette umwandelt, diese Schicht für Schicht implementiert und eine Überprüfungs- und Qualitätsschleife vor dem Commit ausführt. Wird ausgelöst, wenn Sie Integrations- oder E2E-Abdeckung zu Code hinzufügen möchten, der bereits ein Designdokument besitzt. Geschrieben für OpenAI Codex CLI, daher existieren seine fünf benannten Subagenten nicht in Claude Code.

Testbericht

Führte es gegen eine kleine In-Memory-HTTP-API mit einem Designdokument aus, dessen Vertragstabelle besagte, dass die wiederholte Vervollständigung idempotent sein muss, während die Implementierung 409 zurückgab. Die Baseline ohne Skill las zuerst den Quellcode und schrieb sieben Tests, die alle bestanden – einschließlich eines, der den 409-Fehler behauptete und den Bug dauerhaft festschrieb. Nach dem Rezept stammte das Skelett aus dem Designdokument und nicht aus dem Code, und die resultierende Suite schlug genau in dieser Zeile fehl (409 !== 200), außerdem behauptete sie einen maschinenlesbaren error.code auf fünf Fehlerpfaden, wo die Baseline keinen behauptete. Die Kosten sind eine echte Einrichtung: Es benötigt ein Design Doc, das bereits in docs/design mit einem Backend/Frontend-Dateinamen liegt, vier Geschwister-Skills, die daneben kopiert wurden, und es ruft fünf Codex CLI-Subagenten auf (acceptance-test-generator, task-executor, integration-test-reviewer, quality-fixer), die ein Claude Code-Benutzer nicht hat.

Getestet am: 2026-07-28 · Claude Code 2.x (agent harness)

Installation

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

Befehle & Beispiel-Prompts

  • /recipe-add-integration-testsLeitet Integrations-/E2E-Tests aus Ihrem Design Doc ab, anstatt aus dem Code

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • 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