SuperAPI AI 工具集

alterlab-results-transparency

通用与其它

查看项目

更新于 10-16 05:00

技能介绍

用途:这是一个报告纪律门禁,而非统计教程。它站在“已运行的分析”和“即将写入结果段落的句子”之间,用来阻止定量写作中最常见的诚信问题——只报告显著、去掉其他分析。铁律是:未报告全部已运行分析前,不得写出结果结论(NO RESULTS CLAIM WITHOUT REPORTING EVERY ANALYSIS RUN)。

主要能力:它不重实现统计,而是编排并要求以下输出齐备后才允许下结论——由 alterlab-statistical-analysis 产生的检验、假设检查、效应量与置信区间、APA 格式数字;由 alterlab-preregistration-discipline 维护的冻结计划及偏差标签;由 alterlab-open-science 负责的披露机制。门禁步骤依次为:IDENTIFY(写明意图结论句)、LIST(列出该假设下实际运行的全部检验,含不显著项、被放弃规格、备选排除规则)、CHECK 假设结果是否写入、CHECK 效应量与 95% 置信区间是否随结论给出、CHECK 预注册偏差是否标注为验证性/探索性,全部通过后才写句子。另有报告不足对照表与“借口 vs 现实”表,帮助识别选择性报告、测试挑选、事后加协变量等行为。

使用方式:在撰写或辩护结果结论时触发,例如准备写“我们发现……”“X 显著预测 Y”、报告 p 值/系数/组间差异/相关、写摘要结果句或图表标题、想在看结果后删异常值或换检验时。附带 scripts/reporting_gate.py 为确定性透明性检查器(仅用标准库),对结论清单 JSON 运行:uv run python skills/methodology/alterlab-results-transparency/scripts/reporting_gate.py claim.json;非零退出表示尚不可写结论。该脚本不计算 p 值或效应量。

适用场景:量化研究结果段、摘要结果句、图表标题、资助或技术报告的结论表述。

限制:不负责选检验、算效应量(交给统计技能),不判断证据质量,不验证引用。若同一假设运行 3 次以上以寻找显著性,须校正或声明为探索性。运行方式与清单字段等细节暂未提供完整说明。