前言¶
抗体亲和力成熟、低 pH 敏感性改造等任务里，Agent 或脚本常会给出「某位置某氨基酸突变为某氨基酸」的列表。若 CDR 边界按教科书近似值硬编码、0-based 与 1-based 混用，又不在输出前回读序列核对，推荐里的「原氨基酸」可能与真实序列完全对不上，实验会直接浪费在无效突变上。
下面介绍 SkillHub 上的社区 Skill「抗体突变推荐校验器」。它不把重点放在再跑一遍打分模型，而是把 H-GAMMA-1 改造复盘里的方法论写进 SKILL.md，约束 Agent：先正确定位 CDR、统一编号体系，再对每条推荐做反向校验，未通过则不得当作最终结果提交。
这是什么¶
「抗体突变推荐校验器」是面向 Agent 的专业类 Skill，坐标为 @user_c314edaf/antibody-mutation-validation，当前 SkillHub 版本为 1.0.0，来源为 community，发布者为 user_c314edaf（SkillHub 页面标注作者为 WangLab）。标签 requires_api_key=false，安装后无需额外 API Key。
Skill 内文档版本记为 v1.0（创建日期 2026-05-07），核心命题是：突变推荐错误往往来自流程缺陷（CDR 边界、索引、缺少校验），而非单次模型能力不足；因此用 SOP、清单和可复用的校验逻辑，让 Agent 在生成推荐后必须回读序列验证。
核心功能¶
以下内容均来自该 Skill 的 SKILL.md，是其明确写明的能力边界。
真实错误复盘与根因归纳¶
文档以 H-GAMMA-1 低 pH 敏感性改造为例：三条核心推荐均因「声称的原氨基酸」与序列该位点实际氨基酸不一致而无效，并归纳根因为 CDR 边界硬编码、0-based/1-based 混用、缺少反向校验。
三大易错陷阱与对应做法¶
- CDR 边界硬编码：反对用固定区间近似 CDR；推荐 IMGT 编号（如 ANARCI）、Kabat（AbRSA / IgBLAST），或在无工具时用保守锚点模体推算边界。
- 索引混用：建议用统一的位置管理（文档示例为全程 1-based 语义，内部再转 0-based 读序列）。
- 缺少反向校验：要求「生成推荐 + 回读校验通过」才算完成；提供
validate_mutations逻辑：边界检查、原氨基酸一致性、无意义突变（已是目标氨基酸）、对 Cys/Pro/Gly 等位点的警告，失败时抛出错误阻止输出。
标准操作程序（SOP）与输出前清单¶
七步流程覆盖：输入序列并记录来源 → CDR 精确定位 → 筛选候选位点（CDR 优先、排除结构关键残基、统一编号）→ 生成推荐 → 必经反向校验 → 未通过则回到筛选修正 → 输出带确认与可复现参数的报告。另附七项勾选清单（CDR 非硬编码、编号统一、已执行校验等）。
理念扩展¶
同一套「反向校验 + 编号统一 + 边界验证」思路，文档还对照基因变异注释、基因组 build、UniProt 与 PDB 编号等场景的坐标映射风险；Skill 本身仍是抗体突变分析导向，不替代专用生物信息流水线。
安装与启用¶
先确认本机已安装 SkillHub CLI（未安装时可按官方安装文档执行 curl 安装脚本）。安装 Skill 时 必须 使用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能无法加载。
SkillHub 检索得到的安装命令如下（namespace 为发布者 ID）：
skillhub install antibody-mutation-validation --namespace user_c314edaf --dir <skills 目录>
常见客户端 skills 目录（与 SkillHub 安装文档 一致）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可按 SkillHub 技能页提示，让 Agent 阅读 https://skillhub.cn/install/skillhub.md 后安装 @user_c314edaf/antibody-mutation-validation。安装或更新后，按你所用客户端要求重启或刷新 Agent，使 SKILL.md 进入上下文。
本 Skill 仅包含 SKILL.md 指令与示例代码，不捆绑 ANARCI 等第三方可执行环境；若采用文档中的 IMGT/Kabat 方案，需在运行环境中自行安装相应工具（如 pip install anarci）。
典型用法¶
启用后，在对话中提供完整重链/轻链氨基酸序列（并说明编号习惯），以及 Agent 或外部工具生成的突变列表（每条含名称、1-based 位置、声称的原氨基酸）。Agent 应按 Skill 中的 SOP 先做 CDR 定位与编号统一，再在输出前执行与下面等价的校验（摘自 Skill 文档结构，序列需替换为你的真实数据）：
HC = "EVQLVESGGGLVQPGGSLRLSCAASGFTFSDSWIHWVRQAPGKGLEWVA..." # 你的重链序列
mutations = [
{"name": "F35H", "position": 35, "claimed_original": "F"},
{"name": "D26H", "position": 26, "claimed_original": "D"},
]
validate_mutations(HC, mutations) # 定义见 Skill 的 SKILL.md；失败应拦截输出
文档中的错误示例表明：当位置 35 实际已是 His、26 位实际为 Gly 时，校验会报 AA 不匹配或无意义突变，并打印位点上下文，避免把错误推荐写入实验计划。校验全部通过后，再整理最终报告，并附上「每位点实际氨基酸已确认」等说明。
适用场景与注意¶
适合谁：做抗体序列改造、需要 Agent 协助整理突变方案，且希望把「回读序列」固化为强制步骤的研发人员；与侧重 FoldX/Rosetta 全流水线评分的 Skill 互补，本 Skill 解决的是位点与氨基酸是否对得上。
限制与注意：
- SkillHub 元数据：评分 100000，下载 865（统计以 SkillHub 页面为准，会随时间变化）。
- 校验逻辑依赖你提供的序列字符串与突变表字段完整、编号体系统一；序列版本错误或链搞混，校验无法自动发现来源问题。
- CDR 精确定位仍建议配合 ANARCI 等工具；Skill 提供的是流程与校验模板，不保证替代实验验证。
- 若
skillhub install时未带--namespace user_c314edaf或 slug 不完整，可能无法解析到该社区包，应使用上文完整坐标安装。
结尾¶
「抗体突变推荐校验器」把一次生产环境突变推荐失误复盘成 Agent 可执行的 SOP：先摆正 CDR 与编号，再在输出前用反向校验拦住 AA 对不上的推荐。需要查看元数据或安装入口时，可打开 SkillHub 技能页：https://www.skillhub.cn/skills/user_c314edaf/antibody-mutation-validation ，API 坐标页：https://api.skillhub.cn/user_c314edaf/antibody-mutation-validation 。
