前言¶

抗体设计往往要在「模型能力」和「可执行流水线」之间来回切换：本地调参、上传数据、在云上排队跑 WDL，每一步都可能卡在鉴权、项目环境或输入模板不一致上。腾讯健康组学平台把 IgGM 封装为公共 WDL 应用 IgGM-WDL；若在 Cursor、Claude Code 等 Agent 里直接口述命令，很容易越权调用其他应用或漏掉同名检查。

下面介绍 SkillHub 上的 @tencent-adm/iggm-wdl-skill（腾讯 IgGM 抗体设计生成式基础模型）。它是 omics-task-skill 的单应用收窄版：只负责通过 omics-platform-cli 导入并运行 IgGM-WDL，命令统一经 Skill 包内的 scripts/omics_cli.py 拼接，并内置登录、配置、配额与二次确认流程。

这是什么¶

一句话定位：腾讯健康组学平台（Omics）上，专为公共应用 IgGM-WDL 服务的运行助手 Skill，而不是通用组学任务编排 Skill。

出品与维护：发布者为腾讯健康组学平台；Skill 坐标 @tencent-adm/iggm-wdl-skill，当前 SkillHub 版本 1.0.5，来源 enterprise，分类 professional。页面标注 requires_api_key=false，安装 Skill 本身不需要额外 API Key；实际跑任务仍依赖组学平台账号与 omics CLI 登录。

背后的模型：IgGM 由 TencentAI4S 研发，是抗体/纳米抗体生成式基础大模型（ICLR 2025），针对给定抗原同时生成抗体序列与结构。本 Skill 不替代模型训练，而是把已在平台发布的 WDL 公共应用跑通。

核心功能¶

经 Skill 包内 SKILL.md 与引用文档核对，能力边界如下。

1. 应用锁定：仅允许运行公共应用 IgGM-WDL，AppId 固定为 a9c8cb12-0a16-43f0-ab07-96ec5b41cc71，应用类型 WDL。不得替换为其他 AppId，也不得用本地 WDL（form A）或项目已有应用 ID（form C）绕过。
2. 允许的 CLI 能力子集：version / login / whoami；config show|set|clear；list region|project|env|cos-bucket；list apps --type WDL（导入前同名检查）；run --public-app <上述 AppId>；status / debug。未在白名单内的命令不得调用。
3. 标准运行前流程：鉴权与配置检查（含 C 端体验用户配额首检与每次 run 前复检）、WDL 同名应用检查循环、展示完整 omics run 命令后等待用户明确确认才执行。
4. 输入与存储：未传 --input 时，CLI 使用该应用第一个 InputTemplate 作为基线；可用 --input 覆盖字段。本地文件作参数时需先 cos upload 到用户绑定的 COS，再用返回的 COS URL 填入运行参数。
5. 运行后：status 查询任务；异步失败可按文档做 debug 三段式；若输入含 outdir，任务结束后需提醒用户到对应目录查看结果。

若要运行其他公共应用、本地 WDL、COS 上的 NF，或项目内已有应用，应改用 omics-task-skill，本 Skill 会拒绝越界请求并给出该引导。

安装与启用¶

安装 SkillHub CLI¶

若尚未安装，可先检查版本；未安装时按 SkillHub 官方安装文档执行（完整安装含 CLI 与默认 Skill）：

command -v skillhub && skillhub --version

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时可在同一脚本后加 --cli-only 参数。

安装本 Skill¶

官方页面要求参照 SkillHub 安装说明，安装坐标 @tencent-adm/iggm-wdl-skill。命令行示例：

skillhub install iggm-wdl-skill --namespace tencent-adm --dir <当前 Agent 的 skills 目录>

安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认装到 ./skills/ 可能无法被加载。常用路径包括：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，在对话中使用与 IgGM-WDL、蛋白质与抗体设计、跑 IgGM-WDL 等相关的表述即可触发；Skill 元数据中的 triggers 包含 IgGM-WDL、iggm-wdl、蛋白质与抗体设计、跑 IgGM-WDL、run iggm-wdl 等。

组学 CLI 前置条件¶

执行业务前，Skill 会按 references/omics-cli-setup.md 检查 omics（omics-platform-cli）是否已安装、是否已 login，以及 region、项目、环境、COS 桶等配置是否完整。B 端与 C 端体验用户在配置引导上的分支不同；C 端还会强制执行配额检查。

典型用法¶

以下步骤对应 Skill 文档中的标准链路（场景 A），命令通过 Skill 目录下的包装脚本调用，路径以已安装 Skill 为准。

1. 检查登录与配置

python3 scripts/omics_cli.py whoami
python3 scripts/omics_cli.py config show -o json

退出码 2 表示未登录，需走 omics login 浏览器授权；配置字段缺失则按引导完成 config set。

2. 导入前同名检查（必做）

python3 scripts/omics_cli.py list apps --type WDL -o json

若项目中已有与待导入名（默认 IgGM-WDL 或用户指定的 --public-app-name）同名的应用，需引导用户改名后重新检查，通过后才能继续。

3. 二次确认后运行公共应用

WDL 类型不传 --nf-version。示意命令（AppId 固定，不可改）：

omics run --public-app a9c8cb12-0a16-43f0-ab07-96ec5b41cc71 \
          --public-app-name <importedName> \
          --app-type WDL \
          [--input <path>] \
          [--name <runName>] \
          -o json

用户确认「确认 / 继续 / y」后，C 端用户还会在提交前再次执行配额检查；通过后 Skill 才实际执行 run。

4. 查询状态

python3 scripts/omics_cli.py status -o json
python3 scripts/omics_cli.py status rg-xxx -o json

本地文件入参示例：若需使用本机生成的 FASTA 等文件，先上传 COS：

python3 scripts/omics_cli.py cos upload \
  --file /tmp/generated_protein.fasta \
  --cos-path uploads/protein_sequence.fasta \
  -o json

将返回的 CosUrl 写入 --input 指向的 JSON，再进入 run 流程。

适用场景与注意¶

适合谁

• 已在或计划使用腾讯健康组学平台，希望用 Agent 对话完成 IgGM-WDL 的导入、参数确认与提交。
• 需要固定白名单、强制二次确认与同名检查，避免误跑其他应用或重复导入同名 WDL 的团队。

限制与注意

• 能力严格等于「omics-platform-cli 七类命令」与「仅 form B 运行本公共应用」的交集；不能代替通用 omics-task-skill。
• Skill 内嵌的 SKILL.md frontmatter 版本号为 1.0.0，SkillHub 发布版本为 1.0.5，以商店与 _meta.json 为准。
• 体验版用户受 RemainDays、TodayRemainingRuns 约束，到期或当日次数用尽会阻断运行；正式版 B 端用户走完整项目/环境/桶选择流程。
• 模型侧能力以平台应用简介为准：针对给定抗原生成抗体序列与结构；具体输入字段以公共应用 InputTemplate 为准，勿自行臆造参数名。

结尾¶

@tencent-adm/iggm-wdl-skill 把 IgGM 公共 WDL 应用的鉴权、配置、配额、同名检查与 omics run 固定 AppId 串成可复现的 Agent 流程，适合在组学平台上专注跑通 IgGM-WDL 的场景。官方入口：SkillHub 页面、API 坐标页。