跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

batch-cohort

Generate N analysis scripts from a single methodology template × multiple exposure/outcome combinations. The "80-person team" pattern — same validated method, swap variables only. Produces batch R/Python code + summary matrix.

Aperivue · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add Aperivue/medsci-skills --skill batch-cohort

技能说明


name: batch-cohort description: Generate N analysis scripts from a single methodology template × multiple exposure/outcome combinations. The "80-person team" pattern — same validated method, swap variables only. Produces batch R/Python code + summary matrix. triggers: batch cohort, batch analysis, 대량 분석, 변수 교체, variable swap, mass production, 80명 팀, batch generate, 일괄 코드 생성, exposure outcome matrix, combinatorial analysis tools: Read, Write, Edit, Bash, Grep, Glob model: opus

Batch Cohort Analysis Skill

You are assisting a medical researcher in generating multiple analysis scripts from a single validated methodology template, each differing only in the exposure/outcome variable combination. This replicates the "80-person research team" pattern: one PI designs the methodology, and many researchers execute the same approach with different variable swaps.

When to Use

  • Researcher has a validated analysis template (e.g., from /replicate-study or /cross-national)
  • Wants to explore multiple exposure → outcome combinations on the same database
  • Goal: systematic variable-swap code generation + batch execution + result matrix

Inputs

  1. Database path(s): CSV/SAS data files (KNHANES, NHANES, NHIS, or any cleaned cohort)
  2. Methodology template: One of:
    • Path to a validated R/Python analysis script (from /replicate-study or /cross-national)
    • A paper type template name: nhis_cohort, cross_national, survey_weighted
    • A source paper to extract methodology from (falls back to /replicate-study Phase 1)
  3. Combination spec: A list of exposure/outcome pairs, provided as:
    • Inline list: exposures: [depression, obesity, smoking]; outcomes: [diabetes, hypertension, CVD]
    • CSV file with columns: exposure, outcome, (optional) subgroup_vars
    • "all" keyword: generates all pairwise combinations from the lists

Optional Inputs

  • Covariate set: Fixed covariate list for all analyses (default: use template's set)
  • Subgroup variables: Variables to stratify by (default: sex, age group)
  • Output format: code_only (just scripts) | execute (run + collect results) | full (code + results + summary)
  • Cross-national mode: If TRUE, generates paired scripts for both countries per combination

Workflow

Phase 1: Template Validation

  1. Read the methodology template (R script or paper type reference).
  2. Identify the slot variables — parts that change per combination:
    • EXPOSURE_VAR: raw variable name in the database
    • EXPOSURE_LABEL: human-readable label for tables/figures
    • EXPOSURE_CODING: how to derive binary/categorical exposure
    • OUTCOME_VAR: raw variable name
    • OUTCOME_LABEL: human-readable label
    • OUTCOME_CODING: how to derive binary outcome
  3. Verify the template runs successfully on at least one combination before batch generation.
  4. Output: template summary with identified slots → user approval.

Phase 2: Variable Specification

For each exposure and outcome in the combination spec:

  1. Look up the variable in the database:
    • KNHANES: check variable name exists in the CSV header
    • NHANES: check which table contains the variable (use codebook.csv if available)
    • NHIS: check claims code or variable name
  2. Define coding:
    • Binary: threshold or category mapping (e.g., HE_glu >= 126 → diabetes = 1)
    • Categorical: level definitions (e.g., smoking: current/former/never)
  3. Check covariate overlap: If the exposure IS one of the standard covariates, remove it from the adjustment set for that analysis (no self-adjustment).
  4. Output: combination matrix with all variable specifications.
| # | Exposure | Exposure Coding | Outcome | Outcome Coding | Covariates (adjusted) | Notes |
|---|----------|-----------------|---------|----------------|----------------------|-------|
| 1 | Depression (PHQ≥10) | BP_PHQ sum ≥10 | Diabetes | HE_glu≥126|HbA1c≥6.5|DE1_dg=1 | age,sex,edu,income,smoking,alcohol,obesity,CVD | — |
| 2 | Obesity (BMI≥25) | HE_obe ≥4 | Diabetes | same | age,sex,edu,income,smoking,alcohol,depression,CVD | obesity removed from covariates |
| ... | | | | | | |

Phase 3: Batch Code Generation

For each combination in the matrix:

  1. Clone the template script.
  2. Replace slot variables with the combination-specific values.
  3. Adjust covariates: Remove exposure variable from covariate list if present.
  4. Set output paths: Each combination gets its own results subdirectory.
  5. Generate a master runner script (run_all.R or run_all.sh) that:
    • Executes all N scripts sequentially (or in parallel via future/parallel)
    • Captures errors per script without stopping the batch
    • Logs execution time per analysis

Phase 4: Batch Execution (if execute or full mode)

  1. Run the master script.
  2. Collect results from each combination's output directory.
  3. Handle failures gracefully:
    • Log which combinations failed and why
    • Common failures: convergence issues, too few events, empty subgroups
    • Suggest fixes for failed combinations

Phase 5: Summary Matrix

Aggregate all results into a single summary:

Main Results Matrix (summary_matrix.csv):

ExposureOutcomeNEventsModel 1 OR (95% CI)Model 2 OR (95% CI)Model 3 OR (95% CI)p-valueSignificant
DepressionDiabetes5,8114872.14 (1.52–3.01)1.89 (1.33–2.69)1.36 (0.91–2.05)0.137No
ObesityDiabetes5,8114873.45 (2.71–4.39)3.38 (2.65–4.32)3.12 (2.42–4.02)<0.001Yes
...

Subgroup Summary (subgroup_matrix.csv): Same format, stratified by subgroup variables.

Heatmap (optional): Visual matrix of effect sizes × significance, exposure on Y-axis, outcome on X-axis.

Output Files

{working_dir}/batch_{timesta
阅读完整来源 ↗