前言¶
抗體親和力成熟、低 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 。
