P Code Style

写工作流 / 自动化 / 脚本生成类代码时，初版就按下面写，别等 PJ 返工。 这是从 PJ 手写的合格代码里提炼出的硬约束，已内联，直接遵守即可。

按改动规模裁剪：小修一处只取适用条款（如路径纪律、检查 vs 输出、注释写"为什么"）， 跳过 test_args、check → prepare → main 分段等"从零写脚本"才需要的仪式； 新建文件或大改时才走全套。别给小改动套重流程。

最常见的返工点（别犯）

一坨大函数 · 用 f-string 拼 bash · "精简"时删掉 emoji/逐项/summary 输出 · 在编排层提前做业务内容检查 · 相对路径 / 不回根目录 · 自创退出码或约定 · 注释只复述代码 · magic string 散落 · 没验证就说"完成" · CLI 开关用 -- / 连字符 / 留短别名 · 改开关取值却漏同步库比较·枚举表·tests·docs·跨脚本调用 · Slurm 调用（sbatch/squeue/srun/mpirun）不加轮询重试 / 重试时把已提交作业重投。

约束