Communitygithub.com

validation-de-methode-analytique

Planifier, exécuter et documenter la validation, la vérification et le transfert de procédures analytiques selon les cadres réglementaires ICH Q2(R2) et Q14, USP <1220>/<1225>/<1226>, ICH M10 bioanalytique, CLSI EP ou ISO/IEC 17025.

Qu'est-ce que validation-de-methode-analytique ?

Cette compétence est conçue pour les agents d'IA et les utilisateurs travaillant dans la R&D pharmaceutique, les laboratoires cliniques, les bonnes pratiques de fabrication (BPF) ou les laboratoires accrédités ISO 17025. Elle répond à la question fondamentale : « La procédure est-elle adaptée à l'usage prévu ? » pour des techniques telles que la HPLC, la LC-MS/MS, la GC, la CE, l'ICP-MS, la dissolution, la qNMR, la qPCR, la NIR, les tests de liaison aux ligands ou les tests cellulaires. La compétence applique des scripts Python (disponibles dans le répertoire `scripts/`) qui mettent en évidence les pièges statistiques et réglementaires courants : présenter le r² comme une preuve de linéarité, confondre reproductibilité et précision intermédiaire, utiliser les moindres carrés ordinaires pour la comparaison de méthodes, ou appliquer les mauvais critères ICH M10 à un dosage. Elle met l'accent sur deux règles clés : établir le cadre réglementaire avant de concevoir une étude, et énoncer les critères d'acceptation avant de collecter les données. Elle est compatible avec les workflows en ligne de commande (scripts avec indicateurs `--format` et codes de sortie standard) et s'intègre aux pipelines d'automatisation. Les limites de droits d'auteur sont clairement définies : les directives ICH sont intégrées directement, tandis que les chapitres généraux de l'USP, les documents CLSI et les normes ISO sont protégés par des droits d'auteur et ne doivent pas être extraits par l'agent.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/K-Dense-AI/scientific-agent-skills/tree/main/skills/analytical-method-validation

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Validation de Méthode Analytique

Quand l'utiliser

À chaque fois que la question est de savoir si une procédure analytique est adaptée à son usage prévu : concevoir une étude de validation, évaluer des données de validation, vérifier une procédure de la pharmacopée, transférer une procédure vers un autre laboratoire ou instrument, ou défendre l'un de ces éléments dans un rapport.

Les deux règles

1. Établir quel cadre réglementaire s'applique avant de concevoir quoi que ce soit. Le même dosage se valide différemment sous ICH Q2(R2), USP <1225>, ICH M10, CLSI EP et ISO/IEC 17025. Ils diffèrent par les caractéristiques requises, la manière dont les études sont structurées et si des critères d'acceptation numériques sont fournis. Les mélanger produit un protocole qui ne satisfait aucun d'entre eux.

2. Énoncer les critères d'acceptation avant de collecter les données. Des critères choisis après avoir vu les résultats ne sont pas des critères d'acceptation, et les décider après coup est une constatation d'audit permanente. ICH Q2(R2) ne fournit délibérément presque aucun critère numérique — ils doivent provenir des spécifications, du profil cible analytique (ICH Q14, section 3) ou des données de développement. ICH M10 est l'exception : il fournit des nombres explicites, et ils diffèrent entre les dosages chromatographiques et les dosages par liaison aux ligands.

Champ d'application

Cette compétence planifie les études, calcule correctement les statistiques et structure la documentation. Elle ne décide pas qu'une procédure est validée, ne libère pas un lot, n'accepte ni ne rejette une série, ne clôt pas une enquête, et ne se substitue pas à l'analyste, au réviseur technique, à l'unité qualité ou au régulateur. Chaque script rapporte ; aucun ne conclut.

Limites des droits d'auteur

Les directives ICH sont publiées ouvertement et sous licence de réutilisation avec mention, donc leurs exigences sont directement encodées dans cette compétence. Les chapitres généraux de l'USP, les documents CLSI EP et les normes ISO sont protégés par des droits d'auteur et payants. Pour ceux-ci, cette compétence fournit la désignation, la portée et l'endroit où obtenir une copie autorisée — jamais le texte, jamais de seuils inventés. Ne demandez pas à un agent de récupérer, transcrire ou reconstruire leur contenu. Si un nombre est important et qu'il se trouve dans un document payant, lisez-le dans la copie autorisée.

Cadres réglementaires

cd skills/analytical-method-validation/scripts
python3 plan_validation.py --list-frameworks
CléRégitCritères numériques fournis
ich-q2r2Tests de libération et de stabilité des substances actives et produitsPresque aucun — vous les dérivez
ich-m10Mesure de concentration bioanalytique (PK, TK, BE)Oui, et ils diffèrent selon la modalité
usp-1220Cycle de vie des procédures de la pharmacopée, trois étapesPayant
usp-1225 / usp-1226Validation / vérification des procédures de la pharmacopéePayant
clsiProcédures de mesure en laboratoire clinique (série EP)Payant
iso-17025Méthodes développées en laboratoire et modifiées sous accréditationNon — "dans la mesure nécessaire"

Q2(R2) a remplacé Q2(R1) en novembre 2023 et a restructuré les caractéristiques. La plage est désormais la caractéristique parente (section 3.2), contenant la réponse (linéarité) et la validation des limites inférieures de la plage (LD/LQ). L'exactitude et la précision sont la section 3.3 et peuvent être évaluées en combinaison par rapport à un seul critère. La robustesse est traitée comme une activité de développement et renvoie à ICH Q14. Les procédures multivariées sont abordées explicitement (2.5 et 3.2.2.3), et l'Annexe 2 ajoute des exemples pratiques pour des techniques que Q2(R1) n'a jamais couvertes — RMN ¹H quantitative, NIR, LC/MS quantitative, qPCR, dosages biologiques et taille de particules. Un protocole de type Q2(R1) — une liste plate de linéarité, plage, exactitude, précision, spécificité, LD, LQ, robustesse — est obsolète. Notez également la correction d'erreur datée du 30 novembre 2023 au Tableau 5 et aux Tableaux 6–11.

Scripts

cd skills/analytical-method-validation/scripts
ScriptQuestion répondue
plan_validation.pyQuel cadre, quelles caractéristiques, quelle configuration d'étude, quel protocole ?
check_response.pyLe modèle d'étalonnage tient-il réellement sur toute la plage ?
check_accuracy_precision.pyQuel est le taux de récupération, et quelle part de la variabilité est inter-jours ?
check_detection_limits.pyQuels sont la LD et la LQ par chaque approche autorisée, et servent-elles le seuil de déclaration ?
check_bioanalytical_run.pyCette série répond-elle à ICH M10 pour sa modalité ?
compare_methods.pyDeux procédures sont-elles équivalentes, à une marge prédéfinie ?

Tous prennent --format table|tsv|json. La provenance, les citations des directives et les mises en garde vont vers stderr ; les données vont vers stdout, donc > out.tsv les garde séparés. Le code de sortie est 0 pour aucun constat, 1 lorsque des constats ont été soulevés, 2 pour une entrée invalide — donc n'importe lequel d'entre eux peut déclencher un workflow.

Workflow

1. Fixer le cadre et les caractéristiques requises

python3 plan_validation.py --framework ich-q2r2 --attribute assay --technique hplc --range-use assay

Le Tableau 1 de Q2(R2) détermine ce qui est requis à partir de l'attribut mesuré, et non de la technique. Pour un dosage : spécificité, réponse, exactitude, répétabilité, précision intermédiaire. Pour un test de limite : spécificité et LD seulement. Pour un test d'identité : spécificité seule. Les attributs acceptés incluent assay, impurity (quantitatif), impurity-limit et identity.

La plage de déclaration provient des spécifications. Le Tableau 2 de Q2(R2) donne des exemples pratiques — 80–120 % de la teneur déclarée pour un dosage, 70–130 % pour l'uniformité de contenu, seuil de déclaration à 120 % de la spécification pour une impureté.

2. Générer le protocole et remplir les critères

python3 plan_validation.py --framework ich-q2r2 --attribute impurity --protocol > protocol.md

Chaque champ entre crochets est une décision à prendre et à enregistrer avant la collecte de données. Le squelette du protocole refuse délibérément de pré-remplir les critères d'acceptation pour les travaux Q2(R2), car il n'existe pas de valeur par défaut défendable.

3. Évaluer la réponse

python3 check_response.py -i calibration.csv --max-back-calc-error 2

L'entrée est niveau,réponse, une ligne par injection ; les lignes répétées au même niveau sont des répétitions, et leur fourniture est ce qui rend le test de linéarité possible.

Résultat réel d'une courbe qu'un coefficient de détermination laisserait passer :

statistic                           value
distinct levels                     5
slope                               166.6000
intercept                           2495.0000
intercept CI includes 0             no
coefficient of determination (r2)   0.9830
lack-of-fit F                       469.5294
lack-of-fit p                       1.5139e-06
runs test p                         0.0492

level     n  mean_response  mean_back_calculated  relative_error_pct
50.0000   2  10075.0000     45.4982               -9.0036
75.0000   2  15150.0000     75.9604               1.2805
100.0000  2  20050.0000     105.3721              5.3721
125.0000  2  24050.0000     129.3818              3.5054
150.0000  2  26450.0000     143.7875              -4.1417

r² = 0,983 et le modèle est inutilisable : −9,0 % d'erreur rétro-calculée en bas de la plage, p du manque d'ajustement = 1,5 × 10⁻⁶, signes résiduels non aléatoires. Le r² n'est pas une preuve de linéarité — il augmente avec la plage et est presque insensible à la courbure. Le test F de manque d'ajustement par rapport à l'erreur pure et le motif résiduel sont les preuves, c'est pourquoi Q2(R2) 3.2.2.1 demande une analyse de la déviation des points par rapport à la ligne plutôt qu'un coefficient de corrélation seul.

Ajoutez --weight 1/x2 pour une courbe de large plage. Le script signale l'hétéroscédasticité lorsque la variance résiduelle dans le tiers supérieur de la plage dépasse celle du tiers inférieur de plus de 10 fois, car un ajustement non pondéré biaise alors exactement l'extrémité inférieure là où se trouve un seuil de déclaration.

4. Évaluer l'exactitude et la précision

python3 check_accuracy_precision.py -i ap.csv --accuracy-limit 2 --rsd-limit 1.0 --design-check assay

L'entrée est niveau,mesuré,groupe, où groupe est le facteur de précision intermédiaire — jour, analyste ou instrument.

level  component                       sd      rsd_pct  df      ci90_low_sd  ci90_high_sd
100    repeatability (within group)    0.0707  0.0707   3       0.0438       0.2065
100    between-group                   1.6515  1.6515   2       n/a          n/a
100    intermediate precision (total)  1.6530  1.6530   2.0037  0.9554       7.2821

Une répétabilité de 0,07 % RSD semble excellente ; la précision intermédiaire est de 1,65 %, vingt-trois fois plus grande, car la variabilité réside entièrement entre les jours. Rapporter le chiffre intra-jour comme la précision de la procédure sous-estimerait la performance de routine de plus d'un ordre de grandeur. C'est pourquoi le script ajuste un modèle à effets aléatoires à un facteur plutôt que de regrouper.

Deux pièges que le script gère pour vous :

  • La précision est estimée à chaque niveau, jamais regroupée entre les niveaux. Regrouper les résultats à 80/100/120 % en un seul écart type transforme la plage elle-même en une imprécision apparente. Le script rapporte par niveau, plus une vue indépendante du niveau en pourcentage de la valeur nominale.
  • --require-ci-within-limit impose que l'ensemble de l'intervalle de confiance se situe à l'intérieur de la limite, et pas seulement la moyenne. Q2(R2) 3.3.1.4 demande que l'intervalle soit compatible avec le critère ; une moyenne qui frôle la limite sur six répétitions n'a pas démontré grand-chose.

5. Établir la LD et la LQ, et les confirmer

python3 check_detection_limits.py --calibration lowcal.csv --blanks blanks.csv \
    --confirm-ql 0.05 --confirm-data ql_check.csv --reporting-threshold 0.05
approach                                          sigma   slope      DL      QL
sd-and-slope (sigma = residual SD of regression)  7.2816  5033.3490  0.0048  0.0145
sd-and-slope (sigma = SD of y-intercept)          4.3303  5033.3490  0.0028  0.0086
sd-and-slope (sigma = SD of 8 blanks)             3.7702  5033.3490  0.0025  0.0075

Les mêmes données donnent des estimations de LQ couvrant un facteur 1,9×, uniquement à cause du choix de σ. Q2(R2) 3.2.3.5 exige donc que la limite et l'approche utilisée pour la déterminer soient rapportées, et qu'une limite estimée soit confirmée avec des échantillons à cette limite ou à proximité. Pour une procédure d'impureté, la LQ doit être inférieure ou égale au seuil de déclaration. Atteindre automatiquement 3,3σ/pente, rapporter un seul nombre sans approche nommée, et ne jamais le confirmer sont trois constatations distinctes.

6. Séries bioanalytiques sous ICH M10

python3 check_bioanalytical_run.py --modality chromatographic --run run1.csv
python3 check_bioanalytical_run.py --modality lba --isr isr.csv
python3 check_bioanalytical_run.py --modality lba --criteria

--modality est obligatoire et n'a pas de valeur par défaut, car les critères diffèrent réellement :

ChromatographiqueDosage par liaison aux ligands
Tolérance d'étalonnage±15%, ±20% à la LLOQ±20%, ±25% à la LLOQ et l'ULOQ
Exactitude / Précision±15% / ≤15% CV (±20% / ≤20% à la LLOQ)±20% / ≤20% CV (±25% / ≤25% à la LLOQ et l'ULOQ)
Plan A&P4 niveaux CQ, 5 répétitions/série, ≥3 séries sur ≥2 jours5 niveaux CQ, 3 répétitions/série, ≥6 séries sur ≥2 jours
Erreur totaleaucun critère de ce type≤30%, ≤40% à la LLOQ et l'ULOQ
Accord ISR±20% pour ≥2/3 des répétitions±30% pour ≥2/3 des répétitions

Appliquer les nombres chromatographiques ±15% à un dosage par liaison aux ligands, ou importer le critère d'erreur totale du LBA dans une méthode chromatographique, sont deux erreurs courantes et erronées.

La vérification de série impose la règle par niveau qui est souvent oubliée : au moins 2/3 de tous les CQ et au moins 50 % à chaque niveau. Une série peut passer la fraction globale tandis qu'un seul niveau échoue complètement.

finding: QC level high: 0/2 within tolerance (0%); M10 requires at least 50% at each level

7. Transfert et comparaison de méthodes

python3 compare_methods.py -i paired.csv --margin 2 --relative --slope-tolerance 0.05
mean difference (%)                       1.4646
TOST margin                               2.0000
TOST p-value                              1.0528e-13
90% CI (TOST)                             1.44127 to 1.48797
equivalent at stated margin               yes
--- for contrast only ---
paired t-test p (NOT equivalence)         0.0000
OLS slope (biased here)                   1.0396
Deming slope                              1.0398
Passing-Bablok slope                      1.0351

Deux erreurs que cela remplace :

  • "p > 0,05, pas de différence significative, donc les méthodes sont équivalentes." Ne pas détecter une différence n'est pas une preuve d'équivalence, et sur un petit ensemble de données de transfert, ce résultat est presque garanti. Le test TOST teste l'hypothèse qui importe — que la vraie différence se situe à l'intérieur d'une marge prédéfinie. Ici, le test t indique que la différence est hautement significative et le TOST dit que les méthodes sont équivalentes à ±2 % ; les deux sont vrais, et un seul répond à la question.
  • Les moindres carrés ordinaires pour la comparaison de méthodes. Les MCO supposent que les valeurs de référence ne comportent aucune erreur, ce qui est faux lors de la comparaison de deux procédures, et biaisent la pente vers zéro. La régression de Deming (avec un rapport de variances d'erreur spécifié) et la régression de Passing-Bablok (non paramétrique, résistante aux valeurs aberrantes) sont les régressions appropriées et sont rapportées côte à côte avec les MCO pour contraste.

Le script signale également le biais proportionnel — lorsque la différence tend à suivre la concentration, un seul biais moyen et ses limites d'accord sont trompeurs, quelle que soit leur apparence.

Ce que cette compétence vise à empêcher

  1. Valider selon la structure d'ICH Q2(R1) trois ans après son remplacement par Q2(R2).
  2. Des critères d'acceptation rédigés après avoir vu les données.
  3. Le r² présenté comme une preuve de linéarité.
  4. La répétabilité rapportée comme la précision de la procédure, la composante inter-jours étant invisible.
  5. Un seul nombre LD/LQ sans approche nommée et sans confirmation.
  6. Des critères chromatographiques ICH M10 appliqués à un dosage par liaison aux ligands, ou l'inverse.
  7. La non-significativité d'un test t présentée comme une équivalence lors d'un transfert de méthode.

Références

  • references/framework-selection.md — quel cadre régit, et les questions

...

[tronqué pour la traduction]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

adaptyv

How to use the Adaptyv Bio Foundry API and Python SDK for protein experiment design, submission, and results retrieval. Use this skill whenever the user mentions Adaptyv, Foundry API, protein binding assays, protein screening experiments, BLI/SPR assays, thermostability assays, or wants to submit protein sequences for experimental characterization. Also trigger when code imports `adaptyv`, `adaptyv_sdk`, or `FoundryClient`, or references `foundry-api-public.adaptyvbio.com`.

aeon

This skill should be used for time series machine learning tasks including classification, regression, clustering, forecasting, anomaly detection, segmentation, and similarity search. Use when working with temporal data, sequential patterns, or time-indexed observations requiring specialized algorithms beyond standard ML approaches. Particularly suited for univariate and multivariate time series analysis with scikit-learn compatible APIs.

alphagenome

Look up precomputed AlphaGenome Atlas effects for any GRCh38 single-nucleotide variant (AVI score with Phred and 18 SHAP feature attributions, plus raw and quantile scores for RNA-seq, DNase, ATAC, ChIP-TF, ChIP-histone, CAGE, PRO-cap, splicing, polyadenylation and contact-map tracks), score variants or scan windows on demand with the AlphaGenome model for human and mouse (variant scoring, in silico mutagenesis, REF-versus-ALT track prediction), and build Atlas website deep links. Use when the user mentions AlphaGenome, AlphaGenome Atlas, AVI or AlphaGenome Variant Impact, DeepMind variant effect prediction, or wants to prioritise or mechanistically interpret non-coding, regulatory, splicing, enhancer, promoter, or chromatin-accessibility effects of SNVs from a VCF, credible set, or region. Research use only; not a clinical tool.

anndata

Data structure for annotated matrices in single-cell analysis. Use when working with .h5ad files or integrating with the scverse ecosystem. This is the data format skill—for analysis workflows use scanpy; for probabilistic models use scvi-tools; for population-scale queries use cellxgene-census.

arbor

Autonomously improve a real artifact (code, training recipe, agent harness, data pipeline, prompt) against an objective and an evaluator, using Hypothesis Tree Refinement (HTR) from the Arbor paper. Use this whenever someone wants to iteratively optimize something over many experiments without overfitting — e.g.

arboreto

Infer gene regulatory networks (GRNs) from gene expression data using scalable algorithms (GRNBoost2, GENIE3). Use when analyzing transcriptomics data (bulk RNA-seq, single-cell RNA-seq) to identify transcription factor-target gene relationships and regulatory interactions. Supports distributed computation for large-scale datasets.

astropy

Core Python library for astronomy and astrophysics workflows that need Astropy APIs, including units/quantities, coordinates, FITS I/O, tables, time systems, WCS, and cosmology. Use when implementing or debugging astronomical data analysis code with Astropy.

autoskill

Observe the user

benchling-integration

Benchling Python SDK and REST API integration for registry entities, inventory, ELN entries, workflows, Benchling Apps, and Data Warehouse queries. Use when automating lab data with benchling-sdk or the v2 API.

bgpt-paper-search

Search scientific papers and retrieve structured experimental data extracted from full-text studies via the BGPT MCP server. Returns 25+ fields per paper including methods, results, sample sizes, quality scores, and conclusions. Use for literature reviews, evidence synthesis, and finding experimental details not available in abstracts alone.

bids

>

biopython

Comprehensive molecular biology toolkit. Use for sequence manipulation, file parsing (FASTA/GenBank/PDB), phylogenetics, and programmatic NCBI/PubMed access (Bio.Entrez). Best for batch processing, custom bioinformatics pipelines, BLAST automation. For quick lookups use gget; for multi-service integration use bioservices.

bioservices

Unified Python interface to 40+ bioinformatics services. Use when querying multiple databases (UniProt, KEGG, ChEMBL, Reactome) in a single workflow with consistent API. Best for cross-database analysis, ID mapping across services. For quick single-database lookups use gget; for sequence/file manipulation use biopython.

bulk-rnaseq

End-to-end bulk RNA-seq orchestrator — takes raw FASTQ reads through QC and trimming (FastQC, fastp/Trim Galore), alignment and quantification (STAR, Salmon, featureCounts), assembles a gene-level counts matrix, then hands off to differential expression (pydeseq2), pathway/GSEA enrichment (pathway-enrichment), and publication figures (scientific-visualization). Use whenever the user has bulk RNA-seq reads or quant output and wants a complete, reproducible differential-expression workflow — e.g.

cellxgene-census

Query the CZ CELLxGENE Census programmatically for versioned public single-cell and spatial transcriptomics data. Use when you need population-scale cell metadata, gene expression slices, Census summary counts, source H5AD URIs/downloads, embeddings, spatial Census data, or reference atlas comparisons across organisms, tissues, diseases, assays, and cell types. For analyzing your own local single-cell data use scanpy, anndata, or scvi-tools.

cirq

Google quantum computing framework. Use when targeting Google Quantum AI hardware, designing noise-aware circuits, or running quantum characterization experiments. Best for Google hardware, noise modeling, and low-level circuit design. For IBM hardware use qiskit; for quantum ML with autodiff use pennylane; for physics simulations use qutip.

citation-management

Comprehensive citation management for academic research. Search OpenAlex, PubMed, and Google Scholar for papers, extract accurate metadata, validate citations, and generate properly formatted BibTeX entries. This skill should be used when you need to find papers, verify citation information, convert DOIs to BibTeX, or ensure reference accuracy in scientific writing.

clinical-decision-support

Prepare and validate research-only clinical decision-support evaluation, evidence-profile, cohort, survival, biomarker/model, privacy, and governance artifacts. Use for aggregate or synthetic research documentation and traceability—not patient care or live clinical operation.

clinical-reports

Create safety-bounded draft structures and run local deterministic checks for clinical case, diagnostic, trial, safety, and aggregate research reports. Use only with synthetic, de-identified, or aggregate inputs and verified source-fact manifests; every output requires qualified review.

cobrapy

Constraint-based metabolic modeling (COBRA). FBA, FVA, gene knockouts, flux sampling, SBML models, for systems biology and metabolic engineering analysis.

Skills associés