流行病学与生物统计项目审查
L 局部产物只检查本次修改影响的部分,不触发本 skill;P 日常项目执行使用日常检查;只有用户明确要求全面质控、投稿、外发或归档时才进行 R 正式发布检查。
只审查模式严格只读,不修改文件、不补日志、不更新 BACKLOG、不重命名、不重跑会覆盖正式结果的脚本。用户同时明确要求修复时,先完成审查并确认修改范围,再调用相应工作流实施。
1. 两种检查范围
日常检查
用于日常项目任务,只检查本轮受影响的输入、目标脚本实际运行结果、关键断言、结果名称、实际使用结果的文件和异常日志。输出简短结论,不对整个项目作是否可发布的判断。
正式发布检查
用于 R 正式发布,完整审查六层并明确说明项目是否可以发布。运行确定性检查:
python <epi-project-audit>/scripts/run_check_project.py <项目根> --json
自动检查只是证据之一,不能替代研究设计、统计解释、报告规范和数据授权审查。
论文正式投稿或返修时,本 skill 负责项目数据、代码、结果来源及其流向稿件的证据链,并把结论交给 academic-publishing 的投稿前确认使用。稿件内容功能、引文支持、逐条返修闭合和 Word/PDF 页面显示分别由对应 skill 负责;已有检查的输入、方法和对象未变时引用其最近一次成功证据,不在本 skill 重复运行同义检查。没有项目级数据、代码或结果来源的外部稿件不为使用本 skill 擅自初始化项目,按作者声明的只读证据范围审查稿内一致性。
2. 严重度
| 级别 | 定义 | 发布影响 |
|---|---|---|
| ERROR | 可能改变科学结论,或违反科研诚信、伦理、隐私、授权、结果追溯、核心复现要求 | 阻止正式发布 |
| WARN | 可接受限制、非关键不一致、需要责任人解释的风险或重要结构问题 | 不自动阻止;必须处置或明确接受 |
| INFO | 风格、命名、目录偏好或优化建议 | 不阻止发布 |
根目录文件数量、脚本是否连续编号、是否同时提供 PNG/PDF、目录名称风格等结构偏好一般是 WARN/INFO。只有它们实际导致错用数据、误运行脚本、无法确认结果来源或无法复现时,才按对应的科学或追溯风险升级。
3. 六层证据链
详细清单见 审查清单。每层都继续审查,不因前层失败而停止,以便一次给出完整问题集。
- 数据与设计:权威输入、原始数据只读、研究对象、时间零点、分析集、纳排、终点和 estimand。
- 代码与执行:总运行脚本中每个步骤的实际输入、输出和研究职责,脚本依赖、随机设置、异常、最近一次成功运行的自动记录和环境说明。
- 结果及其来源:核对
results/results.yaml中实际生成结果的脚本(producer)、输入文件或其哈希值、分析集、运行编号(run_id)、脚本中提取结果的对象或查询(source),以及实际使用该结果的文件(consumers);旧路径仍可读取。 - 表图与正文:分母、估计、区间、P 值、方向、单位、表图编号和正文表述一致。
- 解释与报告:论断强度、局限、预设与探索性区分、适用报告规范、引用和披露。
- 交付、授权与隐私:当前版、授权范围、隐私、凭证、交付内容清单、文件可打开性和接收方复现条件。
校准斜率、效应方向和论断强度等解释按 论断校准 核对;需要外部方法依据时用 evidence-research。
4. 结果一致性
可运行 scripts/check_consistency.py 比较 results/results.yaml 与论文、报告、PPT 中的置信区间和 P 值。它支持第 2 版结构的 display 和旧版结构的 rendered,但自动文本匹配只能发现可能的差异,必须回到生成脚本、相应运行记录和实际使用结果的位置判断。
新的 results/results.yaml 不保存解释或总体结论。审查正文解释时,应按每项结果的固定名称核对论断与依据,并结合 DECISIONS.md 判断;不得用 interp_review 或人工清除标记代替作者判断。
5. 发布结论
- 通过:无 ERROR,且没有尚未处理的实质性 WARN。
- 有明确限制地通过:无 ERROR;WARN 已由对此负责的研究者或项目负责人明确接受,并在报告中写明依据和影响。
- 不通过:存在至少一项 ERROR,或缺少关键材料,因而无法判断科学、合规、隐私、结果来源或复现风险。
审查报告只记录用户或项目材料中已经提供的审查人姓名、职责和时间;未提供时写“未记录”,不得虚构签字或人工复核。
6. 审查报告
每个问题应记录:严重程度、所属层级、材料位置或结果名称、观察到的事实、可能影响、处理建议和验证方式。结尾说明项目是否可以发布、ERROR 数、WARN 数、已接受的限制和未能审查的范围。
只审查时建议不等于已修复。无原始数据、无权限或无法运行时明确限定“可复现性未验证”或“仅审查报告一致性”,不得声称数据真实、计算正确或已完成正式确认。