메뉴
在 VASP 计算失败、未收敛、长时间无新输出、GPU/MPI 异常或需要判断是否应先停止当前 run 再修改参数重跑时触发。读取 run-vasp 的 state 文件、OUTCAR、OSZICAR、主日志与 check_convergence 结果，给出结构化排障建议，并在用户确认后才允许调用 terminate.py。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/Phoinikas03/VASP_Agent --skill vasp-error-recovery명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? 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 | vasp-error-recovery |
| description | 在 VASP 计算失败、未收敛、长时间无新输出、GPU/MPI 异常或需要判断是否应先停止当前 run 再修改参数重跑时触发。读取 run-vasp 的 state 文件、OUTCAR、OSZICAR、主日志与 check_convergence 结果，给出结构化排障建议，并在用户确认后才允许调用 terminate.py。 |
| version | 1.0.0 |
这个 skill 负责在 VASP 出错、疑似卡住或超时后，先做证据化诊断，再给出修改建议与是否应停止当前任务的判断。
它不是运行入口。真正启动/重跑 VASP 仍应交给 run-vasp。
出现下列任一情形时，应使用本 skill：
run-vasp/scripts/check_convergence.py 返回 failed、unconverged、incomplete_postprocessvasp_runner.py 返回非零退出码OUTCAR、OSZICAR 长时间没有新输出vasp-error-recovery/
├── SKILL.md
├── references/
│ └── troubleshooting.md
└── scripts/
└── analyze_error.py
先诊断，后动作
在真正停止进程或修改输入前，先读取 state、日志与 check_convergence 结果。
先用调用方的本地 troubleshooting，再用本 skill 做统一诊断
若上游 workflow 自己带有 references/troubleshooting.md 或等价本地规则，调用方应先阅读它，先消化该任务专属的排障建议；当仍需统一判断“是否应 terminate 当前 run、是否只是 stalled、如何组织重跑方案”时，再进入本 skill。
只处理有证据归属的任务
若当前任务没有 run-vasp 生成的 .vasp_run_state.json，或无法证明进程归属，不得擅自终止。
不自动重跑 本 skill 只输出建议，不在未得到用户确认的情况下自动停止或重提任务。
终止必须经用户确认 若建议停止当前任务，必须明确告诉用户：
vasp_runner.py 命令将是什么调用本 skill 之前，若上游 skill 有自己的本地排障文档，应先读取它：
relax/references/troubleshooting.mdworkflow-electronic-structure/references/troubleshooting.md然后再进入本 skill 做统一诊断。
优先读取：
.vasp_run_state.jsonOUTCAROSZICARlog_path）run-vasp/scripts/check_convergence.py 输出建议直接运行：
cd "<repo_root>" && python .claude/skills/vasp-error-recovery/scripts/analyze_error.py --work-dir "<task_dir>"
结合 references/troubleshooting.md，优先判断是否属于：
ZBRENTWAVECAR 不匹配POTCAR 顺序或用户指定赝势变体未同步的问题至少向用户说明：
只有在以下条件同时满足时，才允许调用：
cd "<repo_root>" && python .claude/skills/run-vasp/scripts/terminate.py --work-dir "<task_dir>" --reason "<reason>"
若这是旧的手写启动任务且没有 .vasp_run_state.json，必须先只做候选检查：
cd "<repo_root>" && python .claude/skills/run-vasp/scripts/terminate.py --work-dir "<task_dir>" --allow-cwd-scan --dry-run
只有当 dry-run 输出中的每个候选 PID 都显示 cwd 精确等于 <task_dir> 时，才允许在用户同意后去掉 --dry-run 执行。不要改用 pkill -f 或任何命令行模式匹配。
条件：
停止后，回到 run-vasp 流程：
POTCAR，必须调用 setup_vasp_inputs；若用户原先指定过赝势变体，必须在同一次工具调用中传入相同的 potcar_overrides JSON object（如 {"Cr": "Cr_pv"}），不得用 Bash/Python 手工生成、拼接或复制 POTCARvasp_runner.py 命令pkill、killall、pkill -f vasp_std、pkill -f "vasp_gpu.*<dir>" 之类模糊命令；pkill -f 可能误杀正在执行命令的 shell/消息读取进程mpirunsetup_vasp_inputs 手工修复 POTCAR；用户指定赝势变体时，错误恢复和重跑必须继续使用同一份 potcar_overrides