菜单
执行 VASP 电子结构工作流：静态 SCF、带结构、DOS，以及高精度 HSE 带隙。它是在原 bandgap skill 基础上的升级版，统一收纳 PBE→HSE 带隙、band structure、DOS 等电子结构任务。真正运行前必须经过 run-vasp；涉及 GPU、KPAR、NCORE、NPAR 时必须先经过 incar-performance。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/Phoinikas03/VASP_Agent --skill workflow-electronic-structure命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Build or revise VASP INCAR files by composing a workflow base profile with optional INCAR modifier skills. Use when preparing INCAR for relax, static SCF, EOS, adsorption, phonon, NEB, AIMD, response, or GW/BSE workflows, especially when several physical models must be combined without tag conflicts.
Apply VASP INCAR settings for DFT+U, exchange-correlation functional choices, vdW corrections, meta-GGA, and hybrid functional consistency. Use when a workflow needs LDAU tags, U values from literature, IVDW, METAGGA, LHFCALC/HSE, or needs to avoid incompatible functional settings.
Apply VASP INCAR settings for collinear magnetism, initial MAGMOM choices, antiferromagnetic configurations, noncollinear magnetism, spin-orbit coupling, and magnetic anisotropy. Use when materials contain magnetic elements, the user requests spin/SOC, or a workflow needs magnetic consistency across stages.
正在显示 SKILL.md
| name | workflow-electronic-structure |
| description | 执行 VASP 电子结构工作流：静态 SCF、带结构、DOS，以及高精度 HSE 带隙。它是在原 bandgap skill 基础上的升级版，统一收纳 PBE→HSE 带隙、band structure、DOS 等电子结构任务。真正运行前必须经过 run-vasp；涉及 GPU、KPAR、NCORE、NPAR 时必须先经过 incar-performance。 |
这个 skill 统一处理以下任务：
它是对旧 bandgap workflow 的扩展，而不是完全替代运行规则。原来关于 PBE -> HSE、WAVECAR 连续性、HSE 启动前单独确认、GPU 卡数确认等要求，仍然保留。
workflow-electronic-structure/
├── SKILL.md
├── scripts/
│ └── gap.py
├── references/
│ ├── hse_params.md
│ └── troubleshooting.md
└── templates/
├── INCAR_pbe_scf
└── INCAR_hse
run-vasp：正式运行入口，必须使用incar-performance：只要用户提到 GPU、KPAR、NCORE、NPAR 或希望按硬件优化时，必须先用workflow-convergence：正式电子结构对比前建议先做 ENCUT/KSPACING 收敛workflow-relax：若结构还未优化，优先先松弛vasp-error-recovery：出错、卡住、超时时的诊断与恢复提交任何 PBE -> HSE 带隙任务前，必须显式检查 PBE INCAR：
LWAVE = .TRUE.
LCHARG = .TRUE.
若看到 PBE 被写成 LWAVE = .FALSE. 或 LCHARG = .FALSE.，这是需要立即修正的输入错误，不能提交 PBE，也不能继续拿这个 PBE 结果启动 HSE。
电子结构、band structure、DOS、PBE/HSE 带隙任务的 POTCAR 必须由 MCP setup_vasp_inputs 生成，且必须使用 pymatgen / Materials Project 推荐赝势。不得为了降低计算量改用最少价电子的裸标准赝势。
执行要求：
setup_vasp_inputs 生成 POTCAR 和该工作目录中的 POSCAR 副本；不得手动拼接、复制、编辑或复用旧 POTCAR。Ga, Ge, In, Sn, Tl, Pb 等需要低位 d 态入价的 p 元素，必须保留推荐 _d 赝势；当前 benchmark 中尤其要确认 Ga_d, In_d, Sn_d, Pb_d。setup_vasp_inputs 返回的 (Used POTCARs: ...) 必须写入或汇报到任务记录中。若体系含 Ga/In/Sn/Pb，返回值中没有对应 _d，必须停止并修正输入，不能继续提交 VASP。POTCAR、同一结构和一致的 ENCUT/KSPACING 口径，除非用户明确要求做单变量对照。runs/bg_* 目录中的输入文件作为新计算起点；旧目录可能来自旧赝势逻辑或被后续文件覆盖。需要重算时，从 data/bandgap/<material>、reference 结构或用户指定结构重新生成输入。PBE SCF 作为 HSE 的前置计算时，必须为 HSE 热启动保留波函数和电荷密度：
LWAVE = .TRUE.
LCHARG = .TRUE.
执行要求：
INCAR 时，不得设置 LWAVE = .FALSE. 或 LCHARG = .FALSE.；若模板或模型生成了这两个值，必须在提交 PBE 前改为 .TRUE.。WAVECAR 和 CHGCAR。缺失时不能用该 PBE 结果继续 HSE，必须先重跑 PBE 或明确改为冷启动并说明代价。WAVECAR/CHGCAR 热启动，并保持同一 POTCAR、同一结构、同一 ENCUT/KSPACING 口径。适用于：
步骤：
workflow-convergencetemplates/INCAR_pbe_scfrun-vasp 的 vasp_runner.py 提交run-vasp/scripts/check_convergence.py 检查vasp-error-recovery典型两步法：
CHGCAR / WAVECAR要求：
LORBITvasp-error-recovery 判断是否是输入问题、收敛问题，还是仅后处理不完整严格采用：
run-vasp 提交 HSEscripts/gap.py 提取带隙无论是静态 SCF、band structure、DOS，还是 HSE，只要出现以下任一情况，都应先转给 vasp-error-recovery：
vasp_runner.py 非零退出run-vasp/scripts/check_convergence.py 返回 failed / unconverged / incomplete_postprocessOUTCAR、OSZICAR 长时间没有新输出处理顺序应为：
Read references/troubleshooting.mdvasp-error-recovery推荐调用：
cd "<repo_root>" && python .claude/skills/vasp-error-recovery/scripts/analyze_error.py --work-dir "<当前任务目录>"
根据 vasp-error-recovery 的输出来决定：
NELM / ALGO / ISMEAR / SIGMA / HSE 参数若 vasp-error-recovery 建议先停旧 run，必须先向用户说明证据、拟修改项和新的 runner 命令。只有在用户明确同意后，才允许：
cd "<repo_root>" && python .claude/skills/run-vasp/scripts/terminate.py --work-dir "<当前任务目录>" --reason "<停止原因>"
禁止在旧 run 可能仍活着时，向同一目录补开第二个活跃的 PBE / HSE / DOS / band structure 任务。
HSE 启动前必须单独确认 在 PBE 已收敛、HSE 输入文件已准备好之后，必须单独停下来询问用户是否继续。
有 GPU 时必须问清卡数 用户只说“继续”但没说 GPU 张数时，不能默认 1 卡或多卡。
WAVECAR 连续性
HSE 热启动要求前后阶段 ENCUT 和 K 点口径一致；若不一致，不能继续拿旧 WAVECAR 硬续。
出错先诊断再决定是否停
若 HSE 因 GPU/MPI/内存问题异常，优先用 vasp-error-recovery 看是否应先 terminate，再修改参数并重新提交。
带隙提取：
cd "<repo_root>" && python .claude/skills/workflow-electronic-structure/scripts/gap.py "<vasprun.xml>"
mpirun ... vasp_std/vasp_gpuincar-performancevasp-error-recovery，直接对失败或疑似卡住的旧 run 做模糊终止或盲目重跑至少包括：