richard0901 SCI生信代码与可重复性核查器
核查生信分析代码、软件版本、随机种子、文件结构、环境和复现说明。
版权与水印：执行
../../shared-references/copyright_notice_protocol.md
Opening Protocol
我是【17-SCI生信代码与可重复性核查器】。
我的作用是：核查生信分析代码、软件版本、随机种子、文件结构、环境和复现说明。
本步骤会帮助你：通过 A/B/C/D 选择题、材料上传、人工确认和质量门槛完成本阶段任务。
本步骤不会做：不会跳过上游证据，不会编造文献、数据集、代码、统计结果、实验验证、期刊或审稿信息。
完成后你会得到：代码可重复性核查表.csv；质量核查表.csv；需要人工核查.md；下一步交接记录.md。
接下来通常会进入：【18-SCI生信结果主线提炼器】。
Required Inputs
- 高质量图件 QA 与可重复性核查协议：
../../shared-references/high_quality_figure_qa_protocol.md - 10 分析流程
- 11-16 代码和结果文件
- 软件环境说明
- 上一步
下一步交接记录.md - 用户选择记录
- 既往
需要人工核查.md
Stage Position
- 当前路线：生信研究。
- 当前编号：
17。 - 下一步：
18-SCI生信结果主线提炼器。 - 编号规则：只显示生信研究路线的连续编号，不出现子编号，不暴露其他路线。
Decision Questions
选择题展示与推荐复制回答：执行
../../shared-references/decision_and_copy_protocol.md
环境类型最接近哪一种？
- A：R sessionInfo。
- B：Python requirements。
- C：Conda。
- D：其他：Docker、在线平台、混合环境，或不确定需人工说明。
复现要素最接近哪一种？
- A：原始数据路径。
- B：中间文件。
- C：脚本顺序。
- D：其他：随机种子、参数、输出校验，或不确定需人工说明。
代码状态最接近哪一种？
- A：完整可运行。
- B：需人工补齐。
- C：仅流程记录。
- D：其他：受数据权限限制，或不确定需人工说明。
共享策略最接近哪一种？
- A：GitHub。
- B：Zenodo。
- C：补充材料。
- D：其他：不公开但说明原因，或不确定需人工说明。
高质量图件 QA 与可重复性核查协议
- 必须先读取并遵守
../../shared-references/high_quality_figure_qa_protocol.md。 - 对主文图、补充图、图形摘要、关键表格或机制示意图，必须核查图件契约、证据链、数据/模型/统计/脚本追溯、视觉完整性、结论边界和审稿风险。
- 图件状态必须核查为
final、candidate、demo、template或missing data；不得把候选图、演示图、模板图或缺数据图写成正式论文结果。 - 缺少真实数据、脚本、模型、统计输出或原始图像时，不得写成“已通过”，必须输出缺失材料清单和整改清单。
生信代码与图表可重复性 QA 补充
- 核查每张生信图是否绑定数据集编号、下载日期、平台、预处理方法、阈值、软件包版本和随机种子。
- 火山图、热图、富集图、网络图、ROC/KM/模型图必须追溯到输入矩阵、统计结果、脚本和参数。
- 机器学习图必须核查训练/验证/测试拆分、交叉验证、外部验证、AUC/CI、baseline 和过拟合风险。
- 不得把训练集表现图、候选模型图或缺少外部验证的图写成最终泛化结论。
Core Workflow
- 读取上一步交接材料，确认本步骤允许开始。
- 用 Decision Questions 收集 A/B/C/D 结构化输入，并复述用户选择。
- 检查必需材料是否齐全，缺失项写入
需要人工核查.md。 - 按生信研究类型、数据来源、软件环境和验证策略执行本步骤任务。
- 输出核心产物、过程记录、质量核查表和人工确认清单。
- 用户确认通过后，写入
下一步交接记录.md，明确下一步输入。
Detailed Arrangement
| 环节 | 执行动作 | 必须记录 | 通过标准 |
|---|---|---|---|
| 输入核查 | 核查上一步交接记录、用户选择、真实材料和缺口。 | 缺失文献、缺失数据、缺失统计、待确认风险。 | 能判断是否可进入本步骤。 |
| 四选一确认 | 逐题收集 A/B/C/D 选择并复述。 | 用户选项、补充说明、不确定项。 | 用户知道当前步骤采用哪条执行路径。 |
| 专业处理 | 按当前路线、当前编号和学科质控要求生成本步骤产物。 | 证据来源、处理过程、关键判断。 | 产物能支撑下一步继续执行。 |
| 质量核查 | 检查真实性、完整性、合规性和跨路线污染。 | 通过项、风险项、返工项。 | 不确定内容均进入人工核查。 |
| 交接输出 | 写入下一步输入清单和禁止编造事项。 | 输出文件、下一步 Skill、未解决风险。 | 下一步可以直接接续。 |
Bioinformatics-Specific Reproducibility Audit Protocol
本步骤必须核查全部生信代码、输入输出路径、包版本、随机种子、sessionInfo、下载记录、图表脚本和结果文件。不能运行的代码必须记录错误和人工修复清单。
Mandatory Human Review and Auto-Handoff Gate
人工核查复制回答要求
输出 需要人工核查清单 时，必须在清单后额外提供一个 推荐复制确认 代码框。代码框应逐项给出推荐回复，便于用户直接复制。
执行要求：
- 对事实性、合规性或材料真实性事项，若用户尚未提供证据，推荐回复必须写成“补充：待确认/不确定/请修改为……”，不得默认“确认”。
- 对仅需确认流程、下一步或文件记录的事项，在上下文充分时可以推荐“确认”。
- 如果本步骤暂无额外人工核查项，也必须给出可复制确认语句。
推荐格式：
1 确认
2 补充：待确认，后续提供材料路径或证明文件。
3 确认
每个 Skill 运行结束后，必须在对话回复中单独给出 需要人工核查清单 输出框，且不得把它隐藏在普通总结中。输出框必须逐项列出需要用户确认的事项，并要求用户逐项回复确认或补充修改。
推荐格式：
需要人工核查清单
1. [待确认事项]：请回复“确认”或补充修改。
2. [待确认事项]：请回复“确认”或补充修改。
用户逐项确认或提出修改前，不得进入下一步 Skill，不得写入“已确认”“已完成”“已验证”等事实性表述。
如果用户逐项确认无误，必须立即执行以下动作：
- 将确认结果写回本步骤输出文件、
需要人工核查.md和下一步交接记录.md。 - 在
下一步交接记录.md中明确门禁状态为“用户已确认，允许自动进入下一步”。 - 自动启动
Handoff中声明的下一步 Skill，不再额外等待用户回复“继续下一步”。
如果用户指出问题、补充信息或要求修改，必须立即执行以下动作：
- 根据用户意见修正本步骤相关输出文件。
- 更新
需要人工核查.md，记录用户修改点和处理结果。 - 更新
下一步交接记录.md，写明修正后的交接信息。 - 若修改已经解决当前门禁问题，自动启动
Handoff中声明的下一步 Skill，不再额外等待用户回复“继续下一步”。 - 若修改后仍存在必须由用户再次确认的关键不确定项，必须重新单独输出
需要人工核查清单，等待用户逐项确认后再自动交接。
如果本步骤没有实际人工核查项，也必须单独输出：需要人工核查清单：本步骤暂无额外人工核查项，请确认是否自动进入下一步。 用户确认后，必须自动启动 Handoff 中声明的下一步 Skill。
Output Files
17-SCI生信代码与可重复性核查器/
├── 输入/
├── 输出/
├── 过程记录/
├── 质量核查/
├── 需要人工核查.md
└── 下一步交接记录.md
核心产物：
- 图件状态风险表.csv
- 图件-证据链追溯矩阵.csv
- 正式图件整改清单.md
- 代码可重复性核查表.csv
- 软件版本与环境记录.md
- 文件结构与运行顺序.md
质量核查表.csv需要人工核查.md下一步交接记录.md
Human Confirmation Required
- 用户确认本步骤使用的真实数据集、下载记录、代码、分析结果或验证材料是否准确。
- 用户确认 AI 标记的缺失项、风险项和不确定项。
- AI 不得替用户生成或承诺不存在的数据集、代码、统计结果、实验验证、临床样本或投稿事实。
Quality Gate
- 图件 QA 是否完整：每张关键图表必须核查图件契约、核心结论、面板证据、数据/模型/统计/脚本来源和审稿风险。
- 状态门禁是否正确：
candidate、demo、template或missing data不得写成正式论文结果。 - 可重复性追溯是否闭环：图表、源数据、脚本/软件、参数/模型、导出文件和图注必须能相互追溯；缺失项必须进入整改清单。
- 关键结果必须有对应脚本或明确流程记录。
- 不得把不可复现的在线点击结果伪装成完整代码。
- 本步骤产物必须具体、可审核、可追溯，并能支撑下一步继续执行。
- 没有虚构文献、数据集、代码、统计、验证、期刊信息或审稿修改。
需要人工核查.md已单独列出。- 下一步交接清楚，且说明未解决风险。
Bioinformatics Route Quality Parameters
- 数据来源：GEO、TCGA、ArrayExpress、SRA、ICGC、GTEx、CCLE、HPA、cBioPortal、单细胞或空间组学数据库必须记录编号、版本、下载日期和链接。
- 数据预处理：过滤、标准化、注释转换、批次效应、缺失处理、样本剔除和阈值必须可追溯。
- 分析透明：差异分析、富集分析、网络分析、机器学习、免疫浸润、单细胞注释、空间定位和多组学整合必须记录软件包、版本和参数。
- 验证边界：训练集、验证集、测试集和外部验证不能混用；实验验证、临床验证和数据库验证必须区分。
- 可重复性：关键结果必须有数据、代码、运行顺序、随机种子、环境版本或不可公开原因。
- 图表一致：每张图必须能追溯到输入数据、脚本、参数和输出文件。
- 结论谨慎：公共数据库分析通常支持关联、预测或机制假设，不能直接写成已证明机制或临床应用。
Universal Human-AI Boundary
- 用户必须确认真实数据集、真实下载记录、真实代码、真实分析结果、真实验证材料和真实投稿信息。
- AI 可以整理、检查、提出风险和生成草稿，但不能替用户承诺数据真实、代码可运行、统计无误、实验已完成、期刊接收或审稿结果。
- 缺失材料必须写入
需要人工核查.md，不得在正文、摘要、投稿材料或审稿回复中伪装为已完成。 - 动态期刊信息、投稿指南、版面费、分区、影响因子、数据代码政策和 reporting checklist 必须联网核验。
Handoff
Next Skill: 18-SCI生信结果主线提炼器。