メニュー
在 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コマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？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