/research-analysis
/research-analysis — Analyse les données brutes selon le plan préenregistré : tests planifiés, tailles d'effet avec intervalles de confiance, contrôles de robustesse et déviations divulguées.
Rôle : Chercheur principal (analyse) Position dans le pipeline : milieu de chaîne
Analyse les données brutes selon le plan préenregistré — exécute les tests statistiques planifiés sur l'unité d'analyse indépendante, rapporte les tailles d'effet avec intervalles de confiance (intervalles de crédibilité sous un plan bayésien ; pas seulement les valeurs p), applique la correction pour comparaisons multiples le cas échéant, indique comment les données manquantes ont été traitées, exécute des contrôles de robustesse / sensibilité, et divulgue chaque déviation par rapport au préenregistrement.
Invocation canonique
/research-analysisAvec arguments :
/research-analysis [--suite-name NAME] [--override] [--correction METHOD] [--alpha LEVEL]Entrées
Les données brutes à l'emplacement naturel de l'hôte enregistré par l'étape d'expérience, plus _inputs/preregistration.md (le plan d'analyse figé).
Sorties
_outputs/analysis.md (les tests préenregistrés avec tailles d'effet, IC, unité d'analyse et un jugement de biais par domaine pour chaque résultat principal ; la correction pour comparaisons multiples ; le traitement des données manquantes ; les contrôles de robustesse ; et les déviations divulguées) + figures / tableaux à un emplacement naturel de l'hôte.
En aval
/research-paper (consommateur en aval)
Phases du flux de travail
La commande suit le flux de travail standard du pipeline /research :
- Charger le contexte — Lire les données brutes et le préenregistrement.
- Vérifier le Portail de séquence — Confirmer que les sorties de l'expérience existent ; sinon, s'arrêter avec
Blocked: run /research-experiment first. - Analyser — Exécuter les tests préenregistrés sur l'unité d'analyse indépendante ; diagnostiquer les hypothèses sans laisser les diagnostics choisir le test ; rapporter les tailles d'effet + IC ; corriger pour comparaisons multiples ; indiquer le traitement des données manquantes ; exécuter les contrôles de robustesse / sensibilité.
- Divulguer les déviations — Consigner chaque écart par rapport au plan préenregistré. Le passage à une solution de repli que nomme le préenregistrement est consigné comme une adaptation planifiée ; toute autre substitution est une déviation.
- Mettre à jour le manifeste de transfert — Consigner le chemin de l'analyse et les figures / tableaux.
- Émettre l'analyse —
_outputs/analysis.md+ figures / tableaux.
Discipline statistique
- Le test suit le plan. Le test principal préenregistré est maintenu sauf si le propre déclencheur de repli du préenregistrement se déclenche ; un test de dépistage qui ne rejette pas ne montre pas qu'une hypothèse tient.
- n compte des unités indépendantes. Les mesures répétées, sous-échantillons, grappes et graines sont agrégés à l'unité ou modélisés comme dépendance, jamais comptés comme des réplicats indépendants.
- Un résultat nul se lit de trois façons. L'intervalle de la taille d'effet, le résultat d'équivalence par rapport au plus petit effet d'intérêt et un énoncé de sensibilité (le plus petit effet détectable au n analysé atteint) sont rapportés ensemble. Une puissance calculée à partir de l'effet observé n'est jamais rapportée.
- Les plans bayésiens selon leurs propres termes. Un plan bayésien préenregistré rapporte le résumé a posteriori avec son intervalle de crédibilité, exécute des contrôles de sensibilité à l'a priori, de diagnostic de calcul et prédictifs a posteriori avant que toute loi a posteriori ne soit rapportée, et utilise une région d'équivalence pratique fixée à l'avance pour les résultats nuls.
- Biais au niveau du résultat et figures. Chaque résultat principal porte un jugement faible / quelques préoccupations / élevé par domaine, amorcé à partir du registre des menaces à la validité de la conception et jamais additionné en un score unique, et chaque figure satisfait au seuil d'encodage, de divulgation de l'incertitude et d'accessibilité.
Seuil de rigueur
Une méthode stochastique est exécutée au moins trente répétitions indépendantes par instance ou condition, davantage lorsque la dispersion entre répétitions est large par rapport aux écarts testés, jusqu'à ce que les statistiques récapitulatives soient stables. Ses résultats sont rapportés comme le meilleur, la moyenne, la médiane, l'écart-type et le pire sur l'ensemble des répétitions, avec des courbes de convergence et des tracés de distribution. Les comparaisons emploient des tests non paramétriques — un test des rangs signés apparié deux à deux, un test de rangs omnibus avec correction post-hoc entre méthodes — rapportés avec une taille d'effet de supériorité stochastique et un diagramme de différence critique. Un résultat n'accède à l'article que lorsqu'il franchit le portail d'avancement : il bat ses comparateurs de manière convaincante et significative, et le franchissement est consigné dans un cahier d'exécution auditable.
Modes de défaillance
| Symptôme | Cause | Récupération |
|---|---|---|
| Blocked: run /research-experiment first | Aucune donnée brute | Exécuter /research-experiment pour produire les données + le journal |
| Valeur p rapportée sans taille d'effet | Rapport statistique incomplet | Rapporter les tailles d'effet + intervalles de confiance |
| Observations dépendantes comptées comme réplicats | Mesures répétées, sous-échantillons, grappes ou graines traités comme indépendants | Agréger à l'unité indépendante ou modéliser la dépendance ; n compte des unités |
| Puissance observée rapportée pour un résultat nul | Puissance calculée à partir de l'effet observé | La supprimer ; rapporter l'intervalle, le résultat d'équivalence et l'énoncé de sensibilité |
| Déviation d'analyse non divulguée | Le plan a dévié en silence | Divulguer la déviation par rapport au préenregistrement |
Exemples
# Analyze the raw data per the preregistered plan
/research-analysis --suite-name my-studyRéférences croisées
/research-experiment
/research-experiment — Exécute l'étude conçue et capture les données brutes avec une traçabilité complète, ainsi qu'un manifeste de reproductibilité (environnement, graine, protocole, versions épinglées).
/research-paper
/research-paper — Assemble un brouillon d'article de premier plan (du résumé à la conclusion plus les références) à partir de la synthèse, de la conception et de l'analyse, chaque citation étant vérifiée pour qu'elle se résolve.