1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | base-editing-analysis-gptomics-bioskills |
| 项目自述名称 | bioSkills（合集整体名称；本技能内部标识为 bio-crispr-screens-base-editing-analysis） |
| 作者/维护者 | GPTomics（GitHub Organization） |
| 来源链接 | https://github.com/GPTomics/bioSkills/tree/main/crispr-screens/base-editing-analysis |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars | 1,121（合集仓库整体数字，不代表本技能自身热度） |
| Forks | 193（合集仓库整体） |
| 最新版本 | v3.0（2026-02-14 发布 tag；仓库此后持续有提交，未再打新 tag） |
| 安装方式 | git clone 后运行仓库自带安装脚本，支持按类目选择安装 |
以上数据来自 GitHub API 与仓库文档，均已交叉验证。
2. 功能介绍与亮点
base-editing-analysis 聚焦碱基编辑器（Base Editor）变异功能筛选这一细分场景，覆盖从文库设计到命中判定的全链路：
- 编辑器化学选型表：BE3/BE4max/eA3A-BE3（胞嘧啶编辑器）与 ABE7.10/ABE8.20/ABE8e（腺嘌呤编辑器）九种编辑器的编辑窗口位置、旁观编辑（bystander）率、副产物插入缺失（indel）率逐一列出，并给出选型决策规则
- 编辑窗口数学：解释编辑窗口为何固定在 PAM 远端第 4–8 位（ABE7.10 为 4–7 位）的分子机制，并给出可直接运行的 sgRNA 筛选脚本，按目标氨基酸自动定位落入编辑窗口且旁观碱基最少的候选间隔序列
- 旁观编辑归因策略：当同一 sgRNA 编辑窗口内同时命中目标碱基与旁观碱基时，提供四种归因策略（多 sgRNA 平铺对照、正交 Prime Editor 验证、等位基因频率表拆分、零旁观文库限制），并附拆分脚本
- 编辑效率前置过滤：命中判定前先按靶碱基转化率过滤低效 sgRNA（30% 初筛/50% 验证阈值），避免未编辑读段稀释信号
- 两篇标杆文献方法论：Hanna 2021（Cell）68,526 条 sgRNA 规模的 BRCA1/2 ClinVar 变异功能筛选与 Cuella-Martin 2021（Cell）86 个 DDR 基因饱和突变筛选，逐步还原其筛选设计与命中判定流程
- 失效模式清单：五类常见故障（Cas9 污染导致的插入缺失、旁观编辑主导表型、静默变异无信号、细胞系编辑活性不足、文库无法覆盖目标密码子）各附触发条件、机制解释与排查步骤
正文另附版本兼容性说明（CRISPResso2、BE-Hive、pandas/biopython/numpy/scipy/scikit-learn 各自最低可用版本）与一份九项定量阈值对照表。
3. 适用场景
所属分类：数据分析与可视化——该技能的核心产出是对碱基编辑筛选实验数据的定量分析与统计判定逻辑（编辑效率量化、旁观编辑拆分、命中打分），属于面向具体实验数据的分析工具，而非工作流编排或第三方系统集成。
适用人群与场景：
- 计划开展 CBE 或 ABE 碱基编辑变异功能筛选、需要在九种编辑器化学之间按目标变异类型（C→T / A→G / 颠换）选型的研究人员
- 需要设计平铺式 sgRNA 文库、让目标碱基落入编辑窗口且旁观碱基最少的文库设计场景
- 已完成扩增子测序、需要按编辑效率阈值过滤 sgRNA 并判断旁观编辑是否混淆了命中结果的分析场景
- 复现或参照 Hanna 2021 BRCA1/2、Cuella-Martin 2021 DDR 基因饱和突变这两项标杆研究方法论的场景
- 遇到编辑效率异常（插入缺失比例过高、全库编辑率偏低）需要诊断根因（载体错误、细胞系不适配）的排查场景
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. 推荐理由
碱基编辑筛选最容易被误判的地方不是跑通 CRISPResso2，而是两处系统性陷阱：选错了编辑器化学（比如目标变异明明该用 ABE 却套用了 CBE 的窗口规则），或者把“旁观编辑主导的表型”误判为“目标变异的功能效应”。base-editing-analysis 把九种编辑器的窗口/旁观率/indel 率整理成选型表，把旁观归因整理成四种可执行策略并附代码，且用两篇发表在 Cell 的标杆研究还原了完整的筛选设计到命中判定流程——把这层容易踩坑的判断逻辑前置到分析开始之前，而不是等结果出来后才发现变异归因站不住脚。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 合集仓库整体 1,121 星，该数字属整个合集，不代表本技能自身热度；本技能自身有独立第三方渠道证据：Hermes 官方网关按“CRISPR & Genome Engineering”专属类目具名收录；本技能路径维护活跃（6 次提交，最近一次 2026-07-25，与合集仓库整体最新一次推送同日） |
| 可用性 | 8 | 文档详尽，含编辑器选型表、可运行的 sgRNA 筛选与旁观拆分脚本、九项定量阈值表与失效模式排查指南；但完整使用需按需安装 CRISPResso2（conda）、BE-Hive（GitHub 源码克隆非 PyPI 包）、Broad be-validation-pipeline（GitHub 源码 + pip 依赖）等多个第三方工具，需要一定环境配置，故未达“一条命令即用”档 |
| 安全性 | 9 | 内容为参考文档与示例脚本，不自动执行任何命令；不联网外发数据；不要求 API key 或凭据；License 明确（MIT）；未发现可疑指令或混淆代码 |
| 综合 | 8.0 | 三项均值 |
安全检查清单： ① 技能本身不执行 shell 命令——正文给出的是供使用者按需运行的标准生信工具安装命令（conda/pip/git clone/docker），来源均为公开官方渠道（Broad Institute、GitHub 已知作者仓库），范围明确 ② 无联网外发 ③ 不涉及 API key/凭据 ④ 未见可疑指令或 prompt injection 迹象 ⑤ 作者为具备连续维护记录的开源研究实验室，无造假迹象 ⑥ License 明确（MIT）⑦ 本技能路径最近一次提交为 2026-07-25，维护活跃
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 base-editing-analysis 的差异 |
|---|---|---|
GPTomics/bioSkills 同仓库 crispresso-editing |
CRISPResso2 通用命令行用法与等位基因表解读，覆盖 BE/PE/标准 Cas9 各种编辑模式 | 是底层量化工具本身的操作手册，不涉及编辑器化学选型或旁观编辑的变异归因判断 |
GPTomics/bioSkills 同仓库 prime-editing-screens |
Prime Editor 筛选设计与分析，零旁观编辑的正交验证手段 | 服务于不产生旁观编辑的另一种编辑技术，二者常被联合用于交叉验证，而非互相替代 |
GPTomics/bioSkills 同仓库 library-design |
通用 CRISPR 筛选文库设计（sgRNA 覆盖度、脱靶评估等） | 覆盖标准 CRISPR 敲除/干扰文库设计，不含碱基编辑特有的编辑窗口定位与旁观预测逻辑 |
base-editing-analysis 的差异化在于它是仓库内唯一系统整理“编辑器化学选型 + 编辑窗口定位 + 旁观编辑归因”这一碱基编辑特有判断链条的技能，而同仓库其余相关技能各自只覆盖通用量化工具操作或另一种编辑技术本身。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。所属仓库已被 GoekeLab/awesome-genomic-skills（第三方维护的基因组学 agent 技能精选列表）收录，该列表将 CRISPR 筛选分析列为 bioSkills 覆盖的技术领域之一。
9. 其他补充
仓库同时提供多语言 agent 支持（涵盖 Claude Code、Codex、Antigravity CLI、OpenCode、OpenClaw 等安装路径）。技能正文标注了各依赖工具（CRISPResso2、BE-Hive、pandas 等）的最低可用版本，并给出版本不匹配时的排查建议（检查已安装版本、按实际 API 调整示例代码）。
10. 安装使用方式
git clone git@github.com:GPTomics/bioSkills.git
cd bioSkills
./install-claude.sh --categories "crispr-screens" # 仅安装 CRISPR 筛选分析相关技能
# 或安装全部技能：
./install-claude.sh安装后无需重启，Claude Code 会在下次读取 skills 目录时自动识别；技能通过对话中提及“碱基编辑文库设计”“CBE 还是 ABE”“旁观编辑归因”“编辑效率过滤”等意图触发。Codex 使用 ./install-codex.sh，OpenClaw 使用 ./install-openclaw.sh，用法一致。
11. 注意事项
- 技能本身只提供选型逻辑与命令模板，实际运行仍需使用者自行安装 CRISPResso2（conda 渠道）、BE-Hive（需从 GitHub 源码
maxwshen/be_predict_bystander克隆，非 PyPI 包）、Broad be-validation-pipeline（GitHub 源码 + pip 依赖）等第三方工具 - 编辑窗口位置因编辑器而异（BE3/BE4 为第 4–8 位，ABE7.10 为第 4–7 位），跨编辑器套用会导致 sgRNA 设计错误，正文已标注但仍需使用者按实际选用的编辑器核对
- 旁观编辑归因的多 sgRNA 平铺策略依赖文库本身含有足够多样的旁观模式组合，若文库设计阶段未预留这一多样性，下游无法补救