/research-experiment
/research-experiment — Führt die entworfene Studie aus und erfasst Rohdaten mit vollständiger Herkunft sowie ein Reproduzierbarkeitsmanifest (Umgebung, Seed, Protokoll, Versions-Pins).
Rolle: Leitende:r Forscher:in (Ausführung) Pipeline-Position: Mitte der Kette
Führt die entworfene Studie oder das entworfene Experiment aus und erfasst Rohdaten mit vollständiger Herkunft. Garantiert Reproduzierbarkeit: zeichnet Umgebung, Seed, Protokollprotokoll und Versions-Pins auf, sodass eine unabhängige Partei die Ausführung wiederholen kann.
Kanonischer Aufruf
/research-experimentMit Argumenten:
/research-experiment [--suite-name NAME]Eingaben
_inputs/study-design.md (der Entwurf) und _inputs/preregistration.md (der eingefrorene Analyseplan).
Ausgaben
_outputs/experiment-log.md (die zeitgestempelte Protokollspur sowie der Abschlussdatensatz einer autonomen Kampagne), die Rohdaten an einem host-natürlichen Ort und _outputs/reproducibility-manifest.md (Umgebung, Seed, Protokoll, Versions-Pins).
Nachgelagert
/research-analysis (nachgelagerter Verbraucher)
Workflow-Phasen
Der Befehl folgt dem standardmäßigen Workflow der /research-Pipeline:
- Kontext laden — Den Studienentwurf und die Präregistrierung lesen.
- Das Sequenz-Gate prüfen — Bestätigen, dass
_inputs/study-design.mdexistiert; andernfalls mitBlocked: run /research-design firstanhalten. - Ausführen und aufzeichnen — Das Protokoll ausführen; Rohdaten mit Herkunft erfassen; die zeitgestempelte Protokollspur aufzeichnen.
- Reproduzierbarkeit erfassen — Umgebung, Seed, Protokoll und Versions-Pins aufzeichnen.
- Das Übergabe-Manifest aktualisieren — Den Datenort und das Reproduzierbarkeitsmanifest aufzeichnen.
- Das Protokoll ausgeben —
_outputs/experiment-log.md+ Rohdaten +_outputs/reproducibility-manifest.md.
Rigorositätsuntergrenze
Die Ausführung startet mit einem Pilotdurchlauf, um Budgets und Wertebereiche zu kalibrieren, dann den vollständigen Vergleich unter einem deklarierten Plan zur Rechenauslastung (Kernzuweisung, Speicherobergrenzen, sichere Parallelisierung unabhängiger Wiederholungen). Jede stochastische Methode durchläuft ihr präregistriertes Wiederholungsregime mit aufgezeichneten Seeds und protokollierter Hardware. Eine optionale, standardmäßig ausgeschaltete autonome Experimentschleife steht bereit. Gegen ein eingefrorenes Harness schlägt sie eine Änderung an einem einzigen veränderlichen Ziel vor, formuliert vor jedem Lauf eine falsifizierbare Vorhersage und führt sie beim festgelegten Budget aus. Die primäre Metrik wird aus dem Laufprotokoll als zwei Signale gelesen: ein Suchsignal, das die Schleife steuert, und ein Zulassungssignal aus einer disjunkten Menge, das eine Änderung bestätigt oder verwirft, bevor sie behalten wird: Die Änderung muss die Suchstufe bestehen und dann den Amtsinhaber bei der Zulassung um mehr als die angegebene Rauschmarge schlagen (oder mit ihm gleichziehen und dabei die Komplexität verringern). Jeder Versuch wird journalisiert, und jede Zulassungsabfrage wird gezählt und offengelegt.
Eine letzte, unberührte Menge wird einmal ausgewertet, beim Abschluss. Eine Kampagne ohne eine solche kennzeichnet ihr Ergebnis als selektionskontaminiert und explorativ, und jede Zahl, die die Kampagne berichtet, wird unter dem oben genannten Wiederholungsregime erneut gemessen. Der Operator bestätigt Ziel, Harness, Metrik, Auswertungsmengen, Annahmeregel, Budget und Arbeitsbereich einmal und kann Abbruchkriterien festlegen; beim Anhalten geht der Abschlussdatensatz (Anzahl der Versuche, Behaltenen, Verworfenen, Abstürze und Zulassungsabfragen, der Gewinn gegenüber der Baseline und das Ergebnis der unberührten Menge) in das Experimentprotokoll ein, sodass die Analysestufe das von der Schleife ausgewählte Ergebnis einordnen kann.
Fehlermodi
| Symptom | Ursache | Behebung |
|---|---|---|
| Blocked: run /research-design first | Kein Studienentwurf | /research-design ausführen, um _inputs/study-design.md zu erzeugen |
| Ausführung nicht reproduzierbar | Fehlende Seed-/Umgebungsaufzeichnung | Das vollständige Reproduzierbarkeitsmanifest aufzeichnen, bevor fortgefahren wird |
| Protokollabweichung nicht dokumentiert | Änderung während der Ausführung nicht protokolliert | Die Abweichung im Experimentprotokoll festhalten; bei der Analyse offenlegen |
| Schleifenergebnis als konfirmatorisch dargestellt | Die Schleife steuerte anhand ihrer Zulassungsmenge, oder beim Abschluss wurde keine unberührte Menge gelesen | Das Ergebnis als selektionskontaminiert und explorativ kennzeichnen; das Suchsignal steuert, das Zulassungssignal entscheidet, und die unberührte Menge wird einmal gelesen |
Beispiele
# Die entworfene Studie ausführen und reproduzierbare Rohdaten erfassen
/research-experiment --suite-name <name>Querverweise
/research-design
/research-design — Operationalisiert die Hypothesen zu testbaren Vorhersagen und entwirft die Studie (Variablen, Kontrollen, Stichprobe, Teststärke), dann friert es den Analyseplan als Präregistrierung ein.
/research-analysis
/research-analysis — Analysiert die Rohdaten gemäß dem präregistrierten Plan: geplante Tests, Effektstärken mit Konfidenzintervallen, Robustheitsprüfungen und offengelegte Abweichungen.