mageck-analysis-gptomics-bioskills

1. 基本信息

项目	内容
名称	mageck-analysis-gptomics-bioskills
项目自述名称	bioSkills（合集整体名称；本技能内部标识为 `bio-crispr-screens-mageck-analysis`）
作者/维护者	GPTomics（GitHub Organization）
来源链接	https://github.com/GPTomics/bioSkills/tree/main/crispr-screens/mageck-analysis
许可证	MIT（GitHub API 确认）
GitHub Stars	1,119（合集仓库整体数字，不代表本技能自身热度）
Forks	193（合集仓库整体）
最新版本	v3.0（2026-02-14 发布 tag；仓库此后持续有提交，未再打新 tag）
安装方式	`git clone` 后运行仓库自带安装脚本，支持按类目选择安装

以上数据来自 GitHub API 与仓库文档，均已交叉验证。

2. 功能介绍与亮点

mageck-analysis 覆盖用 MAGeCK 分析合并型（pooled）CRISPR 筛选实验的完整流程，从 FASTQ 计数到基因级显著性排序：

两套统计模型的选型逻辑：区分双条件设计下的 alpha-RRA 检验（mageck test）与多条件/时间序列/多细胞系设计下的最大似然模型（mageck mle），给出一张按实验设计（双条件、时间序列、多细胞系、配对样本、药物剂量梯度等）对应推荐方法的决策表，并说明各自失效的场景（如用 RRA 处理时间序列会导致假阳性膨胀）
归一化方法选择：median / total / control-sgRNA 三种归一化策略的适用条件与失效场景，特别是“超过 40% 向导 RNA 发生显著变化时 median 归一化会失效”这类容易被忽视的边界条件
常见故障排查表：针对“全部基因都显著”“MLE 输出 NaN beta 值”“不同细胞系结果无法解读”等具体症状，逐条给出触发条件、机制解释与修复方法
跨工具结果协调：当 MAGeCK 与 BAGEL2、JACKS、drugZ、Chronos 等同类工具结果不一致时，给出该信任哪个工具的判断依据
量化阈值表：命中判定的 FDR/LFC 阈值、每个基因所需最少向导 RNA 数、MLE 收敛所需条件等具体数值，并标注每个数值的出处（原始论文或社区共识）

内容由 5 篇同行评审文献支撑（Li et al. 2014/2015 MAGeCK 与 MAGeCK-VISPR 原始方法学论文、Wang et al. 2019 MAGeCKFlute、Joung et al. 2017 筛选实验协议、Hart et al. 2017 基准参考集），并附带一份可直接运行的完整分析脚本示例（FASTQ 计数到结果汇总）。

3. 适用场景

所属分类：数据分析与可视化——该技能的核心产出是对 CRISPR 筛选实验计数数据的统计建模与基因级显著性排序，属于面向具体实验数据的定量分析工具，而非工作流编排或第三方系统集成。

适用人群与场景：

完成合并型 CRISPR 敲除/敲低筛选测序后，需要从原始 FASTQ 计数得到基因级富集/耗竭排序的实验室研究人员
在双条件、时间序列、多细胞系、配对样本等不同实验设计之间，需要判断该用 RRA 还是 MLE 模型的筛选设计人员
MAGeCK 输出出现“全部基因都显著”或 MLE 结果含 NaN 值等异常，需要排查归一化或设计矩阵问题的场景
需要将 MAGeCK 结果与 BAGEL2、JACKS、drugZ 等其他基因打分工具的输出做交叉验证的研究者

4. 跨 Agent 兼容性

Claude Code：原生支持——仓库提供 install-claude.sh，可全局安装或按类目（如 crispr-screens）选择性安装
Codex：原生支持——提供独立的 install-codex.sh，用法与 Claude Code 版本一致
OpenClaw：原生支持——提供 install-openclaw.sh
Hermes Agent：Hermes 官方生物信息学技能网关文档已将本技能按“CRISPR & Genome Engineering”类目具名收录进其技能索引；仓库本身未提供专用 Hermes 安装脚本，具体安装路径未验证

5. 推荐理由

CRISPR 筛选实验最容易出错的环节不是跑通 MAGeCK 命令本身，而是在 RRA 与 MLE 之间选错模型、或归一化方法与实验设计不匹配导致结果整体失真。mageck-analysis 把这些选型逻辑和典型故障模式系统化整理成决策表和排查表，同时说明何时该信任 MAGeCK 结果、何时该改用 BAGEL2/JACKS/drugZ 等替代工具，帮助使用者在分析阶段就避开常见的模型误用陷阱，而不是等结果明显异常了才回头排查。

6. 评分

维度	分数	说明
受欢迎程度	7	合集仓库整体 1,119 星，该数字属整个合集，不代表本技能自身热度；本技能自身有独立第三方渠道证据：Hermes 官方网关按“CRISPR & Genome Engineering”专属类目具名收录，LobeHub 有独立详情页
可用性	9	按类目一条命令即可安装；文档含完整代码示例、决策表、量化阈值表与常见错误排查表；仓库最近一次提交在 2026-08-05，本技能路径最近一次更新在 2026-07-25，维护活跃；无需付费依赖
安全性	9	内容为参考文档与示例脚本，本身不自动执行任何命令；不联网外发数据；不要求 API key 或凭据；License 明确（MIT）；未发现可疑指令或混淆代码
综合	8.33	三项均值

安全检查清单： ① 技能本身不执行 shell 命令——正文与示例脚本给出的是供使用者按需运行的 MAGeCK/R 命令模板，范围明确（仅限筛选数据分析相关命令）② 无联网外发 ③ 不涉及 API key/凭据 ④ 未见可疑指令或 prompt injection 迹象 ⑤ 作者为具备连续维护记录的开源组织，无造假迹象 ⑥ License 明确（MIT）⑦ 本技能路径最近一次提交为 2026-07-25，维护活跃

7. 跟同类 Skills 相比的优势

项目	定位	与 mageck-analysis 的差异
GPTomics/bioSkills 同仓库 `jacks-analysis`	联合估计向导 RNA 效力与基因必需性，作为 MLE 的替代方案	覆盖单一算法路径，不含 MAGeCK 的 RRA/MLE 双模型选型逻辑，也不含跨工具结果协调指南
GPTomics/bioSkills 同仓库 `bagel-essentiality`	基于贝叶斯因子的必需基因判定，专攻必需性分析场景	只解决“是否必需”这一子问题，不覆盖药物筛选、时间序列等多条件实验设计
majiayu000/claude-skill-registry 通用生信技能聚合仓库	收录多种生信主题的极简说明文档	样本内容普遍在 1-2KB 量级，无决策表、无失败模式说明、无文献支撑

mageck-analysis 的差异化在于把“该用哪个统计模型”“归一化方法为什么会失效”“不同工具结果冲突时该信谁”这三类容易被忽视、但直接决定结果可信度的判断逻辑写进正文，而不是停留在“怎么调用命令”的操作说明层面。

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。所属仓库已被 GoekeLab/awesome-genomic-skills（第三方维护的基因组学 agent 技能精选列表）收录，该列表将 CRISPR 筛选分析列为 bioSkills 覆盖的技术领域之一。

9. 其他补充

仓库同时提供多语言 agent 支持（涵盖 Claude Code、Codex、Antigravity CLI、OpenCode、OpenClaw 等安装路径）。技能正文附带完整参考文献列表（含原始方法学论文的期刊与年份），便于使用者在需要时回溯方法学依据。

10. 安装使用方式

git clone git@github.com:GPTomics/bioSkills.git
cd bioSkills
./install-claude.sh --categories "crispr-screens"   # 仅安装 CRISPR 筛选分析相关技能
# 或安装全部技能：
./install-claude.sh

安装后无需重启，Claude Code 会在下次读取 skills 目录时自动识别；技能通过对话中提及“MAGeCK”“CRISPR 筛选分析”“基因必需性排序”等意图触发。Codex 使用 ./install-codex.sh，OpenClaw 使用 ./install-openclaw.sh，用法一致。

11. 注意事项

实际运行需要使用者自行安装 MAGeCK（conda 渠道分发）及可选的 MAGeCKFlute（R/Bioconductor）、MAGeCK-VISPR 等下游工具，技能本身只提供命令模板与决策逻辑，不包含这些第三方生物信息学工具本身
归一化方法与统计模型的选择强绑定实验设计（双条件/时间序列/多细胞系等），跨场景套用会导致结果失真，正文已有明确提示但仍需使用者主动核对自己的实验设计
MLE 模型的 beta 值只有在设计矩阵正确指定（尤其是批次协变量）时才可解释，遗漏批次协变量是常见误用场景