1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | crispresso-editing-gptomics-bioskills |
| 作者/维护者 | GPTomics |
| 来源链接 | https://github.com/GPTomics/bioSkills/tree/main/crispr-screens/crispresso-editing |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 所属合集仓库 1,123（数据来自 GitHub API；该数字属整个 bioSkills 合集，不代表本技能个体热度） |
| Forks | 所属合集仓库 193（数据来自 GitHub API） |
| 最新版本 | 无独立版本号，随合集仓库更新，本技能路径最近一次提交时间 2026-07-25（数据来自 GitHub API） |
| 安装方式 | 克隆仓库后运行仓库自带的多 Agent 安装脚本，或手动复制该子目录到对应 skills 目录；亦可通过第三方技能市场 mdskill.dev 一条命令安装 |
2. 功能介绍与亮点
crispresso-editing 把 CRISPResso2（Clement 2019, Nat Biotechnol）这套编辑结果定量工具的用法、参数选择与结果判读整理成一份可直接对话调用的分析指南，覆盖 Cas9 核酸酶（indel、HDR）、胞嘧啶/腺嘌呤碱基编辑器（靶标转化率 + 旁观突变）与 prime 编辑器（模板化编辑）三类编辑化学体系：
- 五种运行模式速查：单扩增子单样本（CRISPResso）、同扩增子多样本批处理（CRISPRessoBatch）、多扩增子混池（CRISPRessoPooled）、全基因组脱靶扫描（CRISPRessoWGS）、双样本对比（CRISPRessoCompare），并给出各自适用的实验设计场景
- 定量窗口数学原理：解释窗口大小与中心位置如何决定“什么算已编辑”，附 Cas9（窗口 1bp）与碱基编辑器（窗口 10bp）的默认参数差异及误设后果
- 碱基编辑判读：区分靶标转化率与旁观编辑率，给出取代-插入缺失比（substitution-vs-indel ratio）阈值——大于 10 判定为干净的碱基编辑，小于 3 提示 Cas9 样切割污染
- 8 类常见故障排查表：按触发条件、机制、症状、修复方法四栏列出低比对率、混池扩增子错配、prime 编辑器骨架掺入过高等故障
- 量化阈值参考表：汇总功能性敲除（indel>70%）、干净碱基编辑（indel<5%）、pegRNA 高质量设计（骨架掺入<2%）等 11 项行业惯例阈值及出处
亮点是把定量窗口这一容易被低估的参数（决定“编辑”与“未编辑”判定边界）单独用一节讲透，并附可直接运行的 Python 解析代码，从 CRISPResso 原始输出提取比对率、编辑分类与等位基因频率表。
3. 适用场景
所属分类：数据分析与可视化
适合已完成 Cas9/碱基编辑器/prime 编辑器扩增子测序、需要把原始 FASTQ 转成编辑效率与旁观突变统计表的生物信息学研究者或计算生物学博士生，也适合诊断“比对率过低”“碱基编辑显示大量indel”等异常结果的根因。它处于同仓库 library-design（实验前设计）之后、hit-calling（筛选层面统计检验）与 base-editing-analysis（变异功能解读）之前，服务实验完成后的第一道定量环节。
4. 跨 Agent 兼容性
- Claude Code：原生支持——仓库自带
install-claude.sh专用安装脚本，SKILL.md 为标准 Agent Skills 格式 - Codex：原生支持——仓库自带
install-codex.sh，安装时自动转换为 Codex 的 Agent Skills 目录结构（examples/→scripts/，usage-guide.md→references/） - OpenClaw：原生支持——仓库自带
install-openclaw.sh，亦可直接从 ClawHub 市场安装 - Hermes Agent：原生支持——已被 Hermes 官方生物信息学网关“CRISPR & Genome Engineering”类目具名收录
5. 推荐理由
它把 CRISPResso2 分散在命令行帮助与论文方法学里的参数选择逻辑（尤其是最容易被忽视、直接决定判定结果的定量窗口设置）整理成一份带判读阈值的分析指南，配合 8 类结构化故障排查表与可运行的结果解析代码，能显著减少研究者在编辑效率定量环节反复试错、误读碱基编辑旁观突变或漏判混池扩增子错配的成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 已被 Hermes 官方生物信息学网关“CRISPR & Genome Engineering”类目具名收录，并被第三方技能市场 mdskill.dev 收录索引；所属合集仓库星数（1,123）按惯例不计入单个子技能自身热度 |
| 可用性 | 8 | SKILL.md 与 usage-guide.md 文档详尽，含运行模式决策树、11 项量化阈值表、8 类失败模式排查指南与可运行的 Python 结果解析代码；本技能路径最近一次提交为 2026-07-25（评估时不到两周前）；但完整使用需通过 conda（bioconda 频道）安装 CRISPResso2 主工具（未发布到 PyPI），需要一定环境配置，非零配置直接可用 |
| 安全性 | 9 | 纯方法论参考文档与本地示例脚本，不执行任意 shell 命令、不联网外发数据、无需 API key 或凭据，MIT 许可证完全开源可审计 |
综合评分（三项均值）：8.0
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| base-editing-analysis-gptomics-bioskills | 同仓库子技能，负责碱基编辑结果的变异功能层面解读 | base-editing-analysis 处理“这个碱基变化对蛋白功能意味着什么”的下游解读；crispresso-editing 处理“测序读数里到底发生了什么编辑”的上游定量，二者是同一分析流程的前后接力 |
| batch-correction-gptomics-bioskills | 同仓库子技能，负责多批次筛选数据的批次效应校正 | batch-correction 面向筛选实验中多批测序数据的技术性偏差校正，处理的是样本间比较问题；crispresso-editing 面向单个/单批样本的编辑结果定量本身，二者服务不同的分析阶段 |
| CRISPResso2 官方网页版（crispresso.pinellolab.partners.org，非 agent skill） | 提供网页表单形式的单样本 CRISPResso 分析入口 | 网页版仅支持单扩增子单样本上传分析，且需人工在表单中逐项填写参数；crispresso-editing 把五种运行模式、参数选择逻辑与结果判读整合进对话式流程，可直接处理批量/混池样本并自动生成排查建议 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。
10. 安装使用方式
- Claude Code：
git clone https://github.com/GPTomics/bioSkills && cd bioSkills && ./install-claude.sh，安装后按提示选择性安装crispr-screens类目 - Codex：同仓库运行
./install-codex.sh - OpenClaw：同仓库运行
./install-openclaw.sh，或通过 ClawHub 市场搜索安装 - 通用方式：手动将
crispr-screens/crispresso-editing/目录复制到对应 Agent 的 skills 目录 - 第三方市场：
npx mdskill add GPTomics/bioSkills/bio-crispr-screens-crispresso-editing - 安装后无需重启，在对话中直接描述编辑定量需求（如“分析我的碱基编辑扩增子测序结果”）即可触发
- 使用前需自行安装 CRISPResso2 主工具（
conda install -c bioconda crispresso2，未发布到 PyPI）
11. 注意事项
- CRISPResso2 主工具需通过 conda（bioconda 频道）安装，无 PyPI 发行版，纯 pip 环境需额外配置 conda
- 定量窗口参数（大小与中心位置）设置不当会直接导致编辑效率被低估或高估，技能虽给出默认惯例值，仍需结合具体编辑化学体系核对
- 混池扩增子模式（CRISPRessoPooled）在扩增子间存在共享引物区时会出现读数错配，需按 SKILL.md 建议设计具备区分区段的引物
- 该技能只覆盖编辑结果定量，不含实验前的 guide 设计（见同仓库 library-design）与筛选层面的统计检验（见同仓库 hit-calling）