工程计算脚本审查
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ddcb4786/engineering-script-audit。
技能介绍
解决什么问题
工程计算脚本的问题常不在语法,而在公式抄录错误、适用条件漏判、数值求解不稳、非法输入导致崩溃。这个技能面向水利、土木、水力学等工程计算脚本,处理公式审查、规范校验、计算结果异常排查和数值代码 Debug,尤其是 SL、GB、DL 等规范下的公式一致性检查。
技能如何工作
它按工程审查思路分阶段推进:
- 公式对照规范验证:先提取核心公式,标注代码位置、变量含义和公式来源;优先使用用户提供的规范原文或可检索条文,项目内
formula_reference.md、计算书草稿等中间文档只能作为低置信度线索。最终结论区分PASS、WARN、FAIL,并标注置信度。 - 适用范围校验:检查
δ/H、P1/H、H0/Hd、Fr等参数是否落在规范有效范围内,查表是否发生不可靠外推,分类判别在边界附近是否连续。 - 数值稳健性检查:审查迭代求解器,优先用二分法在物理合理区间定位,再考虑牛顿法精化;同时检查初值、收敛准则、最大迭代、除零、负数开方和对数奇异。
- 防御守卫与结果校核:要求高风险运算返回带物理含义的清晰错误,而不是直接抛出
Python堆栈;再结合量纲、守恒、单调性和退化工况验证结果是否可信。
适用边界
该技能更适合对已有工程计算脚本做审查、复核和排错,不等同于自动出具完整设计书。若缺少规范原文,部分结论只能作为待确认项,不应直接当作最终缺陷。
使用场景
- 审查溢洪道堰流脚本中的挑距、流量系数公式是否按 SL253-2018 规范实现。
- 排查明渠临界水深迭代不收敛、牛顿法选错根等数值求解问题。
- 检查 P1/H 查表参数是否超出定义域,避免流量系数外推。
- 为负数开方、零除、对数奇异等运算添加防御守卫,避免非法输入崩溃。
适合人员
- 需要复核水利计算脚本是否符合 SL、GB 或 DL 规范的水利工程师。
- 正在排查水力学脚本迭代不收敛或结果异常的研发工程师。
- 需要审查查表公式适用范围和参数边界的水工设计人员。
- 负责给工程计算代码补防御性校验并输出审查结论的后端开发者。