scholaraio: Skill for Claude Code

GROMACS 分子动力学

用 GROMACS 做分子动力学模拟：从体系搭建、平衡、产出 MD 到轨迹分析和结合自由能评估。

本 skill 故意保持轻量：

• 它负责告诉 agent 什么时候该用 GROMACS、标准工作流是什么、哪些科学规范不能踩
• 它不充当完整命令手册
• 具体命令行选项、.mdp 参数、子命令语法统一去查 scholaraio toolref

Agent 默认协议（toolref-first）

对 GROMACS 问题，agent 默认按这个顺序工作：

1. 先判断问题属于哪一层：gmx 子命令、.mdp 参数、分析工具、力场/拓扑流程
2. 写 .mdp 前先查 thermostat、barostat、constraints、cutoff、输出频率这类高风险参数
3. 对用户自然语言说法，先 search 再 show
4. 如果 toolref 已经能回答，就不要在 skill 中重复堆参数表
5. 如果 toolref 缺页或命中不理想，agent 应先完成任务，并明确这是 toolref 覆盖缺口，而不是用户需要自己手动适配

这意味着：

• 普通用户不需要自己打磨 GROMACS 参数映射
• agent 应优先自己把 Parrinello-Rahman、v-rescale thermostat、constraints h-bonds 等问法映射到参数页
• skill 负责路线和规范，toolref 负责参数与接口

前置条件

# 安装
conda install -c conda-forge gromacs
# 配体参数化
conda install -c conda-forge acpype ambertools
# 结合自由能
pip install gmx-MMPBSA
# 可视化（可选）
conda install -c conda-forge pymol-open-source

验证：gmx --version 应显示版本号和 GPU 支持信息。

何时使用

适合：

• 蛋白-配体结合、蛋白构象变化、膜蛋白、溶液中生物大分子
• 需要标准 MD 流程、轨迹分析、MM/PBSA 估算

不适合：

• 需要量子化学精度时，转 DFT / QM/MM
• 配体参数化来源不明、力场体系不一致时，不要直接推进

Toolref 优先

当 agent 不确定子命令、选项、.mdp 参数含义时，先查 toolref。

常用查法：

scholaraio toolref search gromacs "temperature coupling"
scholaraio toolref show gromacs mdp integrator
scholaraio toolref show gromacs mdp pcoupl
scholaraio toolref show gromacs mdp tau-t
scholaraio toolref show gromacs mdp ref-t

推荐习惯：

• 写 .mdp 前，先逐项查核心参数
• 不靠记忆拼写 thermostat/barostat 选项
• 对“这项参数在当前版本是否还推荐”这类问题，优先相信 toolref 而不是旧教程

如果遇到覆盖缺口：

• 先继续使用 GROMACS 官方文档完成任务
• 在输出中点明这里超出了当前 toolref 覆盖
• 不要把补齐 toolref 当成普通用户的前置工作

核心流程

知识库协作模式

这是本 skill 与普通 GROMACS 教程的核心区别。在任何模拟开始前：

1. 用 scholaraio usearch "<体系关键词>" 检索知识库中的相关论文
2. 从论文中提取：力场选择依据、模拟参数（温度、压力、时长）、验证基准数据
3. 在 .mdp 文件注释中标注参数来源（如 "# 300 K, per Homeyer et al. 2014 JCTC"）
4. 模拟完成后，将结果与论文数据定量对比

建议工作流：

1. 读论文，确定力场、温压条件、盐浓度、模拟时长和验证指标
2. 准备蛋白/配体结构与拓扑
3. 构建溶剂盒并加离子
4. 能量最小化
5. NVT / NPT 平衡
6. 产出 MD
7. 轨迹分析
8. 必要时做 MM/PBSA，并和文献/实验对比

典型输出：

• RMSD / RMSF / 氢键 / 回旋半径
• 关键构象快照或轨迹动画
• 结合自由能及误差条
• 对应文献基准的对比图