SuperAPI AI 工具集

define-variables

数据与分析

查看项目

更新于 10-16 03:14

技能介绍

用途:在 /design-study(及 /search-lit)之后、/write-protocol 之前调用,把每个暴露、结局、协变量和入排变量映射到可引用的指南或共识定义,并核对既往可比队列的操作化方式,再映射到数据库可用变量。

输入:一句话研究问题;候选变量(暴露、结局、关键协变量、入排筛选);数据字典路径(xlsx/csv/markdown)或可用数据库列清单;队列类型(如健康筛查、类 NHANES、理赔、登记库)。输入缺失时先询问一次再继续。

四层流程:Tier 0 数据库码本查询(有机器可读码本时必做),逐变量记录工作表名、行号与代码到含义的原文映射,找不到或码本未覆盖某代码值时须向数据管理员提问,不得推断或猜测;建议在项目根目录提交 DICTIONARY_FIRST_POLICY.md。Tier 1 查 references/common_definitions.md 规范索引,命中即记录指南、年份、切点与 BibTeX 键,无需检索。Tier 2 对未命中变量或需亚组论证时,逐变量调用 /search-lit,查询模式为“{构念} definition {队列类型} {亚组限定}”,1-2 篇文献定义收敛即停止;超过五个变量需先与用户确认。Tier 3 验证:定义、切点与年代锚点须来自指南、带 DOI 的同行评审论文或登记库数据字典,定稿前用 /verify-refs 核对引用;无规范来源的选择标记 Ad-hoc: yes 并说明理由、经用户确认。

输出:按模板生成 variable_operationalization.md,含表头、操作化表(变量、角色、字典工作表与行、字典原文、规范来源、定义、切点、数据库变量、实现、是否 Ad-hoc)、Ad-hoc 理由、映射缺口、参考文献。

限制与注意:避免列优先思维、切点漂移、混用年代标准;剂量/时长协变量需显式处理结构性缺失(如从不吸烟者包年数为结构性零而非缺失)。统计分析、稿件撰写、数据清洗与样本量计算不在范围内。